Skip to content

API Reference / Contracts

Check whether contracts still target items

Says for each contract and item whether the contract still targets the item, and if not why: the item left the contract's rules, the contract is paused, or the contract was deleted. Purchases and inventory pages read a page of items in one call. Includes deleted contracts, so an old purchase can say its contract is gone.

POST/contracts.v1.Contracts/GetIntentTargeting

Request body

application/jsonRequired

Request for whether contracts in the caller's workspace still target items, in one call.

keys?array<IntentKey>

The contracts and items to answer for, at most 100.

Show attributes
contractId?string

Opaque 16-byte contract identifier.

Format"byte" base64

marketHashName?string

Exact market_hash_name of the item.

Response body

application/json

Success

targetings?array<IntentTargeting>

One entry per key in request order. A key whose contract is not in the caller's workspace has no entry.

Show attributes
key?IntentKey

The contract and item this answers for.

Show attributes
contractId?string

Opaque 16-byte contract identifier.

Format"byte" base64

marketHashName?string

Exact market_hash_name of the item.

maxBuyPriceCents?string

The contract's maximum price for the item now, in US cents: the highest of its current active intents for the item. Set only while targeted.

Format"int64"

reason?string

Why the item is not targeted. Unset while targeted, and while a contract is still being evaluated for the first time after activation.

Value in"INTENT_UNTARGETED_REASON_ITEM_LEFT_CONTRACT""INTENT_UNTARGETED_REASON_CONTRACT_PAUSED""INTENT_UNTARGETED_REASON_CONTRACT_DELETED"

targeted?boolean

True when the contract has a current active intent for the item.

untargetedAt?string

When the item stopped being targeted, when that is recorded: the last evaluation that removed it, or the contract's deletion. Unset for a paused contract and when no removal was recorded.

Format"date-time"

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetIntentTargeting" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keys": [
      {
        "contractId": "EBESExQVFhcYGRobHB0eHw==",
        "marketHashName": "AK-47 | Redline (Field-Tested)"
      }
    ]
  }'
{
  "targetings": [
    {
      "key": {
        "contractId": "EBESExQVFhcYGRobHB0eHw==",
        "marketHashName": "AK-47 | Redline (Field-Tested)"
      },
      "targeted": false,
      "reason": "INTENT_UNTARGETED_REASON_ITEM_LEFT_CONTRACT",
      "untargetedAt": "2026-11-02T10:00:00Z"
    }
  ]
}