Create an ad
Creates an ad. Approved advertisers only. Scope p2p.ads. A buy ad needs the account’s cashout unblocked (423 cashout_locked): the order amount is held from this account. Outside the account’s cashout hours the buy ad is created but stays off the market (hiddenReason) until the window opens.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
CPF of the human performing the operation. Required on cashout routes when the credential enforces a transaction PIN. On a company P2P profile contact, this CPF is the holder who signs; it is not taken from the body.
Optional client-generated idempotency token (recommended for safe retries).
Request
sell: you sell crypto for BRL. Required on creation.
spread: basis points over the Binance spot. fixed: fixed BRL price. offset: a signed BRL amount (4 decimal places) added to the Binance spot. The unit price always has 4 decimal places; the order amount rounds down to cents at opening and the fee rounds up. The fee rate stays in basis points of the order amount, whatever the mode.
spread mode: spread over the Binance spot price at the moment. The listed price is indicative; the order locks the spread over the spot captured at opening.
fixed mode: fixed BRL price per unit, up to 4 decimal places. The order locks this price as-is; only the BRL amount rounds to cents at opening.
offset mode: signed BRL amount per unit added to the Binance spot, up to 4 decimal places (-0.0100 buys one cent below, 0.0001 is one ten-thousandth). Must stay within 5% of the current spot (422 invalid_offset); without a Binance quote when publishing or changing the offset, 409 price_unavailable.
Crypto amount offered (sell) or wanted (buy).
Unit of the per-order range. brl (default): minAmount/maxAmount in BRL. asset: minAssetAmount/maxAssetAmount in crypto, and the opening compares the order crypto amount against them. Sending the fields of the other unit is 400 invalid_payload; switching units requires both bounds in the new unit (400 missing_fields). With asset, a Binance quote is needed when the range or the price changes (409 price_unavailable), because the BRL equivalent is what the per-order cap and the buy-ad autopause measure.
Minimum BRL per order (limitsUnit brl).
Maximum BRL per order (capped by tenant and advertiser caps; limitsUnit brl).
Minimum crypto per order, up to the pair decimals (limitsUnit asset).
Maximum crypto per order (limitsUnit asset). Its BRL equivalent is still capped by tenant and advertiser caps.
Approved wallet: source (sell) or destination (buy).
Deprecated. Whole BRL cents; 1 is stored as 0.0100. Prefer offset. Ignored when offset is also sent.
Response
Pricing: spread (bps over the Binance spot), fixed (fixed BRL price) or offset (signed BRL amount, 4 decimal places, over the Binance spot).
spread mode: basis points over the Binance spot.
offset mode: signed BRL amount per unit added to the Binance spot, 4 decimal places. Requests may still send the deprecated integer offsetCents; responses only send offset.
Current BRL price per unit, 4 decimal places; null without a usable quote.
Fixed price per unit, 4 decimal places (owner).
Unit the advertiser set the per-order range in.
Minimum BRL per order. With limitsUnit asset it is minAssetAmount at the price shown, so it moves with the price.
Maximum BRL per order. With limitsUnit asset it is maxAssetAmount at the price shown.
Minimum crypto per order. Only with limitsUnit asset.
Maximum crypto per order. Only with limitsUnit asset.
Crypto available (stock minus reserved).
Total stock (owner).
Reserved by open orders (owner).
Ad wallet (owner).
Instructions flagged for review (owner).
Why the ad was paused automatically (owner). cashout_locked means the holder blocked the account’s cashout; reactivate after unblocking.
Advertiser (market listing).