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.
/ steam. v1. Steam/ GetInventoryRequest body
application/jsonRequired
Request for one page of an account's most recently observed CS2 inventory.
accountNamestringSteam account name whose inventory to read.
cursor?stringOpaque pagination cursor from a previous GetInventoryResponse. Empty for the first page.
cursorVersion?stringExplicit 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_
limit?integerMaximum number of items to return. Server caps this at a service-defined upper bound.
Format"int32"
Response body
application/json
Success
cursorVersion?stringThe honored continuation protocol. Must match an explicitly selected request version, including on empty pages. Zero or absence cannot acknowledge BOUND.
Value in"INVENTORY_
fetchedAt?stringWhen the returned inventory snapshot was fetched from Steam.
Format"date-time"
items?array<InventoryItem>Full items for this page.
Show attributes
accountName?stringThe Steam account holding this item. Empty on the GetInventory response, where the caller already knows which account it queried.
amount?stringStack size for a stackable item. 1 for a non-stackable item.
Format"int64"
appId?integerSteam app id the item belongs to.
Format"int32"
assetId?stringThe item's Steam asset id, unique within the account's inventory.
classId?stringSteam class id identifying the item's definition.
contextId?stringSteam inventory context id the item belongs to.
iconUrl?stringThe item's Valve-hosted economy icon hash for this exact instance. Empty when the item carries no per-instance render.
inspectUri?stringThe validated Steam inspect URI returned for this exact asset. Empty when unavailable or not yet observed.
instanceId?stringSteam instance id, distinguishing item instances that share a class id.
marketHashName?stringThe item's market hash name.
tradable?booleanWhether the item is currently tradable.
tradableAfter?stringWhen a held item becomes tradable. Unset when the item carries no trade hold.
Format"date-time"
workspaceId?stringWorkspace the item belongs to. Zero on the GetInventory response, where the caller already knows which account it queried.
Format"byte" base64
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
snapshot?InventorySnapshotCompleted 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?stringLifecycle 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?stringSteam account name whose inventory was walked.
appId?integerSteam app id of the inventory walked. Always 730, Counter-Strike 2.
Format"int32"
bodyPresent?booleanTrue 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?stringWhen 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?stringLowercase hex SHA-256 of the canonical item list, used to recognise an unchanged inventory without resending it. Not an item identity.
contextId?stringSteam 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?stringThe Steam account holding this item. Empty on the GetInventory response, where the caller already knows which account it queried.
amount?stringStack size for a stackable item. 1 for a non-stackable item.
Format"int64"
appId?integerSteam app id the item belongs to.
Format"int32"
assetId?stringThe item's Steam asset id, unique within the account's inventory.
classId?stringSteam class id identifying the item's definition.
contextId?stringSteam inventory context id the item belongs to.
iconUrl?stringThe item's Valve-hosted economy icon hash for this exact instance. Empty when the item carries no per-instance render.
inspectUri?stringThe validated Steam inspect URI returned for this exact asset. Empty when unavailable or not yet observed.
instanceId?stringSteam instance id, distinguishing item instances that share a class id.
marketHashName?stringThe item's market hash name.
tradable?booleanWhether the item is currently tradable.
tradableAfter?stringWhen a held item becomes tradable. Unset when the item carries no trade hold.
Format"date-time"
workspaceId?stringWorkspace the item belongs to. Zero on the GetInventory response, where the caller already knows which account it queried.
Format"byte" base64
snapshotId?stringUnique identifier of this completed inventory walk, a UUID in canonical text form.
startedAt?stringWhen the walk's first inventory page was requested from Steam.
Format"date-time"
steamId?stringSteamID64 of the account whose inventory was walked, as a decimal string.
totalItems?integerNumber of item stacks in the complete walk, which can be more than the items returned on one page.
Format"int32"
workspaceId?stringOpaque 16-byte identifier of the workspace that owns the account, base64-encoded in JSON.
Format"byte" base64
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The requested resource does not exist in this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
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
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/GetInventory", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "trader_bot_01",
"limit": 50
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "trader_bot_01",
"limit": 50
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/GetInventory", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/steam.v1.Steam/GetInventory",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "trader_bot_01",
"limit": 50
},
)
data = res.json(){
"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"
}{
"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."
}