P2P Crypto — ads
Any account with a profile can take ads. To publish an ad, the account must be an advertiser approved by CorpX.
Advertiser request
POST /v1/accounts/{accountId}/p2p/advertiser-requests answers 202: the request enters the CorpX queue. No username: 409 username_required. An account that is already an advertiser or is suspended: 409 advertiser_request_not_allowed. The decision arrives as p2p.advertiser.updated and shows up in advertiserStatus on GET .../p2p/profile.
On approval, CorpX sets the advertiser’s level (which fixes the fee) and, when it wants, a per-order cap. A suspended or refused advertiser has their active ads paused.
Create and edit an ad
POST .../p2p/ads:
PATCH .../p2p/ads/{adId} changes price, stock, limits, deadline, instructions, wallet and status (active, paused, closed). A closed ad does not come back. Stock cannot go below what is reserved in open orders (422 stock_below_reserved).
States and stock
- Each order reserves crypto from the stock on opening. Release consumes the reservation; cancellation and a refund in a dispute give it back.
- The ad only shows up in the book with free stock (stock minus reserved) above zero. With
amountin the book filter, only ads whose minimum and maximum cover the amount come back. - Suspension by CorpX. CorpX can suspend an ad (
pausedReason: staff_suspended). While suspended, turning it back on answers422 ad_suspended. Orders that were already open carry on normally. - Cashout locks of the buying advertiser. On a
buyad, the order amount is held from the advertiser’s account, and they release it through their own cashout locks. So the ad only takes orders when they could pay: with cashout blocked, activebuyads are paused (cashout_locked), and creating or turning one back on answers423 cashout_locked; outside the cashout hours, the ad leaves the book and the detail (404 ad_not_found), and opening an order on it answers409 ad_unavailable, until the window opens. In the owner’s list, a hidden active ad hashiddenReason(cashout_lockedorcashout_outside_hours). The IP restriction does not apply: on opening, the caller is the taker.
Intermediation fee
The fee is paid by the advertiser and calculated when the order opens:
fee = order amount × feeBps of the advertiser's level ÷ 10,000, rounded to the cent up. A fraction of a cent never drops to zero. The order amount, by contrast, truncates to the cent (crypto × the 4-decimal price).
The order shows fee and feePayer. The buyer sees heldAmount; the seller sees netAmount. Details and numeric examples in Money and fee.