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.
/ steam. v1. Steam/ GetPartnerInventoryRequest body
application/jsonRequired
Request for one page of a trade partner's public CS2 inventory, read live from Steam through the account.
accountNamestringSteam account the inventory is read through, the one that would send the offer.
cursor?stringOpaque pagination cursor from a previous GetPartnerInventoryResponse. Empty for the first page.
limit?integerMaximum number of items to return. Server caps this at a service-defined upper bound.
Format"int32"
partnerSteamIdstringThe partner's 64-bit SteamID.
Response body
application/json
Success
fetchedAt?stringWhen 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?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.
application/json
The request was malformed, such as a missing required field or an unparseable cursor. The request cannot be carried out in the current system state.
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
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.
application/json
The service is temporarily unavailable. Retry with backoff.
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/GetPartnerInventory" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 100
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/GetPartnerInventory", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 100
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 100
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/GetPartnerInventory", 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/GetPartnerInventory",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 100
},
)
data = res.json(){
"items": [],
"nextCursor": "",
"fetchedAt": "2026-11-08T10:00:00Z"
}{
"code": "failed_precondition",
"message": "The request cannot be carried out in the current system state."
}{
"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": "internal",
"message": "An internal server error occurred."
}{
"code": "unavailable",
"message": "The service is temporarily unavailable. Retry with backoff."
}