Выставить предметы

POST/v1/lots

Выставляет до 100 предметов сразу, все или ни одного. Описание лота берётся из копии инвентаря, поэтому сначала загрузите свежую. От вас только цена.

Запрос

Тело запроса

lotsobject[]обязательно
Предметы и их цены.
Поля lots
- asset_idstringобязательно
  asset_id предмета в вашем инвентаре.
- price_centsintegerобязательно
  Цена в центах США, от 3 до 100000000.
- descriptionstring
  Что вы хотите сказать о предмете, одной строкой.

curl -X POST 'https://api.rockvel.store/v1/lots' \
  -H "Authorization: Bearer $ROCKVEL_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"lots":[{"asset_id":"54267934219","price_cents":3250}]}'

Ответ 201

Список объектов с этими полями.

idstring
Id лота.
asset_idstring
asset_id предмета.
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.
price_centsinteger
Цена в центах США.
descriptionstringможет отсутствовать
Что вы написали о лоте.
max_discountintegerможет отсутствовать
На сколько процентов ниже цены вы принимаете торг. Поля нет, если не принимаете.
pausedbooleanможет отсутствовать
Лот снят с маркета, пока витрина на паузе. Иначе поля нет.
listed_atdate-time
Когда лот выставлен.

[
  {
    "id": "019a4b9d-2e17-7a58-b1c6-0d3f6a9e4b12",
    "asset_id": "54267934219",
    "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"
        }
      ],
      "reference": { "price_cents": 3240, "offers": 213 }
    },
    "price_cents": 3250,
    "max_discount": 10,
    "listed_at": "2026-11-01T07:41:17Z"
  }
]

Отказы

Статус	Код	Когда
403	`banned`	Этот аккаунт не может начинать на Rockvel ничего нового.
409	`already_listed`	Один из предметов уже выставлен или продан.
409	`item_gone`	Предмета нет в копии инвентаря. Загрузите свежую и попробуйте снова.
409	`item_unknown`	Предмета ещё нет в каталоге.
422	`bad_description`	Описание длиннее 32 символов, в нём несколько строк или пробелы по краям.
422	`bad_lot`	Список пуст, цена вне диапазона от 3 до 100000000 центов или фильтр вне своих границ.
422	`too_many_lots`	Больше 100 предметов в одном запросе.

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