Skip to content

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.

POST/steam.v1.Steam/ListTradeOffers

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

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

descending?boolean

Order descending instead of ascending. Restart pagination when changing direction.

filter?TradeOfferFilter

Optional 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?boolean

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

direction?string

Only offers the account sent, or only offers it received. Absent includes both.

Value in"TRADE_OFFER_DIRECTION_SENT""TRADE_OFFER_DIRECTION_RECEIVED"

expiresBefore?string

Only 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_OFFER_ORIGIN_KIND_MANUAL""TRADE_OFFER_ORIGIN_KIND_PURCHASE_DELIVERY""TRADE_OFFER_ORIGIN_KIND_SALE_DELIVERY"

query?string

Optional 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?integer

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

Format"int32"

sortField?string

Field to order the page by. Unspecified orders by updated_at. Unknown numeric values are invalid.

Value in"TRADE_OFFER_SORT_FIELD_CREATED_AT""TRADE_OFFER_SORT_FIELD_UPDATED_AT""TRADE_OFFER_SORT_FIELD_EXPIRES_AT""TRADE_OFFER_SORT_FIELD_ACCOUNT""TRADE_OFFER_SORT_FIELD_STATUS_RANK"

Response body

application/json

Success

nextCursor?string

Cursor 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?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/ListTradeOffers" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "accountName": "trader_bot_01",
      "states": [
        "active"
      ]
    },
    "limit": 50
  }'
{
  "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"
}