Skip to content

API Reference / Inventory

List the Steam asset ID chain for an inventory item

Returns the ordered chain of Steam asset IDs for a single inventory item, tracing each rotation across the three trade steps: the original listing, the purchase trade, and the sale trade. The chain is append-only and supports profit attribution across Steam's asset_id rotation on every trade.

POST/contracts.v1.Contracts/ListAssetIDLinks

Request body

application/jsonRequired

Request for one page of the Steam asset ids an inventory item has had, in the order the item moved through trades.

cursor?string

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

inventoryItemIdstring

Inventory item whose asset_id chain should be returned.

Format"byte" base64

limit?integer

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

Format"int32"

Response body

application/json

Success

assetIdLinks?array<AssetIDLink>

Asset ID links for this page, ordered by step.

Show attributes
assetId?string

Steam asset_id at this step.

createdAt?string

When the link was recorded.

Format"date-time"

deletedAt?string

When the link was soft-deleted. Unset for active links.

Format"date-time"

id?string

Opaque 16-byte link identifier.

Format"byte" base64

inventoryItemId?string

Inventory item this link belongs to.

Format"byte" base64

previousAssetId?string

Asset_id from the previous step. Empty for the first link in the chain.

purchaseId?string

Purchase the inventory item originated from.

Format"byte" base64

source?string

Source subsystem that produced the link.

Value in"ASSET_ID_LINK_SOURCE_LISTING""ASSET_ID_LINK_SOURCE_PURCHASE_TRADE""ASSET_ID_LINK_SOURCE_SALE_TRADE"

sourceId?string

External identifier from the source subsystem, for example, a trade offer ID or marketplace listing ID.

step?integer

Zero-based append position in the chain: listing=0, purchase_trade=1, sale_trade=2. Higher values are later rotations. Sale_trade is the terminal step.

Format"int32"

workspaceId?string

Workspace that owns the chain.

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/contracts.v1.Contracts/ListAssetIDLinks" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inventoryItemId": "aW52ZW50b3J5LWl0ZW0tMDc3",
    "limit": 50,
    "cursor": ""
  }'
{
  "assetIdLinks": [],
  "nextCursor": ""
}