TradeOn Merchant API

Use the Merchant API to browse CS2 offers, buy items for Steam users, and track delivery and balance changes. Start with a read-only request; no deposit or purchase is needed.

Production base URL: https://merchant-api.tradeon.market

HTTP API version: v1, with paths under /api/v1/merchant.

Quickstart

You need an active merchant account, its API key, and curl. A TradeOn admin provides an invite; complete setup in the merchant cabinet, then copy your key from Settings → API key. See Authentication for key storage and rotation.

1. Set your API key

Set TRADEON_API_KEY in your local environment or secret manager. Replace this placeholder with your issued key. Keep it on your server and out of source control and logs.

export TRADEON_API_KEY='YOUR_API_KEY'

2. Request one offer

curl --fail-with-body --compressed --include \
  'https://merchant-api.tradeon.market/api/v1/merchant/items?limit=1' \
  -H "Authorization: Bearer $TRADEON_API_KEY"

3. Check the response

Expect HTTP 200 with an items array and next_cursor. This illustration shows selected item fields; the actual response includes the full CatalogItem. IDs, prices, and availability change. An empty items array is also a successful response.

{
  "items": [
    {
      "id": "8e42bb9c-2e11-4d40-9d51-6e5d2d4b2cf1",
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "price": 18.40
    }
  ],
  "next_cursor": "opaque-pagination-cursor"
}

Pass a returned next_cursor unchanged to fetch the next page. It is null at the end. This listing cursor is separate from the WebSocket replay cursor.

If you receive 401 MERCHANT_API_KEY_MISSING, check the Bearer header and whether the key is valid. Invalid keys use the same error. For 429, wait for Retry-After seconds before retrying. See Errors for other responses.

Where to go next