Skip to content

API Reference / Inventory changes

List recorded inventory changes for a Steam account

Returns the change log of inventory items added, updated, or removed for a Steam account in a workspace, newest first. Results are paginated through a cursor, and an account with no recorded changes returns an empty list.

POST/analytics.v1.Analytics/ListInventoryItemChanges

Request body

application/jsonRequired

Request for one page of the recorded inventory changes of one Steam account in the caller's workspace, newest first.

accountName?string

Steam account name whose inventory change history to read. The workspace is always the caller's own.

cursor?string

Opaque cursor from a previous ListInventoryItemChangesResponse.next_cursor. Empty for the first page.

limit?integer

Maximum number of changes to return, up to 1000. Zero uses the default of 100. A larger value is rejected with invalid_argument.

Format"int32"

Response body

application/json

Success

changes?array<InventoryItemChange>

The changes on this page, newest first.

Show attributes
action?string

What happened to the item.

Value in"INVENTORY_ITEM_CHANGE_ACTION_CREATED""INVENTORY_ITEM_CHANGE_ACTION_UPDATED""INVENTORY_ITEM_CHANGE_ACTION_DELETED"

amount?string

Number of units in the item's stack after the change. 1 for an ordinary item.

Format"int64"

appId?integer

Steam app id of the item's inventory. 730 for Counter-Strike 2.

Format"int32"

assetId?string

Steam asset id of the item, as a decimal string. Unique within the account's inventory context.

classId?string

Steam class id of the item, as a decimal string. Identifies the item's description shared by identical items.

contextId?string

Steam inventory context of the item, as a decimal string, such as "2" for the tradable CS2 inventory.

instanceId?string

Steam instance id of the item, as a decimal string. Distinguishes item variants that share a class id.

marketHashName?string

Steam market hash name of the item.

observedAt?string

When the change was observed, as an RFC 3339 UTC timestamp.

Format"date-time"

nextCursor?string

Cursor to pass as cursor to fetch the next page. Empty when this is the last page.

curl -X POST "https://api.goldmine.to/analytics.v1.Analytics/ListInventoryItemChanges" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "trade_bot_01",
    "limit": 50
  }'
{
  "changes": [
    {
      "assetId": "38502819374",
      "observedAt": "2026-06-29T11:42:13Z",
      "action": "created",
      "classId": "5564148233",
      "instanceId": "188530139",
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "appId": 730,
      "contextId": "2",
      "amount": "1"
    }
  ],
  "nextCursor": "eyJvIjoiMjAyNi0wNi0yOVQxMTo0MjoxM1oiLCJhIjoiMzg1MDI4MTkzNzQifQ=="
}