Pular para o conteúdo principal

Compra e Venda de Cripto

A empresa tem saldo em reais (BRL) na XGate. Com a API ela compra USDT ou USDC usando esse saldo, e a XGate envia a cripto para a carteira que a empresa indicar (declarada como dela).

Para vender, a empresa envia USDT/USDC para um endereço fixo que a XGate dá a ela (um por rede); cada envio confirmado vira uma venda e o valor em reais cai no saldo ou vai por Pix para um beneficiário aprovado, conforme a configuração da empresa no painel.

Sem custódia de cripto

Não existe saldo cripto na XGate: o que a empresa compra vai direto para a carteira dela. O customer da empresa não aparece em nenhuma ponta da compra ou da venda.

Ativos e redes​

AtivoRedes
USDTPOLYGON, ETHEREUM, TRON, SOLANA
USDCPOLYGON, ETHEREUM, SOLANA

Fluxo de compra​

  1. Consulte as opções: GET /crypto/options mostra ativos, redes, taxas, limites e endereços salvos.
  2. Cote (opcional): POST /crypto/quotes garante o preço por 30 segundos. Para só mostrar um valor aproximado, use POST /crypto/quotes/estimate.
  3. Compre: POST /crypto/purchases com a cotação ou a mercado. O BRL é debitado do saldo.
  4. Acompanhe: Consultar Compra ou os webhooks de compra (aba Webhooks › Compras Cripto Webhook), até DELIVERED (cripto confirmada na rede) ou REJECTED (BRL devolvido ao saldo).

Fluxo de venda​

  1. Pegue os endereços: o bloco sale de GET /crypto/options traz o endereço fixo da empresa para cada ativo e rede.
  2. Envie a cripto: cada envio confirmado na rede para esse endereço vira uma venda. Veja Vender Cripto.
  3. Acompanhe: Consultar Venda ou os webhooks de venda (aba Webhooks › Vendas Cripto Webhook), até SETTLED ou SETTLED_TO_BALANCE.

Rotas antigas de cripto​

As rotas antigas de cripto (carteira do customer, depósito com conversão, saque cripto e saque com conversão) deixam de funcionar em 30/10/2026, às 00:00 (horário de Brasília). A tabela abaixo mostra o que usar no lugar:

AntesAgora
Depósito Pix com cryptocurrency (conversão)Depósito Pix em BRL + POST /crypto/purchases com o saldo
Saque cripto para carteira externaPOST /crypto/purchases: a cripto vai para uma carteira da empresa
Saque USDT/USDC → PixSem substituto: a empresa não tem mais saldo cripto na XGate
Carteira de custódia do customerSem substituto: a XGate não guarda cripto