Предложить цену

POST/v1/lots/{id}/bargains

Предлагает продавцу цену ниже цены лота, но не ниже, чем позволяет его max_discount: price_cents × (100 − max_discount) / 100 с округлением вверх до цента. У продавца 24 часа, чтобы принять, назвать свою цену или отказаться. Деньги не удерживаются, но сейчас они должны быть на балансе. Если продавец примет, лот продаётся вам по этой цене отдельной сделкой, а если денег к тому времени не хватит, торг закончится. Новая цена за тот же лот заменяет прежнюю, а ждать ответа одновременно могут 100 цен. Сначала нужна трейд-ссылка.

Запрос

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

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

    Id лота.

Тело запроса

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

    Цена в центах США: новая для лота, увиденная для покупки, предложенная в торге.

curl -X POST 'https://api.rockvel.store/v1/lots/019a4b9d-2e17-7a58-b1c6-0d3f6a9e4b12/bargains' \
  -H "Authorization: Bearer $ROCKVEL_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"price_cents":3000}'

Ответ 201

  • idstring

    Id торга.

  • rolestring

    Ваша сторона в торге.

    Одно изbuyerseller

  • statusstring

    Где сейчас торг. Торг, у которого вышло время, читается как expired.

    Одно изopencounteredaccepteddeclinedcancelledexpired

  • lot_idstring

    Лот, о котором торг.

  • item_slugstring

    Slug предмета.

  • itemobject

    Предмет, как его показывает лот.

    Поля item
    • asset_idstring

      Id именно этого предмета в Steam. Меняется, когда предмет переходит к другому владельцу.

    • namestring

      Название, как его показывает Steam.

    • market_hash_namestring

      Название на торговой площадке Steam. На каждое своя карточка маркета.

    • image_urlstring

      Иконка предмета в Steam.

    • kindstring

      Вид предмета.

      Одно изweaponknifeglovesagentstickerpatchcharmgraffitimusic_kitcontainercollectibleother

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

      Редкость словами Steam.

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

      Код состояния: FN, MW, FT, WW или BS.

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

      Предмет StatTrak.

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

      Предмет Souvenir.

    • marketableboolean

      Steam разрешает продавать предмет на своей площадке.

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

      Флот, от 0 до 1. Поля нет у предметов без флота.

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

      Paint seed, от 0 до 1000.

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

      Счётчик убийств StatTrak.

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

      Номер раскраски в игре.

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

      Номер оружия в игре.

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

      Фаза Doppler или Gamma Doppler.

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

      Именная бирка на предмете.

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

      Открывает предмет в игре.

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

      Видео момента сувенирного брелока.

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

      Наклейки на предмете и нашивки на агенте.

      Поля stickers
      • idintegerможет отсутствовать

        Номер в игре.

      • namestring

        Название.

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

        Изображение.

      • slotinteger

        Какое место на предмете занимает.

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

        Насколько потёрта, 0 — целая.

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

        Масштаб, как в игре.

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

        Поворот, как в игре.

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

        Смещение по x, как в игре.

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

        Смещение по y, как в игре.

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

        Смещение по z, как в игре.

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

        Номер оттенка в игре.

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

        Узор брелока.

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

        Момент на сувенирном брелоке.

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

      Брелоки на предмете.

      Поля keychains
      • idintegerможет отсутствовать

        Номер в игре.

      • namestring

        Название.

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

        Изображение.

      • slotinteger

        Какое место на предмете занимает.

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

        Насколько потёрта, 0 — целая.

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

        Масштаб, как в игре.

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

        Поворот, как в игре.

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

        Смещение по x, как в игре.

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

        Смещение по y, как в игре.

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

        Смещение по z, как в игре.

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

        Номер оттенка в игре.

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

        Узор брелока.

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

        Момент на сувенирном брелоке.

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

      Все метки, которые Steam даёт предмету.

      Поля tags
      • categorystring

        Вид метки, например Collection.

      • namestring

        Сама метка.

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

      Строки Steam об этом предмете: его матч, дата выпуска, содержимое контейнера.

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

      Подсказка для цены: самый дешёвый лот этого названия на lis-skins, у Doppler — этой фазы. Флот, паттерн и наклейки в ней не учтены. Только в вашем инвентаре и на витрине, поля нет, если на lis-skins такого лота нет.

      Поля reference
      • price_centsinteger

        Цена в центах США.

      • offersinteger

        Сколько лотов этого названия или фазы на lis-skins.

  • lot_price_centsinteger

    Сколько лот стоит сейчас, в центах США.

  • price_centsinteger

    Цена покупателя, в центах США.

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

    Ответная цена продавца, в центах США. Поля нет, пока её нет.

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

    Сделка, которой стал принятый торг.

  • actionsstring[]

    Что можно сделать с торгом сейчас.

    Одно изacceptcounterdeclinecancel

  • created_atdate-time

    Когда покупатель предложил цену.

  • expires_atdate-time

    Когда у стороны, чья очередь, выйдет время.

{
  "id": "019a4d3f-5a72-7b19-8c0e-2f6d1b9a4e57",
  "role": "buyer",
  "status": "open",
  "lot_id": "019a4b9d-2e17-7a58-b1c6-0d3f6a9e4b12",
  "item_slug": "ak-47-redline-field-tested",
  "item": {
    "asset_id": "54267934219",
    "name": "AK-47 | Redline (Field-Tested)",
    "market_hash_name": "AK-47 | Redline (Field-Tested)",
    "image_url": "https://community.akamai.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyLwlcK3wiFO0POlPPNSI_-RHGavzOtyufRkASq2lkxx4W-HnNyqJC3FZwYoC5p0Q7FfthW6wdWxPu-371Pdit5HnyXgznQeHYY5wyA",
    "kind": "weapon",
    "rarity": "Classified Rifle",
    "exterior": "FT",
    "marketable": true,
    "float": 0.2613,
    "paint_seed": 412,
    "paint_index": 282,
    "def_index": 7,
    "inspect_link": "steam://run/730//+csgo_econ_action_preview%2006168DEAFD92CC071E0E26F0072E0536023EE1",
    "stickers": [
      {
        "id": 1693,
        "name": "Sticker | Crown (Foil)",
        "slot": 1,
        "wear": 0.08
      }
    ],
    "tags": [
      { "category": "Type", "name": "Rifle" },
      { "category": "Weapon", "name": "AK-47" },
      {
        "category": "Collection",
        "name": "The Phoenix Collection"
      },
      {
        "category": "Quality",
        "name": "Classified Rifle"
      },
      { "category": "Exterior", "name": "Field-Tested" }
    ]
  },
  "lot_price_cents": 3250,
  "price_cents": 3000,
  "actions": ["cancel"],
  "created_at": "2026-11-02T07:41:17Z",
  "expires_at": "2026-11-03T07:41:17Z"
}

Отказы

СтатусКодКогда
402not_enough_moneyНа балансе не хватает денег.
403bannedЭтот аккаунт не может начинать на Rockvel ничего нового.
409lot_goneЛот продан или снят.
409no_trade_urlСначала укажите трейд-ссылку.
409own_lotЭто ваш собственный лот.
409too_many_bargainsУ вас уже ждут ответа 100 цен. Сначала отзовите одну.
422bad_bargainЛот не принимает торг, цена не ниже цены лота или не в пределах его max_discount, или встречная цена не между ценой покупателя и ценой лота.

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