Goldmine
Intents

Fetch a single contract intent by ID

POST
/contracts.v1.Contracts/GetIntent

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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/contracts.v1.Contracts/GetIntent" \  -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"
  }
}
{
  "code": "invalid_argument",
  "message": "The request was malformed, such as a missing required field or an unparseable cursor."
}
{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "not_found",
  "message": "The requested resource does not exist in this workspace."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}

ListSnapshots

Returns a paged list of evaluation snapshots for a contract, most recent first. Each page carries hydrated entities, so no follow-up GetSnapshots is needed.

GetIntentByMarketHashName

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.