Skip to navigation

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.

POST advertiser-requests CorpX aprova (com nível) CorpX recusa novo pedido CorpX suspende CorpX reativa none pending approved refused suspended

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:

CampoRegra
sidesell (o anunciante vende cripto) ou buy (compra). Não muda depois.
pairUm par ligado no mercado (GET /v1/p2p/pairs). Não muda depois.
priceModespread (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.
spreadBpsNo 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.
fixedPriceNo 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.
offsetNo 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.
stockAmountQuanto de cripto o anúncio oferece (ou quer comprar).
minAmount, maxAmountLimites 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.
deliveryDeadlineMinPrazo de entrega prometido, dentro da faixa do mercado.
walletIdCarteira aprovada na rede do par (no anúncio sell, a de origem da cripto).
instructionsAté 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

POST ads dono pausa oupausa automática (pausedReason) dono religa dono fecha dono fecha active paused closed
pausedReasonMotivo
pair_disabledA CorpX desligou o par no mercado.
advertiser_suspended, advertiser_refusedO anunciante perdeu a aprovação.
wallet_removedA carteira do anúncio foi removida.
insufficient_balanceAnúncio buy sem saldo para bloquear uma ordem tomada.
staff_suspendedA CorpX suspendeu o anúncio.
cashout_lockedAnú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 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úncioQuem anunciaQuem paga a taxaComo sai
sellVendedorVendedorO vendedor recebe o valor cheio e a taxa é debitada da conta dele logo depois.
buyCompradorCompradorO 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.