API Reference / Trade offers
List trade offers
Return a paginated list of trade offers for the workspace, newest first. You can filter to several accounts, a direction, a set of states, an expiry bound or a search, and sort by time, account or status rank.
/ steam. v1. Steam/ ListTradeOffersRequest body
application/jsonRequired
Request for one page of the workspace's trade offers, newest first, optionally narrowed to one account, a set of states or a search.
cursor?stringOpaque pagination cursor from a previous ListTradeOffersResponse. Empty for the first page.
descending?booleanOrder descending instead of ascending. Restart pagination when changing direction.
filter?TradeOfferFilterOptional filters applied before pagination. Restart pagination when changing the filter.
Show attributes
accountNames?array<string>Only the trade offers of these workspace accounts, OR within the field. Empty lists every account's trade offers in the workspace. At most 200 names, each nonempty.
confirmationFailed?booleanTrue keeps only offers whose latest confirmation is pending after a failed attempt to answer it (confirmation_failure_reason set). False keeps every other offer. Absent sets no condition. ANDed with confirmation_statuses.
confirmationStatuses?array<string>Only offers whose latest mobile confirmation has one of these statuses, OR within the field. Empty matches every offer, including those with no confirmation.
Value in"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_
direction?stringOnly offers the account sent, or only offers it received. Absent includes both.
Value in"TRADE_"TRADE_
expiresBefore?stringOnly offers whose expiry is before this time, exclusive. An offer with no recorded expiry never matches. Absent sets no bound.
Format"date-time"
originKinds?array<string>Only offers with one of these origins, OR within the field. Empty matches every origin.
Value in"TRADE_"TRADE_"TRADE_
query?stringOptional literal case-insensitive search across item market hash names on either side, offer id and partner Steam id. Absent or empty matches every offer.
states?array<string>Optional Steam ETradeOfferState set, as stored lowercase text, OR within the field. Empty returns every state.
limit?integerMaximum number of trade offers to return. Server caps this at a service-defined upper bound.
Format"int32"
sortField?stringField to order the page by. Unspecified orders by updated_at. Unknown numeric values are invalid.
Value in"TRADE_"TRADE_"TRADE_"TRADE_"TRADE_
Response body
application/json
Success
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
tradeOffers?array<TradeOffer>Full trade offers for this page in the requested global order.
Show attributes
accountName?stringThe Steam account this offer belongs to.
confirmationFailureReason?stringWhy the last attempt to answer the offer's confirmation failed. Unspecified when none failed. Served on reads only, like confirmation_status.
Value in"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_
confirmationStatus?stringThe state of the offer's latest mobile confirmation. Unspecified when the offer has none. Served on ListTradeOffers and GetTradeOffer. Trade offer events leave it unspecified, and ConfirmationUpdated reports changes.
Value in"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_
confirmedAt?stringWhen the platform accepted the offer's latest mobile confirmation. Unset when the offer has none, it is not accepted yet, or it was answered on the Steam app. Served on reads only, like confirmation_status.
Format"date-time"
createdAt?stringWhen the offer was created on Steam.
Format"date-time"
direction?stringWhether this account sent or received the offer. Determines which action RPCs apply: a sent offer only accepts CancelTradeOffer, a received offer accepts AcceptTradeOffer or DeclineTradeOffer.
Value in"TRADE_"TRADE_
escrowEndDate?stringWhen an escrow hold on this offer auto-executes. Unset when the offer is not held or Steam has not yet published the date.
Format"date-time"
expiresAt?stringWhen the offer expires on Steam.
Format"date-time"
historical?booleanFirst observed during automatic historical offer sync. Immutable and read-only. Excluded from trading actions and purchase-delivery processing, including later updates.
id?stringThe record's UUIDv7 identifier, stable for the life of the stored offer. GetTradeOffer accepts it in place of the account name and offer id.
Format"byte" base64
itemsToGive?array<TradeItem>Items the account is offering.
Show attributes
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.
classId?stringSteam class id identifying the item's definition.
contextId?stringSteam inventory context id the item belongs to.
floatValue?numberThe item's wear, decoded offline from the inspect URI's encoded payload. Unset when unknown: no inspect URI, or a legacy link that carries no item data.
Format"double"
iconUrl?stringValve economy icon hash for this item instance. Empty when the observed offer has no instance image.
inspectUri?stringThe validated CS2 inspect URI for this exact asset, taken from the sending account's own inventory. Empty when the asset is not one of the workspace account's items or Steam gave no inspect action.
instanceId?stringSteam instance id, distinguishing item instances that share a class id.
marketHashName?stringThe item's market hash name.
paintSeed?integerThe item's pattern index (0 to 1000), decoded offline from the inspect URI's encoded payload. Unset when unknown.
Format"int32"
itemsToReceive?array<TradeItem>Items the account is receiving.
Show attributes
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.
classId?stringSteam class id identifying the item's definition.
contextId?stringSteam inventory context id the item belongs to.
floatValue?numberThe item's wear, decoded offline from the inspect URI's encoded payload. Unset when unknown: no inspect URI, or a legacy link that carries no item data.
Format"double"
iconUrl?stringValve economy icon hash for this item instance. Empty when the observed offer has no instance image.
inspectUri?stringThe validated CS2 inspect URI for this exact asset, taken from the sending account's own inventory. Empty when the asset is not one of the workspace account's items or Steam gave no inspect action.
instanceId?stringSteam instance id, distinguishing item instances that share a class id.
marketHashName?stringThe item's market hash name.
paintSeed?integerThe item's pattern index (0 to 1000), decoded offline from the inspect URI's encoded payload. Unset when unknown.
Format"int32"
message?stringThe offer's accompanying message.
messageReference?MarketReferenceThe market reference parsed from the offer's message, when it carries one of a known market (CSFloat's "Ref #<trade id>"). Unset otherwise. Anyone can write any message, so it is a further condition on a delivery, never proof of one.
Show attributes
market?stringThe market whose reference it is.
Value in"TRADE_
reference?stringThe purchase's id on that market (CSFloat: the trade id).
messageReferenceOtherItems?integerThe "and <n> other items" count beside the message reference, when the market wrote one: the offer carries that many more of the market's trades.
Format"int32"
offerId?stringThe trade offer's Steam id.
origin?TradeOfferOriginWhat the offer is for: a purchase delivery, a sale delivery, or a manual trade, with the purchase or sale and the contract behind it.
Show attributes
contractId?stringThe buying or selling contract behind the purchase or sale, when known.
Format"byte" base64
handledAutomatically?booleanWhether the platform itself accepted or sent the offer. False for a manual trade and for an offer classified after the fact.
kind?stringWhat the offer is for. MANUAL for a trade the platform did not tie to a purchase or a sale.
Value in"TRADE_"TRADE_"TRADE_
purchaseId?stringThe purchase the offer delivers. Set only for PURCHASE_DELIVERY.
Format"byte" base64
saleId?stringThe sale the offer delivers. Set only for SALE_DELIVERY.
Format"byte" base64
setAt?stringWhen the origin was recorded. Unset for a manual trade.
Format"date-time"
partnerAvatarHash?stringThe partner's raw Steam avatar hash, the same form as Persona.avatar_hash. Empty until observed or when the partner has no avatar.
Format"byte" base64
partnerPersonaName?stringThe partner's Steam display name, as the account's session last observed it. Empty until observed.
partnerPersonaObservedAt?stringWhen the partner's name and avatar were last observed. Unset until observed.
Format"date-time"
partnerSteamId?stringThe other side of the trade's 64-bit SteamID.
reversal?TradeReversalThe reversal of the trade this offer made, as Steam's trade history shows it. Unset while the trade stands. Set once, never cleared.
Show attributes
observedAt?stringWhen the watch first saw the reversal in Steam's trade history.
Format"date-time"
returningTradeId?stringSteam's id of the trade that moved the items back, the trade whose rollback_trade names the reversed one. Empty when the history read did not show it.
settlesAt?stringWhen the reversed trade would have become irreversible, from Steam's time_settlement. Unset when Steam gave none.
Format"date-time"
steamStatus?integerSteam's ETradeStatus of the reversed trade: 12 for a reversal inside trade protection, 5, 6 or 7 for a support rollback.
Format"int32"
tradeId?stringSteam's id of the trade that was reversed, the offer's trade id.
settlementDate?stringWhen the trade is no longer reversible. Unset when Steam returns no settlement date.
Format"date-time"
state?stringSteam ETradeOfferState as its stored lowercase text.
tradeCompletion?TradeCompletionThe completed trade's asset id mappings. Unset until Steam reports the trade complete. Offers this account sent never carry a completion.
Show attributes
assetsGiven?array<TradeCompletionAsset>Assets this account gave, with their before and after identities.
Show attributes
amount?stringStack size for a stackable asset. 1 for a non-stackable asset.
appId?integerSteam app id the asset belongs to.
Format"int32"
classId?stringSteam class id identifying the asset's definition.
contextId?stringSteam inventory context id the asset belongs to.
instanceId?stringSteam instance id, distinguishing asset instances that share a class id.
newAssetId?stringThe asset id Steam assigned after the trade completed.
oldAssetId?stringThe asset id before the trade completed.
assetsReceived?array<TradeCompletionAsset>Assets this account received, with their before and after identities.
Show attributes
amount?stringStack size for a stackable asset. 1 for a non-stackable asset.
appId?integerSteam app id the asset belongs to.
Format"int32"
classId?stringSteam class id identifying the asset's definition.
contextId?stringSteam inventory context id the asset belongs to.
instanceId?stringSteam instance id, distinguishing asset instances that share a class id.
newAssetId?stringThe asset id Steam assigned after the trade completed.
oldAssetId?stringThe asset id before the trade completed.
completedAt?stringWhen the trade completed.
Format"date-time"
tradeId?stringSteam's trade id, distinct from the trade offer id.
updatedAt?stringWhen the offer was last observed to change.
Format"date-time"
workspaceId?stringWorkspace the offer belongs to.
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/ListTradeOffers" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filter": {
"accountName": "trader_bot_01",
"states": [
"active"
]
},
"limit": 50
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/ListTradeOffers", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"filter": {
"accountName": "trader_bot_01",
"states": [
"active"
]
},
"limit": 50
}),
});
const data = await res.json();body := strings.NewReader(`{
"filter": {
"accountName": "trader_bot_01",
"states": [
"active"
]
},
"limit": 50
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/ListTradeOffers", 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/ListTradeOffers",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"filter": {
"accountName": "trader_bot_01",
"states": [
"active"
]
},
"limit": 50
},
)
data = res.json(){
"tradeOffers": [
{
"offerId": "6483920184",
"accountName": "trader_bot_01",
"workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ==",
"partnerSteamId": "76561198044443322",
"state": "active",
"itemsToGive": [
{
"assetId": "31795888228",
"classId": "310776898",
"instanceId": "302028390",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"appId": 730,
"contextId": "2",
"amount": "1"
}
],
"createdAt": "2026-06-29T11:30:00Z",
"expiresAt": "2026-07-13T11:30:00Z",
"updatedAt": "2026-06-29T11:30:00Z",
"message": "Thanks for the trade"
}
],
"nextCursor": "eyJvZmZlcklkIjoiNjQ4MzkyMDE4NCJ9"
}{
"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."
}