Sync with Waxpeer session to auto-fill API key

Open buy orders by item name, or your own (v2)

GET/v2/buy-orders

Public list (no own): open orders for up to 50 item names in one game (default csgo), highest price first, then oldest. Only orders whose owner can pay for one item are listed. Each order has by (the owner's user id) and no dates. 100 orders per page, skip up to 2000. Answers are cached for 1 second.

Filtered orders are listed with their filters and allow_trade_locked: an order with filters buys only matching copies, so compare them with your item before you treat its price as an offer for it. filters is null on a plain order.

Your orders (own=1): all your open orders, funded or not, newest first, with created, last_update and the total count. game and name narrow the list when given. 100 per page, skip up to 10000.

Errors. Refusals are HTTP 200 with {"success": false, "msg": "…", "code": "…"}. Branch on code: it is stable, msg is human text. Codes this method answers: invalid_request, error. The full list is on POST /v2/create-buy-order. A missing or wrong API key is HTTP 403; the write rate limit is HTTP 429.

Prices are integers. 1000 = $1.00 USD.

Parameters

NameLocationTypeDescription
api
required
querystring
name
optional
queryarray<string>

Item name; repeat for several (up to 50). Required without own

own
optional
queryenum

1: return your own open orders

enum: 0, 1

game
optional
queryenum

csgo, dota2, rust or tf2. Public list: default csgo. own=1: all games by default

enum: csgo, dota2, rust, tf2

skip
optional
queryinteger

Orders to skip (100 per page). Up to 2000, or 10000 with own=1

Responses

200 Successful operation or refusal

NameTypeDescription
success
optional
boolean

Whether the operation succeeded

orders
optional
array<object>

Open orders

id
optional
integer

Identifier

name
optional
string

Item name; repeat for several (up to 50). Required without own

game
optional
string

csgo, dota2, rust or tf2. Public list: default csgo. own=1: all games by default

price
optional
integer

Item price in integer format (1000 = $1.00 USD)

amount
optional
integer

Number of items

filled
optional
integer

How many items were bought so far

allow_trade_locked
optional
boolean

true: the order also buys trade-locked listings

filters
optional
object

CS2 only. Which copies the order buys; null on a plain order. Unset filters are omitted, and an unknown key is refused.

float_min
optional
number

Lowest float, 0 to 1

float_max
optional
number

Highest float, 0 to 1, not below float_min

paint_seeds
optional
array<integer>

1 to 50 paint seeds (patterns), each 0 to 1000

phase
optional
enum

Doppler phase name (e.g. Phase 1, Ruby, Emerald)

enum: Phase 1, Phase 2, Phase 3, Phase 4, Ruby, Sapphire, Emerald, Black Pearl

stickers
optional
array<object>

Applied stickers data

id
required
integer

Identifier

slot
optional
integer

Sticker slot 0 to 4; absent = any slot

charm_id
optional
integer

Charm id

charm_pattern_min
optional
integer

Lowest charm pattern, 0 to 100000

charm_pattern_max
optional
integer

Highest charm pattern, 0 to 100000

by
optional
string

Owner user id (public list only)

created
optional
string

Creation timestamp

last_update
optional
string

When the order last changed. Not in the public list

count
optional
integer

Total of your open orders (own=1 only)

msg
optional
string

Why the request was refused (only when success is false)

code
optional
enum

Stable refusal code (only when success is false)

enum: invalid_request, invalid_price, invalid_amount, invalid_filters, filters_not_editable, item_not_found, price_too_low, kyc_required, tradelink_required, price_above_balance, exposure_limit, too_many_orders, order_not_found, too_many_ids, busy, error

Response
{
  "success": true,
  "orders": [
    {
      "id": 123,
      "name": "AK-47 | Redline (Field-Tested)",
      "game": "csgo",
      "price": 12500,
      "amount": 3,
      "filled": 1,
      "allow_trade_locked": false,
      "filters": {
        "float_min": 0.15,
        "float_max": 0.18,
        "paint_seeds": [
          661,
          670
        ],
        "stickers": [
          {
            "id": 4777,
            "slot": 0
          },
          {
            "id": 55
          }
        ]
      },
      "by": "1247ffd5-f437-4a30-9953-10eda7df6e17"
    },
    {
      "id": 98,
      "name": "AK-47 | Redline (Field-Tested)",
      "game": "csgo",
      "price": 11000,
      "amount": 10,
      "filled": 0,
      "allow_trade_locked": true,
      "filters": null,
      "by": "5f0c2a1e-7d3b-4c61-9a8e-2b7f1c9d4e05"
    }
  ]
}