Создать автопокупку

POST/v1/market/items/{slug}/auto-buys

Ждёт лоты предмета и покупает каждый, как только он появится: новый лот или лот, которому продавец снизил цену, не дороже max_price_cents и прошедший её фильтр: диапазон флота, паттерны, наклейки, брелок и фаза, как у CSFloat. Наклейку или брелок, которых нет в каталоге, она не примет. Лоты, которые уже в продаже, она не трогает: их можно купить оптом. Каждый лот покупается по своей цене и становится отдельной сделкой, пока не куплено quantity. Деньги в это время не удерживаются: если баланса не хватает, лот достаётся следующей автопокупке, а ваша ждёт дальше. Первой идёт самая высокая цена, затем самая старая автопокупка. Ждать одновременно могут 100. Тот же Idempotency-Key вернёт ту же автопокупку.

Запрос

Параметры пути

  • slugstringобязательно

    Slug предмета из карточки маркета.

Заголовки

  • Idempotency-Keystringобязательно

    Любая уникальная строка для этой автопокупки. Для каждой новая, при повторе та же.

Тело запроса

  • max_price_centsintegerобязательно

    Сколько самое большее может стоить один лот, в центах США.

  • quantityintegerобязательно

    Сколько всего лотов купить, от 1 до 100.

  • filterobjectобязательно

    Какие лоты она берёт. Лот должен пройти каждое заданное поле, а пустое поле ничего не сужает.

    Поля filter

    • phasestring

      Фаза Doppler или Gamma Doppler.

    • float_minnumber

      Минимальный флот, от 0 до 1.

    • float_maxnumber

      Максимальный флот, от 0 до 1 и не ниже float_min.

    • paint_seedsinteger[]

      Paint seed от 0 до 1000, до 25 штук: подходит лот с любым из них.

    • stickersobject[]

      До 5 наклеек, каждая из которых должна быть на предмете. Считается только не поцарапанная наклейка, а название, указанное дважды, требует двух таких.

      Поля stickers

      • namestringобязательно

        Название наклейки, как в каталоге, но без «Sticker | ».

      • slotinteger

        Её место на оружии, от 0 до 4. Без него подойдёт любое. Две наклейки не могут занимать один слот.

    • charmstring

      Название брелока, как в каталоге, но без «Charm | » или «Souvenir Charm | ». Он должен висеть на предмете.

curl -X POST 'https://api.rockvel.store/v1/market/items/ak-47-redline-field-tested/auto-buys' \
  -H "Authorization: Bearer $ROCKVEL_KEY" \
  -H 'Idempotency-Key: 5b8d2f17-9c4e-4a63-8e1b-d7f02a6c3945' \
  -H 'Content-Type: application/json' \
  -d '{
    "max_price_cents": 3300,
    "quantity": 5,
    "filter": {
      "float_max": 0.3,
      "paint_seeds": [412, 661],
      "stickers": [{ "name": "Crown (Foil)" }]
    }
  }'

Ответ 201

  • idstring

    Id автопокупки.

  • item_slugstring

    Slug предмета.

  • namestring

    market_hash_name.

  • image_urlstring

    Изображение предмета.

  • raritystringможет отсутствовать

    Редкость, например Classified.

  • max_price_centsinteger

    Сколько самое большее она платит за один лот, в центах США.

  • quantityinteger

    Сколько всего лотов она купит.

  • boughtinteger

    Сколько уже купила.

  • filterobject

    Какие лоты она берёт.

    Поля filter

    • phasestringможет отсутствовать

      Фаза Doppler или Gamma Doppler.

    • float_minnumberможет отсутствовать

      Минимальный флот, от 0 до 1.

    • float_maxnumberможет отсутствовать

      Максимальный флот, от 0 до 1 и не ниже float_min.

    • paint_seedsinteger[]может отсутствовать

      Paint seed от 0 до 1000, до 25 штук: подходит лот с любым из них.

    • stickersobject[]может отсутствовать

      До 5 наклеек, каждая из которых должна быть на предмете. Считается только не поцарапанная наклейка, а название, указанное дважды, требует двух таких.

      Поля stickers

      • namestring

        Название наклейки, как в каталоге, но без «Sticker | ».

      • slotintegerможет отсутствовать

        Её место на оружии, от 0 до 4. Без него подойдёт любое. Две наклейки не могут занимать один слот.

    • charmstringможет отсутствовать

      Название брелока, как в каталоге, но без «Charm | » или «Souvenir Charm | ». Он должен висеть на предмете.

  • created_atdate-time

    Когда она начала ждать.

{
  "id": "019a4d02-8b1c-7e44-a6f2-3c9d5e7b1a08",
  "item_slug": "ak-47-redline-field-tested",
  "name": "AK-47 | Redline (Field-Tested)",
  "image_url": "https://community.akamai.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyLwlcK3wiFO0POlPPNSI_-RHGavzOtyufRkASq2lkxx4W-HnNyqJC3FZwYoC5p0Q7FfthW6wdWxPu-371Pdit5HnyXgznQeHYY5wyA",
  "rarity": "Classified",
  "max_price_cents": 3300,
  "quantity": 5,
  "bought": 0,
  "filter": {
    "float_max": 0.3,
    "paint_seeds": [412, 661],
    "stickers": [{ "name": "Crown (Foil)" }]
  },
  "created_at": "2026-11-02T06:41:17Z"
}

Отказы

СтатусКодКогда
403bannedЭтот аккаунт не может начинать на Rockvel ничего нового.
409item_unknownПредмета ещё нет в каталоге.
409no_trade_urlСначала укажите трейд-ссылку.
409too_many_auto_buysУ вас уже ждут 100 автопокупок. Сначала отмените одну.
422bad_lotСписок пуст, цена вне диапазона от 3 до 100000000 центов или фильтр вне своих границ.
422too_many_lotsБольше 100 предметов в одном запросе.

Любой маршрут может также ответить статусами со страницы Ошибки.