Skip to content

API Reference / Intents

List contract intents in a snapshot

Returns a paged list of intents produced by one contract evaluation snapshot, ordered by the requested sort field and direction with the intent id as a stable tiebreak. Each page carries hydrated entities, so no follow-up GetIntents is needed.

POST/contracts.v1.Contracts/ListIntents

Request body

application/jsonRequired

Request for one page of the intents produced by one contract snapshot.

contractIdstring

Contract to list intents from.

Format"byte" base64

cursor?string

Opaque pagination cursor from a previous ListIntentsResponse. Empty for the first page.

descending?boolean

Order descending instead of ascending. Start a new cursor when changing the field or direction.

limit?integer

Maximum number of intents to return. Server caps this at a service-defined upper bound.

Format"int32"

snapshotIdstring

Evaluation snapshot to list intents from.

Format"int64"

sortField?string

Field to order the page by, with the intent id as a stable tiebreak. Unspecified orders by creation time.

Value in"INTENT_SORT_FIELD_CREATED_AT""INTENT_SORT_FIELD_MAX_BUY_PRICE""INTENT_SORT_FIELD_MARKET_HASH_NAME""INTENT_SORT_FIELD_MIN_FLOAT"

Response body

application/json

Success

intents?array<Intent>

Full intents for this page. A page carries the hydrated entities, not bare ids, so the caller needs no follow-up GetIntents.

Show attributes
contractId?string

Contract that produced this intent.

Format"byte" base64

createdAt?string

When this version of the intent was created: the creation time of the snapshot that introduced it.

Format"date-time"

createdBy?string

Actor whose contract update triggered the evaluation that produced this intent. Unset for a background evaluation (a periodic re-evaluation sweep, or a SERVICE own-behalf actor).

Format"byte" base64

deletedAt?string

When the intent was soft-deleted, if it has been.

Format"date-time"

id?string

Opaque 16-byte identifier of this version of the intent, base64-encoded in JSON. An intent keeps the same identifier across every consecutive snapshot in which its price and float window are unchanged, and gets a new one when they change. Exists only for API addressability. The intent's business identity within a snapshot is (contract, snapshot, market_hash_name).

Format"byte" base64

marketHashName?string

The item this intent matched, for example "AK-47 | Redline (Field-Tested)".

maxBuyPriceCents?string

The price this intent will pay (a buying contract) or list at (a selling contract), computed by the contract's valuation.

Format"int64"

maxFloat?number

Predicate float window upper bound. 1.0 means no upper bound.

Format"double"

minFloat?number

Predicate float window lower bound. 0.0 means no lower bound.

Format"double"

referencePrices?array<ReferencePrice>

Per-reference price breakdown behind max_buy_price_cents, pinning each valuation reference's resolved source price at the snapshot that introduced this version of the intent. A later evaluation whose only change is the breakdown keeps the intent unchanged.

Show attributes
lastObservedAt?string

For a stale reference, when last_value_cents was observed. Set only when outcome is stale.

Format"date-time"

lastValueCents?string

For a stale reference, the last value the source reported before the reference's adjustment, in US cents. Set only when outcome is stale.

Format"int64"

metric?string

The metric read for a market data lookup. Absent for a sale computation.

observedAt?string

When the figure behind value_cents was observed: the market observation's own time for a market data lookup, or the newest sale in the window for a sale computation. Absent when value_cents is absent.

Format"date-time"

outcome?string

Whether the reference resolved a price, found only an observation older than its freshness window, or found no data at all.

Value in"REFERENCE_PRICE_OUTCOME_RESOLVED""REFERENCE_PRICE_OUTCOME_STALE""REFERENCE_PRICE_OUTCOME_MISSING"

priceCents?string

The price after the reference's adjustment, in US cents, which the valuation strategy combines. Absent when the source had no usable data.

Format"int64"

referenceIndex?integer

Zero-based position of the reference in the valuation's references.

Format"int32"

source?string

The reference's market source, such as "market-csgo".

valueCents?string

The price the source gave before the reference's adjustment, in US cents. Absent when the source had no usable data.

Format"int64"

snapshotId?string

Evaluation snapshot this intent was read in: the snapshot the request named. A GetIntents call with no snapshot reports the snapshot that introduced this version of the intent.

Format"int64"

updatedAt?string

When the intent was last modified.

Format"date-time"

updatedBy?string

Same actor as created_by. An intent is insert-only, so the two are always stamped identically.

Format"byte" base64

nextCursor?string

Cursor to pass to fetch the next page. Empty when there are no more results.

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListIntents" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "snapshotId": "7",
    "limit": 100,
    "cursor": ""
  }'
{
  "intents": [
    {
      "contractId": "EBESExQVFhcYGRobHB0eHw==",
      "snapshotId": "7",
      "id": "aW50ZW50LWl0ZW0tMDAwMQ==",
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "maxBuyPriceCents": "4800",
      "maxFloat": 0.38,
      "referencePrices": [
        {
          "referenceIndex": 0,
          "source": "buff163",
          "metric": "sell_min",
          "valueCents": "5000",
          "priceCents": "4800"
        }
      ],
      "createdAt": "2026-04-01T12:15:00Z",
      "updatedAt": "2026-04-01T12:15:00Z"
    }
  ],
  "nextCursor": ""
}