Skip to content

API Reference / Intents

Fetch multiple contract intents by ID

Returns the intents matching the given IDs within a contract snapshot, alongside the IDs that did not resolve.

POST/contracts.v1.Contracts/GetIntents

Request body

application/jsonRequired

Request for several intents in one contract snapshot by identifier, in one call.

contractIdstring

Contract the intents belong to.

Format"byte" base64

intentIds?array<string>

Intent identifiers to fetch.

snapshotIdstring

Evaluation snapshot the intents belong to.

Format"int64"

Response body

application/json

Success

intents?array<Intent>

The intents that were found.

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

notFoundIds?array<string>

Requested intent ids that did not resolve.

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetIntents" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "snapshotId": "7",
    "intentIds": [
      "aW50ZW50LWl0ZW0tMDAwMQ==",
      "aW50ZW50LWl0ZW0tMDAwMg=="
    ]
  }'
{
  "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"
    }
  ],
  "notFoundIds": [
    "aW50ZW50LWl0ZW0tMDAwMg=="
  ]
}