Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Return the authenticated client’s trade history with cursor-based pagination, filterable by trade type and game, for reconciliation and support tooling.
/secure/* endpoints are not included.
Authentication: Client Token (Authorization header)
GET https://api.assetpay.gg/client/trades?type=deposit&game=730&limit=20
Authorization: CLIENT_TOKEN
| Parameter | Type | Default | Description |
|---|---|---|---|
type | string | - | Filter by "deposit" or "withdraw" |
game | string | 730 | Game app ID ("730" = CS2, "252490" = Rust) |
cursor | string | - | Opaque cursor from a previous response’s nextCursor. Omit on the first page. A cursor that can’t be decoded is ignored and the first page is returned. |
limit | number | 20 | Trades per page (min 1, max 100) |
{
"requestId": "...",
"success": true,
"data": {
"items": [
{
"id": "trade-uuid",
"type": "deposit",
"source": "client",
"status": "completed",
"game": "730",
"externalId": "dep_123",
"externalClientUserId": "user-123",
"merchantId": "merchant-uuid",
"clientUserId": "client-uuid",
"clientSteamID": "76561198012345678",
"clientTradeUrl": "https://steamcommunity.com/tradeoffer/new/?partner=...",
"offerID": "7123456789",
"items": [
{
"id": "encoded-item-id",
"assetId": "38912345678",
"appid": 730,
"name": "AK-47 | Redline",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"tradable": true,
"offer": {
"price": 10.75,
"accepted": true
}
}
],
"totalPrice": 10.75,
"preCredit": 8.60,
"pendingCredit": 2.15,
"isInstant": true,
"holdEndDate": "2026-03-11T10:00:00.000Z",
"activeAt": "2026-03-04T10:01:00.000Z",
"createdAt": "2026-03-04T10:00:00.000Z",
"updatedAt": "2026-03-11T10:00:00.000Z"
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTAzLTA0VDEwOjAwOjAwLjAwMFoiLCJpZCI6InRyYWRlLXV1aWQifQ"
}
}
| Field | Type | Description |
|---|---|---|
items | Trade[] | Array of trade objects, newest first |
nextCursor | string | null | Opaque cursor for the next page. Pass it back in the cursor query parameter. null when there are no more results. |
externalClientUserId, offerID, revertedBy, botInfo, error, activeAt and autoCancelAt. Deposit items include the Steam assetId of the deposited item.
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);
| Merchant Status | Limit |
|---|---|
| Verified | 3,000 requests / min |
| Unverified | 30 requests / min |
| Code | Key | When |
|---|---|---|
| 1001 | VALIDATION_FAILED | Invalid query parameter (HTTP 400, details in error.fields) |
| 1005 | RATE_LIMITED | Rate limit exceeded (HTTP 429) |
| 1007 | SYSTEM_MAINTENANCE | Service is in maintenance mode (HTTP 503) |
| 1102 | INVALID_TOKEN | Client token is invalid or expired |
| 1108 | MISSING_BEARER | No Authorization header |