Sync with Waxpeer session to auto-fill API key

Active buy orders (v1)

GET/v1/buy-ordersDeprecated

Deprecated

Use this instead: GET /v2/buy-orders

This path is served by the same code as GET /v2/buy-orders and answers with its contract: same rules and refusal codes, and the same response with v1's field names added.

Parameters are the same as before.

Changed from the old v1:

  • Orders are in orders and, as before, in offers (the same list).
  • Filtered orders are listed too, with filters and allow_trade_locked. An order with filters buys only matching copies: compare them with your item before you treat its price as an offer for it.
  • own=1 honours game and name, lists newest first, and adds created and last_update.
  • count is returned only with own=1.
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_price_step, 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

offers
optional
array<object>

The same list as orders (v1 name)

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

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"
    }
  ],
  "offers": [
    {
      "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"
    }
  ]
}