API
ReferenceTrading

Your trades

GET
/public/v1/trades

Your Steam trades, newest first, optionally filtered by status. steam_offer_id is the Steam trade offer id once the offer is sent. Item value is the market value in cents at trade time. limit accepts only 500 or 1000, and the route allows one request per second — page in bulk rather than polling small pages.

Authorization

apiKey
AuthorizationBearer <token>

API key generated from your account settings on the website. Send as Authorization: Bearer csd_....

In: header

Query Parameters

page*string
Match^[1-9]\d*$
limit*string

Value in

  • "500"
  • "1000"
status?string

Value in

  • "Invalid"
  • "Active"
  • "Accepted"
  • "Countered"
  • "Expired"
  • "Canceled"
  • "Declined"
  • "InvalidItems"
  • "CreatedNeedsConfirmation"
  • "CanceledBySecondFactor"
  • "InEscrow"
  • "Reversed"

Response Body

application/json

curl -X GET "https://example.com/public/v1/trades?page=string&limit=500"
{  "trades": [    {      "id": 1,      "type": "SELL",      "status": "Invalid",      "deposit_id": 1,      "withdraw_id": 1,      "steam_offer_id": "string",      "value": -9007199254740991,      "error": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "items": [        {          "app_id": 1,          "market_hash_name": "string",          "steam_asset_id": "string",          "amount": -9007199254740991,          "value": -9007199254740991        }      ]    }  ],  "metadata": {    "total_pages": -9007199254740991,    "total_items": -9007199254740991,    "current_page": -9007199254740991,    "current_limit": -9007199254740991  }}

Buy listings POST

Buys the listings named in the request in a single atomic call. Nothing is bought unless every line succeeds. `max_price` is a ceiling in cents, not an exact match: a listing that got cheaper between your quote and this call still fills, one that got more expensive fails with `LISTING_PRICE_CHANGED`. Set it high to opt out. This does not read or modify your cart, so a bot and a browser session on the same account never interfere with each other. Private listings are not in any feed and are bought by passing the `private_token` from the share link on that line. Without it the line comes back as `LISTING_NOT_FOUND`, the same as an id that does not exist.

Withdraw to Steam POST

Sends backpack items to your Steam account as trade offers. Items held by different bots become separate offers; the response's `withdraw_ids` has one id per offer, matching the `withdraw_id` on `/trades` rows. Requires a Steam trade URL on the account. At most 50 items per request.