Skip to content

API Reference / Inventory

Get a Steam account's inventory

Return a paginated page of the most recently observed inventory snapshot for a Steam account, including each item's tradability and a timestamp showing how fresh the snapshot is. Use the returned cursor to fetch subsequent pages.

POST/steam.v1.Steam/GetInventory

Request body

application/jsonRequired

Request for one page of an account's most recently observed CS2 inventory.

accountNamestring

Steam account name whose inventory to read.

cursor?string

Opaque pagination cursor from a previous GetInventoryResponse. Empty for the first page.

cursorVersion?string

Explicit continuation protocol. Omitted or zero preserves legacy raw asset IDs. BOUND selects endpoint, workspace, account and asset-ascending position binding. A caller must require the same version in every successful response.

Value in"INVENTORY_CURSOR_VERSION_BOUND"

limit?integer

Maximum number of items to return. Server caps this at a service-defined upper bound.

Format"int32"

Response body

application/json

Success

cursorVersion?string

The honored continuation protocol. Must match an explicitly selected request version, including on empty pages. Zero or absence cannot acknowledge BOUND.

Value in"INVENTORY_CURSOR_VERSION_BOUND"

fetchedAt?string

When the returned inventory snapshot was fetched from Steam.

Format"date-time"

items?array<InventoryItem>

Full items for this page.

Show attributes
accountName?string

The Steam account holding this item. Empty on the GetInventory response, where the caller already knows which account it queried.

amount?string

Stack size for a stackable item. 1 for a non-stackable item.

Format"int64"

appId?integer

Steam app id the item belongs to.

Format"int32"

assetId?string

The item's Steam asset id, unique within the account's inventory.

classId?string

Steam class id identifying the item's definition.

contextId?string

Steam inventory context id the item belongs to.

iconUrl?string

The item's Valve-hosted economy icon hash for this exact instance. Empty when the item carries no per-instance render.

inspectUri?string

The validated Steam inspect URI returned for this exact asset. Empty when unavailable or not yet observed.

instanceId?string

Steam instance id, distinguishing item instances that share a class id.

marketHashName?string

The item's market hash name.

tradable?boolean

Whether the item is currently tradable.

tradableAfter?string

When a held item becomes tradable. Unset when the item carries no trade hold.

Format"date-time"

workspaceId?string

Workspace the item belongs to. Zero on the GetInventory response, where the caller already knows which account it queried.

Format"byte" base64

nextCursor?string

Cursor to pass to fetch the next page. Empty when there are no more results.

snapshot?InventorySnapshot

Completed inventory proof metadata for this cache page. The proof body is omitted. Items remains the bounded page. Absent when no proven snapshot is available.

Show attributes
accountGeneration?string

Lifecycle version of the account when the walk ran. It changes when a deleted account is restored, so a snapshot from an earlier lifecycle can be told apart and ignored.

Format"int64"

accountName?string

Steam account name whose inventory was walked.

appId?integer

Steam app id of the inventory walked. Always 730, Counter-Strike 2.

Format"int32"

bodyPresent?boolean

True when items carries the full item list of this snapshot, including an empty list for an empty inventory. False when the list is omitted and must be resolved from an earlier snapshot with the same content_id.

completedAt?string

When the walk's last inventory page was received from Steam. The snapshot reflects the inventory between started_at and this time.

Format"date-time"

contentId?string

Lowercase hex SHA-256 of the canonical item list, used to recognise an unchanged inventory without resending it. Not an item identity.

contextId?string

Steam inventory context walked, as a decimal string. Always "2", the tradable CS2 inventory context.

items?array<InventoryItem>

The full item list when body_present is true. Empty when the list is omitted, and always omitted from API pages, which return items separately.

Show attributes
accountName?string

The Steam account holding this item. Empty on the GetInventory response, where the caller already knows which account it queried.

amount?string

Stack size for a stackable item. 1 for a non-stackable item.

Format"int64"

appId?integer

Steam app id the item belongs to.

Format"int32"

assetId?string

The item's Steam asset id, unique within the account's inventory.

classId?string

Steam class id identifying the item's definition.

contextId?string

Steam inventory context id the item belongs to.

iconUrl?string

The item's Valve-hosted economy icon hash for this exact instance. Empty when the item carries no per-instance render.

inspectUri?string

The validated Steam inspect URI returned for this exact asset. Empty when unavailable or not yet observed.

instanceId?string

Steam instance id, distinguishing item instances that share a class id.

marketHashName?string

The item's market hash name.

tradable?boolean

Whether the item is currently tradable.

tradableAfter?string

When a held item becomes tradable. Unset when the item carries no trade hold.

Format"date-time"

workspaceId?string

Workspace the item belongs to. Zero on the GetInventory response, where the caller already knows which account it queried.

Format"byte" base64

snapshotId?string

Unique identifier of this completed inventory walk, a UUID in canonical text form.

startedAt?string

When the walk's first inventory page was requested from Steam.

Format"date-time"

steamId?string

SteamID64 of the account whose inventory was walked, as a decimal string.

totalItems?integer

Number of item stacks in the complete walk, which can be more than the items returned on one page.

Format"int32"

workspaceId?string

Opaque 16-byte identifier of the workspace that owns the account, base64-encoded in JSON.

Format"byte" base64

curl -X POST "https://api.goldmine.to/steam.v1.Steam/GetInventory" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "trader_bot_01",
    "limit": 50
  }'
{
  "items": [
    {
      "assetId": "31795888228",
      "classId": "310776898",
      "instanceId": "302028390",
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "appId": 730,
      "contextId": "2",
      "amount": "1",
      "tradable": true
    }
  ],
  "fetchedAt": "2026-06-29T11:50:00Z",
  "nextCursor": "31795888228"
}