Skip to content

API Reference / Trade offers

Get a trade partner's inventory

Return one page of a trade partner's public CS2 inventory, read live from Steam through the account's web session for building a trade offer and reused for up to five minutes. Nothing is stored. A private inventory is a failed precondition with reason INVENTORY_PRIVATE.

POST/steam.v1.Steam/GetPartnerInventory

Request body

application/jsonRequired

Request for one page of a trade partner's public CS2 inventory, read live from Steam through the account.

accountNamestring

Steam account the inventory is read through, the one that would send the offer.

cursor?string

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

limit?integer

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

Format"int32"

partnerSteamIdstring

The partner's 64-bit SteamID.

Response body

application/json

Success

fetchedAt?string

When the page was read from Steam. Pages are reused for up to five minutes.

Format"date-time"

items?array<InventoryItem>

The partner's items on 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.

curl -X POST "https://api.goldmine.to/steam.v1.Steam/GetPartnerInventory" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "trader_bot_01",
    "partnerSteamId": "76561198044443322",
    "limit": 100
  }'
{
  "items": [],
  "nextCursor": "",
  "fetchedAt": "2026-11-08T10:00:00Z"
}