Skip to content

API Reference / Intents

Resolve a contract intent by its business identity

Looks up the single intent matching a contract snapshot and item name. An intent's business identity is (contract, snapshot, market_hash_name), enforced unique by storage, so this always resolves to at most one intent - useful when a caller knows the item but not the intent's opaque ID.

POST/contracts.v1.Contracts/GetIntentByMarketHashName

Request body

application/jsonRequired

Request for the intent of one item in a contract snapshot. At most one intent exists per contract, snapshot and item.

contractIdstring

Contract the intent belongs to.

Format"byte" base64

marketHashNamestring

The item to resolve an intent for, for example "AK-47 | Redline (Field-Tested)".

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/GetIntentByMarketHashName" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "snapshotId": "7",
    "marketHashName": "AK-47 | Redline (Field-Tested)"
  }'
{
  "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"
  }
}