Skip to main content

​
GET /secure/trades/{tradeId}

Returns trades initiated via /secure/sell or /secure/buy. tradeId accepts either the internal trade id or the externalId you supplied at creation. Scoped to the calling merchant — another merchant’s trade or a client-source trade is treated as not found. Authentication: Merchant API Key (api-key header) Scope: CORE_ACCESS

​
Request (single)

GET https://api.assetpay.gg/secure/trades/wd_unique_789
api-key: ap_...
A single ref returns one Trade object, or 404 TRADE_NOT_FOUND if it doesn’t resolve. 
{
  "requestId": "...",
  "success": true,
  "data": {
    "id": "trade-uuid",
    "type": "withdraw",
    "source": "self",
    "status": "hold",
    "game": "730",
    "externalId": "wd_unique_789",
    "merchantId": "merchant-uuid",
    "clientSteamID": "76561198012345678",
    "clientTradeUrl": "https://steamcommunity.com/tradeoffer/new/?partner=12345&token=ABCDEFGH",
    "items": [ /* InventoryItem[] */ ],
    "totalPrice": 45.00,
    "offerID": "9088123456",
    "botInfo": {
      "name": "tradingbot01",
      "avatar": "https://...",
      "steamId": "76561198..."
    },
    "createdAt": "2026-05-14T12:00:00.000Z",
    "updatedAt": "2026-05-14T12:01:30.000Z"
  }
}

​
Fetching multiple (batch)

Comma-separate up to 100 ids/externalIds to fetch several in one call — ideal for polling the status of multiple pending withdrawals without one request per trade. 
GET https://api.assetpay.gg/secure/trades/wd_1,wd_2,wd_3
api-key: ap_...
With more than one ref the data is an array of the trades that resolved. Unresolved refs are simply omitted (no 404), so compare the returned externalIds against what you asked for to find the gaps. 
{
  "requestId": "...",
  "success": true,
  "data": [
    { "id": "...", "externalId": "wd_1", "status": "completed", "...": "..." },
    { "id": "...", "externalId": "wd_2", "status": "hold", "...": "..." }
  ]
}
(wd_3 didn’t resolve, so it’s absent from the array.)

​
Rate Limits

Merchant StatusLimit
Verified3,000 requests / min
Unverified100 requests / min

​
Errors

CodeKeyWhen
21TRADE_NOT_FOUNDA single ref doesn’t resolve (not found, another merchant’s trade, or a client-source trade). Batch requests omit unresolved refs instead of erroring.
1001VALIDATION_FAILEDMore than 100 refs supplied in one request.