API
ReferenceSelling

Your listings

Open raw markdownFor pasting into AI assistants
GET
/public/v1/my-listings

Your own listings, newest first, filterable by app_id and status (ACTIVE, DISABLED, FILLED). available_amount is how many more copies of a commodity listing you can add to it, so copies still inside a Steam trade hold are excluded. price_decay is the listing's decay curve and how far into it the listing is, or null for a flat price; price is always the price right now. Rows are lean: item detail for a listing is in GET /public/v1/listings.

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

  • "5"
  • "10"
  • "25"
  • "30"
  • "50"
  • "100"
app_id?string
Match^[1-9]\d*$
status?string

Value in

  • "ACTIVE"
  • "DISABLED"
  • "FILLED"
  • "PRIVATE"

Response Body

application/json

curl -X GET "https://example.com/public/v1/my-listings?page=string&limit=5"
{  "listings": [    {      "id": 1,      "app_id": 1,      "market_hash_name": "string",      "price": -9007199254740991,      "amount": -9007199254740991,      "commodity": true,      "created_at": "2019-08-24T14:15:22Z",      "available_amount": -9007199254740991,      "price_decay": {        "start_price": -9007199254740991,        "end_price": -9007199254740991,        "total_hours": -9007199254740991,        "elapsed_hours": 0      }    }  ],  "metadata": {    "total_pages": -9007199254740991,    "total_items": -9007199254740991,    "current_page": -9007199254740991,    "current_limit": -9007199254740991  }}

Value of your listings GET

What your active listings are worth at their asking prices: `total_value` in cents, across `listing_count` listings holding `item_count` items. Optional `app_id` filter. The v1 equivalent was `ISales/GetActiveListingsValue`.

Sell from Steam POST

Lists items straight from your Steam inventory: we send you a trade offer for them, and they go on the market at your price once you accept. `items` holds `token`s from `GET /public/v1/steam-inventory` with how many of each to sell, and `price` is per copy in cents. Items of the same type can share a listing; different types need their own group. The 50 groups and 50 entries per group are structural caps on the body, not the trade size: one request becomes one trade offer per game, and a game's offer may carry at most 500 copies in total, counting `amount`, otherwise the call fails with `DEPOSIT_ITEM_LIMIT`. You may also have at most 15 trades in flight at once, past which it fails with `ACTIVE_TRADE_LIMIT`. This is the v1 `ISales/ListItems` flow with the Steam half intact. Each response `deposit_id` matches the `deposit_id` on `GET /public/v1/trades` rows, which is where you watch for the offer and its status. Items already on site are listed with `POST /public/v1/list` instead, no trade offer needed.