Skip to content

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.

POST/steam.v1.Steam/GetTradeOffer

Request 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.

accountNamestring

Steam account whose perspective of this offer to read. Required with offer_id when id is unset. Must be empty when id is set.

id?string

The trade offer record's id, from TradeOffer.id. When set, account_name and offer_id must be empty.

Format"byte" base64

offerIdstring

Steam trade-offer identifier. Required with account_name when id is unset. Must be empty when id is set.

Response body

application/json

Success

counteredById?string

For 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?string

When 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?string

Whether the platform made the change or Steam's poll observed it.

Value in"TRADE_OFFER_STATE_CHANGE_SOURCE_PLATFORM""TRADE_OFFER_STATE_CHANGE_SOURCE_STEAM"

state?string

Steam ETradeOfferState the offer entered, as its stored lowercase text.

tradeOffer?TradeOffer

The observed offer from the selected account's perspective.

Show attributes
accountName?string

The Steam account this offer belongs to.

confirmationFailureReason?string

Why the last attempt to answer the offer's confirmation failed. Unspecified when none failed. Served on reads only, like confirmation_status.

Value in"CONFIRMATION_FAILURE_REASON_NO_SESSION""CONFIRMATION_FAILURE_REASON_NO_WEB_SESSION""CONFIRMATION_FAILURE_REASON_NO_IDENTITY_SECRET""CONFIRMATION_FAILURE_REASON_RATE_LIMITED""CONFIRMATION_FAILURE_REASON_STEAM_REJECTED"

confirmationStatus?string

The 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_STATUS_PENDING""CONFIRMATION_STATUS_ACCEPTED""CONFIRMATION_STATUS_DECLINED""CONFIRMATION_STATUS_GONE"

confirmedAt?string

When 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?string

When the offer was created on Steam.

Format"date-time"

direction?string

Whether 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_OFFER_DIRECTION_SENT""TRADE_OFFER_DIRECTION_RECEIVED"

escrowEndDate?string

When 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?string

When the offer expires on Steam.

Format"date-time"

historical?boolean

First observed during automatic historical offer sync. Immutable and read-only. Excluded from trading actions and purchase-delivery processing, including later updates.

id?string

The 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?string

Stack size for a stackable item. 1 for a non-stackable item.

Format"int64"

appId?integer

Steam app id the item belongs to.

Format"int32"

assetId?string

The item's Steam asset id.

classId?string

Steam class id identifying the item's definition.

contextId?string

Steam inventory context id the item belongs to.

floatValue?number

The 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?string

Valve economy icon hash for this item instance. Empty when the observed offer has no instance image.

inspectUri?string

The 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?string

Steam instance id, distinguishing item instances that share a class id.

marketHashName?string

The item's market hash name.

paintSeed?integer

The 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?string

Stack size for a stackable item. 1 for a non-stackable item.

Format"int64"

appId?integer

Steam app id the item belongs to.

Format"int32"

assetId?string

The item's Steam asset id.

classId?string

Steam class id identifying the item's definition.

contextId?string

Steam inventory context id the item belongs to.

floatValue?number

The 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?string

Valve economy icon hash for this item instance. Empty when the observed offer has no instance image.

inspectUri?string

The 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?string

Steam instance id, distinguishing item instances that share a class id.

marketHashName?string

The item's market hash name.

paintSeed?integer

The item's pattern index (0 to 1000), decoded offline from the inspect URI's encoded payload. Unset when unknown.

Format"int32"

message?string

The offer's accompanying message.

messageReference?MarketReference

The 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?string

The market whose reference it is.

Value in"TRADE_MESSAGE_MARKET_CSFLOAT"

reference?string

The purchase's id on that market (CSFloat: the trade id).

messageReferenceOtherItems?integer

The "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?string

The trade offer's Steam id.

origin?TradeOfferOrigin

What 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?string

The buying or selling contract behind the purchase or sale, when known.

Format"byte" base64

handledAutomatically?boolean

Whether the platform itself accepted or sent the offer. False for a manual trade and for an offer classified after the fact.

kind?string

What the offer is for. MANUAL for a trade the platform did not tie to a purchase or a sale.

Value in"TRADE_OFFER_ORIGIN_KIND_MANUAL""TRADE_OFFER_ORIGIN_KIND_PURCHASE_DELIVERY""TRADE_OFFER_ORIGIN_KIND_SALE_DELIVERY"

purchaseId?string

The purchase the offer delivers. Set only for PURCHASE_DELIVERY.

Format"byte" base64

saleId?string

The sale the offer delivers. Set only for SALE_DELIVERY.

Format"byte" base64

setAt?string

When the origin was recorded. Unset for a manual trade.

Format"date-time"

partnerAvatarHash?string

The 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?string

The partner's Steam display name, as the account's session last observed it. Empty until observed.

partnerPersonaObservedAt?string

When the partner's name and avatar were last observed. Unset until observed.

Format"date-time"

partnerSteamId?string

The other side of the trade's 64-bit SteamID.

reversal?TradeReversal

The 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?string

When the watch first saw the reversal in Steam's trade history.

Format"date-time"

returningTradeId?string

Steam'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?string

When the reversed trade would have become irreversible, from Steam's time_settlement. Unset when Steam gave none.

Format"date-time"

steamStatus?integer

Steam's ETradeStatus of the reversed trade: 12 for a reversal inside trade protection, 5, 6 or 7 for a support rollback.

Format"int32"

tradeId?string

Steam's id of the trade that was reversed, the offer's trade id.

settlementDate?string

When the trade is no longer reversible. Unset when Steam returns no settlement date.

Format"date-time"

state?string

Steam ETradeOfferState as its stored lowercase text.

tradeCompletion?TradeCompletion

The 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?string

Stack size for a stackable asset. 1 for a non-stackable asset.

appId?integer

Steam app id the asset belongs to.

Format"int32"

classId?string

Steam class id identifying the asset's definition.

contextId?string

Steam inventory context id the asset belongs to.

instanceId?string

Steam instance id, distinguishing asset instances that share a class id.

newAssetId?string

The asset id Steam assigned after the trade completed.

oldAssetId?string

The asset id before the trade completed.

assetsReceived?array<TradeCompletionAsset>

Assets this account received, with their before and after identities.

Show attributes
amount?string

Stack size for a stackable asset. 1 for a non-stackable asset.

appId?integer

Steam app id the asset belongs to.

Format"int32"

classId?string

Steam class id identifying the asset's definition.

contextId?string

Steam inventory context id the asset belongs to.

instanceId?string

Steam instance id, distinguishing asset instances that share a class id.

newAssetId?string

The asset id Steam assigned after the trade completed.

oldAssetId?string

The asset id before the trade completed.

completedAt?string

When the trade completed.

Format"date-time"

tradeId?string

Steam's trade id, distinct from the trade offer id.

updatedAt?string

When the offer was last observed to change.

Format"date-time"

workspaceId?string

Workspace the offer belongs to.

Format"byte" base64

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"
  }'
{
  "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=="
  }
}