> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# P2P Cripto — anúncios

Qualquer conta com perfil toma anúncios. Para **publicar** anúncio, a conta precisa ser anunciante aprovada pela CorpX.

## Pedido de anunciante

`POST /v1/accounts/{accountId}/p2p/advertiser-requests` responde `202`: o pedido entra na fila da CorpX. Sem `username`: `409 username_required`. Conta que já é anunciante ou está suspensa: `409 advertiser_request_not_allowed`. A decisão chega por `p2p.advertiser.updated` e aparece em `advertiserStatus` no `GET .../p2p/profile`.

```mermaid
stateDiagram-v2
    [*] --> none
    none --> pending: POST advertiser-requests
    pending --> approved: CorpX aprova (com nível)
    pending --> refused: CorpX recusa
    refused --> pending: novo pedido
    approved --> suspended: CorpX suspende
    suspended --> approved: CorpX reativa
```

Na aprovação, a CorpX define o **nível** do anunciante (que fixa a taxa) e, quando quiser, um **teto por ordem**. Anunciante suspenso ou recusado tem os anúncios ativos pausados.

## Criar e editar anúncio

`POST .../p2p/ads`:

| Campo                    | Regra                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `side`                   | `sell` (o anunciante vende cripto) ou `buy` (compra). Não muda depois.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `pair`                   | Um par ligado no mercado (`GET /v1/p2p/pairs`). Não muda depois.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `priceMode`              | `spread` (pontos-base sobre o spot da Binance), `fixed` (preço fixo) ou `offset` (diferença em reais, com 4 casas, sobre o spot da Binance). O preço por unidade sai sempre com 4 casas. A taxa é sempre em bps do valor da ordem, em qualquer modo.                                                                                                                                                                                                                                                                            |
| `spreadBps`              | No modo `spread`, de -500 a 500 pontos-base sobre o spot da Binance (`{ATIVO}BRL`). O `price` que aparece na lista e no anúncio é indicativo, lido na hora da consulta; o que vale é o spot capturado na abertura da ordem.                                                                                                                                                                                                                                                                                                     |
| `fixedPrice`             | No modo `fixed`, preço por unidade em reais com até 4 casas (`"5.4321"`). A ordem trava esse preço; só o valor em reais da ordem arredonda para centavos.                                                                                                                                                                                                                                                                                                                                                                       |
| `offset`                 | No modo `offset`, reais por unidade somados ao spot, com sinal e até 4 casas: `"-0.0100"` compra a R\$ 0,01 abaixo, `"0.0001"` é um décimo de milésimo. Dentro de 5 % do spot do momento (`422 invalid_offset`); sem cotação da Binance ao publicar ou ao mudar o `offset`, `409 price_unavailable`. O teto é medido só nesses dois momentos: editar estoque ou limites não depende da Binance. `offsetCents` (inteiro, centavos) ainda é aceito e vira `offset` com duas casas a mais de zero; a resposta só devolve `offset`. |
| `stockAmount`            | Quanto de cripto o anúncio oferece (ou quer comprar).                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `minAmount`, `maxAmount` | Limites por ordem, em reais. `maxAmount` respeita o teto da CorpX, o do tenant do anunciante e o do anunciante (`422 amount_above_cap`). Na abertura também vale o teto do tenant de quem toma.                                                                                                                                                                                                                                                                                                                                 |
| `deliveryDeadlineMin`    | Prazo de entrega prometido, dentro da faixa do mercado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `walletId`               | Carteira aprovada na rede do par (no anúncio `sell`, a de origem da cripto).                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `instructions`           | Até 500 caracteres. Texto com dado de contato ou pagamento por fora é marcado.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

`PATCH .../p2p/ads/{adId}` muda preço, estoque, limites, prazo, instruções, carteira e `status` (`active`, `paused`, `closed`). Fechado não volta. O estoque não fica abaixo do reservado em ordens abertas (`422 stock_below_reserved`).

## Estados e estoque

```mermaid
stateDiagram-v2
    [*] --> active: POST ads
    active --> paused: dono pausa ou<br />pausa automática (pausedReason)
    paused --> active: dono religa
    active --> closed: dono fecha
    paused --> closed: dono fecha
    closed --> [*]
```

| `pausedReason`                               | Motivo                                                                             |
| -------------------------------------------- | ---------------------------------------------------------------------------------- |
| `pair_disabled`                              | A CorpX desligou o par no mercado.                                                 |
| `advertiser_suspended`, `advertiser_refused` | O anunciante perdeu a aprovação.                                                   |
| `wallet_removed`                             | A carteira do anúncio foi removida.                                                |
| `insufficient_balance`                       | Anúncio `buy` sem saldo para bloquear uma ordem tomada.                            |
| `staff_suspended`                            | A CorpX suspendeu o anúncio.                                                       |
| `cashout_locked`                             | Anúncio `buy`: o titular bloqueou a saída da conta. Religue depois de desbloquear. |

* Cada ordem **reserva** cripto do estoque na abertura. A liberação consome a reserva; o cancelamento e a devolução numa disputa a devolvem.
* O anúncio só aparece no livro com estoque livre (estoque menos reservado) acima de zero. Com `amount` no filtro do livro, só vêm anúncios cujo mínimo e máximo cobrem o valor.
* **Suspensão pela CorpX.** A CorpX pode suspender um anúncio (`pausedReason: staff_suspended`). Enquanto suspenso, religar responde `422 ad_suspended`. As ordens que já estavam abertas seguem normalmente.
* **Travas de saída do anunciante comprador.** Num anúncio `buy`, o valor da ordem é bloqueado na conta do anunciante, e ele libera passando pelas [travas de saída](/baas/guias/autenticacao/seguranca-da-conta) dele. Por isso o anúncio só recebe ordem quando ele poderia pagar: com a saída bloqueada, os anúncios `buy` ativos são pausados (`cashout_locked`), e criar ou religar um responde `423 cashout_locked`; fora da janela de horário de saída, o anúncio sai do livro e do detalhe (`404 ad_not_found`), e abrir ordem nele responde `409 ad_unavailable`, até a janela abrir. Na lista do dono, o anúncio ativo escondido traz `hiddenReason` (`cashout_locked` ou `cashout_outside_hours`). A restrição de IP não entra: na abertura, quem chama é o tomador.

## Taxa de intermediação

A taxa é **paga pelo anunciante** e calculada na abertura da ordem:

`taxa = valor da ordem × feeBps do nível do anunciante ÷ 10.000`, arredondada ao centavo **para cima**. Fração de centavo não zera: a tabela nunca cobra menos do que diz. O valor da ordem, ao contrário, trunca ao centavo (cripto × preço de 4 casas).

| Anúncio | Quem anuncia | Quem paga a taxa | Como sai                                                                       |
| ------- | ------------ | ---------------- | ------------------------------------------------------------------------------ |
| `sell`  | Vendedor     | Vendedor         | O vendedor recebe o valor cheio e a taxa é debitada da conta dele logo depois. |
| `buy`   | Comprador    | Comprador        | O bloqueio na abertura já inclui a taxa (`heldAmount` = valor + taxa).         |

A ordem mostra `fee` e `feePayer`. O comprador vê `heldAmount`; o vendedor vê `netAmount`. Detalhes e exemplos numéricos em [Dinheiro e taxa](/baas/guias/p2p/dinheiro-e-taxa).