Skip to main content

GET /client/trades

Returns the trade history for the authenticated client. Supports filtering by type and game with cursor-based pagination. Authentication: Client Token (Authorization header)

Request

GET https://api.assetpay.gg/client/trades?type=deposit&game=730&limit=20
Authorization: CLIENT_TOKEN

Query Parameters

ParameterTypeDefaultDescription
typestring-Filter by "deposit" or "withdraw"
gamestring730Game app ID ("730" = CS2, "252490" = Rust)
cursorstring-Opaque cursor from a previous response’s nextCursor. Omit on the first page.
limitnumber20Trades per page (min 1, max 100)

Response

{
  "requestId": "...",
  "success": true,
  "data": {
    "items": [
      {
        "id": "trade-uuid",
        "type": "deposit",
        "source": "client",
        "status": "completed",
        "game": "730",
        "externalId": "dep_123",
        "merchantId": "merchant-uuid",
        "clientUserId": "client-uuid",
        "clientSteamID": "76561198012345678",
        "clientTradeUrl": "https://steamcommunity.com/tradeoffer/new/?partner=...",
        "items": [
          {
            "id": "encoded-item-id",
            "name": "AK-47 | Redline",
            "marketHashName": "AK-47 | Redline (Field-Tested)",
            "offer": {
              "price": 10.75,
              "reference": "ref_abc123",
              "accepted": true
            }
          }
        ],
        "totalPrice": 10.75,
        "preCredit": 8.60,
        "pendingCredit": 2.15,
        "isInstant": true,
        "holdEndDate": "2026-03-11T10:00:00.000Z",
        "createdAt": "2026-03-04T10:00:00.000Z",
        "updatedAt": "2026-03-11T10:00:00.000Z"
      }
    ],
    "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTAzLTA0VDEwOjAwOjAwLjAwMFoiLCJpZCI6InRyYWRlLXV1aWQifQ"
  }
}

Response Fields

FieldTypeDescription
itemsTrade[]Array of trade objects, newest first
nextCursorstring | nullOpaque cursor for the next page. Pass it back in the cursor query parameter. null when there are no more results.

Paginating

let cursor: string | null = null;
do {
  const url = new URL('https://api.assetpay.gg/client/trades');
  url.searchParams.set('type', 'deposit');
  if (cursor) url.searchParams.set('cursor', cursor);
  const res = await fetch(url, { headers: { Authorization: CLIENT_TOKEN } });
  const { data } = await res.json();
  for (const trade of data.items) {
    // process trade
  }
  cursor = data.nextCursor;
} while (cursor);

Rate Limits

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