Skip to main content
PATCH
Change a listing's price
Меняет цену одного из ваших листингов в статусе active. Передайте новую price_usd в целых центах, от 0.10 до 100000. В ответе — обновлённый листинг, где commission_usd и seller_payout_usd пересчитаны под новую цену. Действует та же нижняя граница, что и при публикации, и обойти её подтверждением нельзя: цена ниже половины нашей рыночной цены на предмет получает 422 price_below_market с market_usd и floor_usd. Цену проданного или продающегося листинга изменить уже нельзя. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_.... Учитывается в лимите P2P-записей ключа — 30 запросов в минуту.

Пример запроса

Пример ответа

Коды ошибок

Авторизации

Authorization
string
header
обязательно

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

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

id
string
обязательно

Listing id from POST /p2p/listings or GET /p2p/listings.

Тело

application/json
price_usd
number
обязательно

Asking price in USD, whole cents (12.34; 12.345 is refused, not rounded). It may not be under half of our market price for the item — see price_below_market.

Требуемый диапазон: 0.1 <= x <= 100000Должно быть кратно 0.01

Ответ

The updated listing.

id
string
обязательно

Listing id — use it with PATCH / DELETE /p2p/listings/{id}.

status
string
обязательно

active — on sale. trade_pending, trade_sent, verification_hold — sold and mid-delivery. reconciliation_required — off the shelf because a full inventory read no longer saw the item (needs_resync: true).

price_usd
number
обязательно

What the buyer pays.

currency
enum<string>
обязательно
Доступные опции:
USD
commission_usd
number
обязательно

Our fee on this listing, taken from the seller's side.

seller_payout_usd
number
обязательно

What a sale credits to your balance: price_usd minus commission_usd.

market_hash_name
string
обязательно
asset_id
string
обязательно

Steam asset id of the listed copy.

needs_resync
boolean
обязательно

true when the listing was taken off the shelf because your inventory no longer showed the item. It cannot be revived in place — publish the item again once it is back.

created_at
string<date-time>
обязательно
updated_at
string<date-time>
обязательно
item_name
string
operational_asset_id
string | null
float_value
number | null