Skip to main content
PATCH
Change a listing's price
Changes the price of one of your active listings. Send the new price_usd in whole cents, from 0.10 to 100000. The response is the updated listing, with commission_usd and seller_payout_usd worked out for the new price. The same floor as publishing applies, and it cannot be confirmed past: a price under half of our market price for the item answers 422 price_below_market with market_usd and floor_usd. A listing that has sold or is mid-sale can no longer be repriced. Authentication required. Send your key as Authorization: Bearer csb_pub_.... Counts toward the 30 requests/minute P2P write limit of the key.

Example request

Example response

Error codes

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

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

Body

application/json
price_usd
number
required

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.

Required range: 0.1 <= x <= 100000Must be a multiple of 0.01

Response

The updated listing.

id
string
required

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

status
string
required

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
required

What the buyer pays.

currency
enum<string>
required
Available options:
USD
commission_usd
number
required

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

seller_payout_usd
number
required

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

market_hash_name
string
required
asset_id
string
required

Steam asset id of the listed copy.

needs_resync
boolean
required

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>
required
updated_at
string<date-time>
required
item_name
string
operational_asset_id
string | null
float_value
number | null