Skip to content

API Reference / Intents

Fetch a single contract intent by ID

Returns one evaluated buying or selling intent within a contract snapshot. An intent records the item, the float window, and the price the contract will pay or list at, along with the source prices behind it.

POST/contracts.v1.Contracts/GetIntent

Request body

application/jsonRequired

Request for one intent in a contract snapshot by identifier.

contractIdstring

Contract the intent belongs to.

Format"byte" base64

intentIdstring

Intent identifier.

Format"byte" base64

snapshotIdstring

Evaluation snapshot the intent belongs to.

Format"int64"

Response body

application/json

Success

intent?Intent

The requested intent.

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

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