API Reference / Trade offers
Get a trade offer
Read one observed Steam trade offer, including its items, partner, state and timing. The account name selects the account's own perspective when both sides of an offer belong to the workspace.
/ steam. v1. Steam/ GetTradeOfferRequest body
application/jsonRequired
Request for one observed Steam trade offer, by its record id or seen from the perspective of the named account. Exactly one of id or the account name and offer id pair is set.
accountNamestringSteam account whose perspective of this offer to read. Required with offer_id when id is unset. Must be empty when id is set.
id?stringThe trade offer record's id, from TradeOffer.id. When set, account_name and offer_id must be empty.
Format"byte" base64
offerIdstringSteam trade-offer identifier. Required with account_name when id is unset. Must be empty when id is set.
Response body
application/json
Success
counteredById?stringFor a countered offer, the record id (TradeOffer.id) of the offer that replaced it: the counter offer sent the other way between the same account and partner when this one was countered. Unset when the offer was not countered or the counter offer has not been seen.
Format"byte" base64
stateChanges?array<TradeOfferStateChange>Every state the offer has been recorded in, oldest first: the state it was first seen in, then each change. Empty for an offer recorded before state changes were kept and for a historical offer.
Show attributes
changedAt?stringWhen the offer entered the state: Steam's own time for a change the poll observed, the platform's time for a change it made.
Format"date-time"
source?stringWhether the platform made the change or Steam's poll observed it.
Value in"TRADE_"TRADE_
state?stringSteam ETradeOfferState the offer entered, as its stored lowercase text.
tradeOffer?TradeOfferThe observed offer from the selected account's perspective.
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
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/GetTradeOffer" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountName": "flip_eu_02"
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/GetTradeOffer", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "flip_eu_02"
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "flip_eu_02"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/GetTradeOffer", 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/GetTradeOffer",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "flip_eu_02"
},
)
data = res.json(){
"counteredById": "AY86PB0ufwCKGyw9Tl9gcQ==",
"stateChanges": [
{
"changedAt": "2026-11-03T16:10:00Z",
"source": "TRADE_OFFER_STATE_CHANGE_SOURCE_PLATFORM",
"state": "example"
}
],
"tradeOffer": {
"accountName": "flip_eu_02",
"confirmationFailureReason": "CONFIRMATION_FAILURE_REASON_NO_SESSION",
"confirmationStatus": "CONFIRMATION_STATUS_PENDING",
"confirmedAt": "2026-11-03T16:10:00Z",
"createdAt": "2026-11-03T16:10:00Z",
"direction": "TRADE_OFFER_DIRECTION_SENT",
"escrowEndDate": "2026-11-03T16:10:00Z",
"expiresAt": "2026-11-03T16:10:00Z",
"historical": false,
"id": "AY86PB0ufwCKGyw9Tl9gcQ==",
"itemsToGive": [
{
"amount": "1",
"appId": 730,
"assetId": "39017128247",
"classId": "310777185",
"contextId": "2",
"floatValue": 3,
"iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/redline-ft",
"inspectUri": "example",
"instanceId": "480085569",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"paintSeed": 3
}
],
"itemsToReceive": [
{
"amount": "1",
"appId": 730,
"assetId": "39017128247",
"classId": "310777185",
"contextId": "2",
"floatValue": 3,
"iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/redline-ft",
"inspectUri": "example",
"instanceId": "480085569",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"paintSeed": 3
}
],
"message": "example",
"messageReference": {
"market": "TRADE_MESSAGE_MARKET_CSFLOAT",
"reference": "example"
},
"messageReferenceOtherItems": 212,
"offerId": "6512301874",
"origin": {
"contractId": "AY86PB0ufwCKGyw9Tl9gcQ==",
"handledAutomatically": false,
"kind": "TRADE_OFFER_ORIGIN_KIND_MANUAL",
"purchaseId": "AY86PB0ufwCKGyw9Tl9gcQ==",
"saleId": "AY86PB0ufwCKGyw9Tl9gcQ==",
"setAt": "2026-11-03T16:10:00Z"
},
"partnerAvatarHash": "AY86PB0ufwCKGyw9Tl9gcQ==",
"partnerPersonaName": "Rifle accounts",
"partnerPersonaObservedAt": "2026-11-03T16:10:00Z",
"partnerSteamId": "76561198140104729",
"reversal": {
"observedAt": "2026-11-03T16:10:00Z",
"returningTradeId": "example",
"settlesAt": "2026-11-03T16:10:00Z",
"steamStatus": 212,
"tradeId": "example"
},
"settlementDate": "2026-11-03T16:10:00Z",
"state": "example",
"tradeCompletion": {
"assetsGiven": [
{}
],
"assetsReceived": [
{}
],
"completedAt": "2026-11-03T16:10:00Z",
"tradeId": "example"
},
"updatedAt": "2026-11-03T16:10:00Z",
"workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ=="
}
}{
"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": "internal",
"message": "An internal server error occurred."
}