Overview

TradeOn Merchant API

The B2B HTTP API for buying CS2 skins through the TradeOn Market catalogue. You authenticate with an API key, browse our live catalogue, place purchases that are delivered directly to your end-users on Steam, and receive webhook notifications when an order changes state.

Status: v1 — production. Base URL: https://api.tradeon.market.

Quickstart

  1. Get credentials. A TradeOn admin sends you an invite. Open the link, finish setup in the merchant cabinet at merchant.tradeon.market, then copy your API key from Settings → API key.
  2. Top up. Send USDT (TRC-20 / BEP-20) to the deposit address shown by GET /merchant/balance. You will receive a balance.deposited webhook once the deposit is confirmed.
  3. Browse the catalogue. GET /merchant/items for filtered listings, /items/full-dump for the entire catalogue (gzip + ETag).
  4. Buy. POST /merchant/buy (or POST /merchant/buy-sync to wait for the provider’s acknowledgement) with item_id, max_price, custom_id, and the buyer’s target_trade_url (SteamID64 is derived from its partner query — supply target_steam_id only if you want us to verify it matches). The debit is at-most max_price; the rest is refunded.
  5. Listen for webhooks. purchase.created → purchase.sent_to_steam → purchase.completed (happy path) or purchase.failed / purchase.refunded. See Webhooks.

Where to go next

  • Authentication — how to send the API key.
  • Conventions — JSON, money, timestamps, IDs, pagination.
  • Errors — full list of MERCHANT_* codes and retry guidance.
  • API Reference — Catalog, Purchases, Balance.
  • Webhooks — events, signature verification, retry, dedup.
  • Examples — Node.js and Python end-to-end.
Authentication