Skip to content

API Reference / Trade offers

Get the trade hold for a partner

Return the hold Steam would place on a trade between the account and a partner before it is sent, read live from Steam over the account's web session and reused for up to five minutes. A partner who is not a friend of the account needs the trade token from their trade URL. A token Steam refuses is a failed precondition with reason TRADE_TOKEN_REJECTED.

POST/steam.v1.Steam/GetTradeHoldDurations

Request body

application/jsonRequired

Request for the trade hold Steam would place on a trade between an account and a partner, before sending it.

accountNamestring

Steam account that would send the offer.

partnerSteamIdstring

The partner's 64-bit SteamID.

tradeToken?string

The token from the partner's trade URL. Steam requires it when the partner is not a friend of the account.

Response body

application/json

Success

bothEscrow?TradeHoldDuration

The hold when both sides give items.

Show attributes
duration?string

How long the items would be held.

endsAt?string

When the hold would end if the trade were made now. Unset when there is no hold or Steam gave no date.

Format"date-time"

myEscrow?TradeHoldDuration

The hold when only the account gives items.

Show attributes
duration?string

How long the items would be held.

endsAt?string

When the hold would end if the trade were made now. Unset when there is no hold or Steam gave no date.

Format"date-time"

observedAt?string

When Steam reported these holds. Answers are reused for up to five minutes.

Format"date-time"

theirEscrow?TradeHoldDuration

The hold when only the partner gives items.

Show attributes
duration?string

How long the items would be held.

endsAt?string

When the hold would end if the trade were made now. Unset when there is no hold or Steam gave no date.

Format"date-time"

curl -X POST "https://api.goldmine.to/steam.v1.Steam/GetTradeHoldDurations" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "trader_bot_01",
    "partnerSteamId": "76561198044443322",
    "tradeToken": "aBcD1234"
  }'
{
  "myEscrow": {
    "duration": "0s"
  },
  "theirEscrow": {
    "duration": "0s"
  },
  "bothEscrow": {
    "duration": "0s"
  },
  "observedAt": "2026-11-08T10:00:00Z"
}