> 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 — primeiros passos

Antes da primeira ordem, a conta precisa de um perfil público e de pelo menos uma carteira aprovada na rede do par. Todas as rotas desta página ficam em `/v1/accounts/{accountId}/p2p`.

## 1. Perfil

`PUT .../p2p/profile` com `{"username": "..."}`. O `username` é o nome público no mercado: minúsculas, único no mercado inteiro (todos os tenants). Já em uso: `409 username_taken`. `GET .../p2p/profile` devolve o perfil com o status de anunciante e a reputação.

O perfil público de qualquer conta fica em `GET /v1/p2p/profiles/{username}`: reputação, taxa de conclusão e tempo médio de entrega. Os números só aparecem depois de um mínimo de ordens, definido pela CorpX.

## 2. Carteiras

`POST .../p2p/wallets` com `network` (`tron`, `ethereum` ou `polygon`), `address` e `label` opcional (até 40 caracteres). O endereço é validado no formato da rede. A mesma carteira não entra duas vezes na conta (`409 wallet_already_registered`).

Toda carteira passa pela triagem de risco da Elliptic:

```mermaid
flowchart TD
    A["POST .../p2p/wallets"] --> B{"Triagem responde<br />em poucos segundos?"}
    B -- "sim" --> C["<b>201</b><br />screeningStatus: approved ou rejected"]
    B -- "não" --> D["<b>202</b><br />screeningStatus: pending"]
    D --> E["A triagem continua"]
    E --> F["Webhook <code>p2p.wallet.screened</code><br />approved ou rejected"]
```

```mermaid
stateDiagram-v2
    [*] --> pending: cadastro
    pending --> approved: triagem aprovada
    pending --> rejected: risco alto
    approved --> removida: DELETE (sem ordem aberta)
    rejected --> removida: DELETE
    removida --> [*]
```

* Só carteira `approved` negocia. Carteira `rejected` não volta para `approved`: cadastre outra.
* **Carteira padrão.** `POST .../wallets/{walletId}/default` troca a padrão (só `approved`). A troca vale depois de um período de carência definido pela CorpX; até lá, `defaultEffectiveAt` mostra quando entra em vigor. A carência protege o comprador contra troca de carteira por quem tomou a conta.
* **Remover.** `DELETE .../wallets/{walletId}`. Carteira em ordem em andamento: `409 wallet_in_open_order`. Anúncio que usava a carteira é pausado.
* Na abertura de cada ordem, a CorpX tria as duas carteiras de novo. Uma carteira que passou a ter risco recusa a ordem, e `details.walletOf` diz de quem é.

## 3. Mercado

* `GET /v1/p2p/pairs`: os pares ligados no mercado (ativo, rede, contrato do token, casas decimais e confirmações exigidas).
* `GET /v1/p2p/settings`: os parâmetros do mercado que valem para o tenant: prazos de assinatura, entrega e liberação, carência de carteira nova, teto por ordem e diário, faixa da taxa de anunciante e os pares. Útil para a tela "como funciona" antes da primeira ordem.
* `GET /v1/p2p/ads?pair=&side=`: o livro de anúncios ativos, com preço, limites e o perfil público do anunciante.

## Pronto para negociar

* [ ] A feature `p2p_crypto` está ligada no tenant (senão, `403 feature_disabled`).
* [ ] A credencial tem `p2p.read` e `p2p.trade` (e `p2p.wallets` para cadastrar carteira).
* [ ] O perfil tem `username`.
* [ ] Há carteira `approved` na rede do par, e ela é a padrão (ou o `walletId` vai na abertura).
* [ ] A conta tem saldo disponível para o valor (comprador) e não está bloqueada.
* [ ] O cliente tem PIN de transação cadastrado (comprar num anúncio de venda e liberar pedem o PIN; vender não).
* [ ] O app assina os webhooks P2P, ou faz polling na ordem (veja [Webhooks](/baas/guias/p2p/webhooks)).

Próximo passo: [Anúncios](/baas/guias/p2p/anuncios) para quem vai anunciar, ou [Ordens](/baas/guias/p2p/ordens) para tomar um anúncio.