Skip to main content
A buy order sets a price on an item type (item_id), not on one listing. It fills automatically when a matching item comes up for sale. If your bid is at or above the lowest listing, the response tells you to buy that listing directly. The order fills when a seller whose extension is running lists an item, or drops a price, at your bid or below. You get a notification and a pending trade, the same as a buy.
If your balance falls below price × quantity, the order leaves the book until your balance is high enough again.

Public book

GET /p2p/buyorder/list/{item}. {item} is the catalog id or the slug.
Response
The book shows five price levels, then more for the rest. price is in cents. With no orders, informations is {}.

My order on an item

GET /p2p/buyorder/{item}. informations is your order, or null.

Create

POST /p2p/buyorder.
Response: { "details": "Inserted", "buyorder": { } }.

Update

POST /p2p/buyorder/update. Same body as create. Response: { "details": "Buy order updated", "buyorder": { } }.

Remove

POST /p2p/buyorder/remove.
Response: { "details": "Removed" }.

My orders

GET /p2p/buyorders lists all your buy orders.