Skip to navigation

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:

sim não POST .../p2p/wallets Triagem respondeem poucos segundos? 201screeningStatus: approved ou rejected 202screeningStatus: pending A triagem continua Webhook <code>p2p.wallet.screened</code>approved ou rejected
cadastro triagem aprovada risco alto DELETE (sem ordem aberta) DELETE pending approved rejected 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).

Próximo passo: Anúncios para quem vai anunciar, ou Ordens para tomar um anúncio.