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:
- Só carteira
approvednegocia. Carteirarejectednão volta paraapproved: cadastre outra. - Carteira padrão.
POST .../wallets/{walletId}/defaulttroca a padrão (sóapproved). A troca vale depois de um período de carência definido pela CorpX; até lá,defaultEffectiveAtmostra 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.walletOfdiz 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_cryptoestá ligada no tenant (senão,403 feature_disabled). - A credencial tem
p2p.readep2p.trade(ep2p.walletspara cadastrar carteira). - O perfil tem
username. - Há carteira
approvedna rede do par, e ela é a padrão (ou owalletIdvai 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.