API de troca de criptomoedas com compartilhamento de receita para parceiros de carteira.

Uma API de troca de criptomoedas permite que uma carteira, exchange ou produto fintech ofereça conversões entre criptomoedas sem operar sua própria infraestrutura de liquidez, custódia ou conformidade. O integrador envia a criptomoeda de origem, a criptomoeda de destino e o endereço de recebimento do usuário para a API; o provedor define uma taxa, gera um endereço de depósito, monitora o depósito e encaminha o ativo convertido para o destino. O integrador nunca lida com os fundos.

Resumindo: A API GhostSwap expõe o mesmo mecanismo de troca não custodial que alimenta o ghostswap.io — mais de 1,600 pares em mais de 200 ativos suportados, preços flutuantes e liquidação p50 em cerca de 8 minutos — com um modelo de compartilhamento de receita para carteiras que direcionam volume por meio dela.

Uma API de troca de criptomoedas é uma interface REST/JSON que realiza trocas entre moedas de forma programática. Ao contrário de uma API de exchange (que pressupõe que o usuário tenha uma conta e saldo na exchange), uma API de troca trata cada transação como uma conversão única e sem custódia: depósito, troca e saque.

Por que as carteiras integram uma API de troca em vez de criar uma?

Criar seu próprio mecanismo de troca significa buscar liquidez, gerenciar o risco de estoque, construir o roteamento de ordens em plataformas centralizadas e descentralizadas e operar em conformidade com os requisitos de cada uma dessas plataformas. Para uma equipe de carteira focada na experiência do usuário, essa é a batalha errada.

Uma API de swap simplifica todo esse processo em algumas chamadas HTTP. Seus usuários recebem swaps diretamente na carteira; você obtém uma fonte de receita que não existia antes; e o provedor de swap absorve a complexidade operacional. Esse é o mesmo padrão que diversas carteiras nativas do Monero têm usado para oferecer conversões diretas de BTC, ETH ou stablecoins para XMR — Feather Wallet (desktop) e Monerujo (Android) são exemplos frequentemente citados de carteiras que publicaram integrações de swap de terceiros em suas notas de lançamento.

A contrapartida é simples: você abre mão do controle direto da dinâmica econômica dos swaps em troca de não precisar criá-la. Um programa de compartilhamento de receita bem estruturado é o que fecha esse ciclo.

Como a API do GhostSwap funciona de ponta a ponta

1. GET /v1/pairs — Listar os mais de 1,600 pares suportados. Filtrar por ativo de origem ou destino.
2. GET /v1/rate?from=BTC&to=XMR&amount=0.05 — Obtenha uma cotação de taxa flutuante. As cotações são indicativas; a taxa final é definida no momento em que o depósito do seu usuário for confirmado.
3. POST /v1/swap — criar uma troca. Você fornece from, to, amount, destination_address, e um opcional refund_addressA resposta contém um endereço para depósito único.
4. O usuário envia o depósito. A interface da sua carteira exibe o endereço, o código QR e o valor estimado a receber.
5. GET /v1/swap/{id} — pesquisa de status. O ciclo de vida é awaiting_deposit → received → exchanging → sending → complete.
6. Os fundos chegam ao endereço de destino do usuário. O tempo típico de estabilização de ponta a ponta é de aproximadamente 8 minutos para p50 e 30 minutos para p95.

Não há etapa de criação de conta para o usuário final, nem KYC (Conheça Seu Cliente), nem e-mail — o integrador autentica com uma chave de API e o usuário fornece apenas o endereço de destino.

Como o GhostSwap se compara a outras APIs de troca?

A comparação é descritiva, não avaliativa. Os parceiros devem verificar os números atuais no site de cada fornecedor antes de assinar o contrato.

O modelo de partilha de receitas com os parceiros

A GhostSwap devolve uma parte da receita de swaps para carteiras e aplicativos integrados. Essa porcentagem varia de acordo com o volume mensal roteado — volumes maiores recebem uma porcentagem maior. Os pagamentos são feitos mensalmente na moeda escolhida pelo parceiro, dentre os ativos suportados (normalmente BTC, ETH, USDT ou XMR).

Três observações práticas para avaliar o programa:

1. A atribuição é feita com base na chave da API. Cada troca criada com sua chave de parceiro é atribuída a você durante toda a duração dessa troca. Não há período de espera para cookies nem fragilidade nos links de referência.
2. Você define a taxa visível para o usuário. Os parceiros podem adicionar uma margem de lucro à tarifa cotada; essa margem é acumulada para o parceiro além da participação na receita base.
3. Não é necessário contrato de exclusividade. Você pode executar o GhostSwap juntamente com outros provedores e rotear por par com base em qual oferece a melhor taxa para seus usuários.

GhostSwap não é um serviço financeiro registrado. O programa de parcerias é uma integração comercial; os parceiros são responsáveis ​​por suas próprias obrigações jurisdicionais.

Quando a API GhostSwap é a solução ideal

É a opção ideal se:

• Você opera uma carteira não custodial e deseja realizar trocas dentro do aplicativo sem reter os fundos do usuário.
• Seus usuários se preocupam em não precisar criar contas ou enviar documentos de identidade para trocas rotineiras.
• Você quer uma API única que abranja BTC, ETH, XMR, LTC, stablecoins e mais de 1,600 combinações de pares — não apenas EVM para EVM.
• É melhor obter uma linha de receita do que construir infraestrutura de liquidez.

Não é a opção ideal se:

• Você precisa de opções de conversão de moeda fiduciária dentro da mesma chamada de API (GhostSwap é de criptomoeda para criptomoeda).
• Você precisa de cotações com taxa fixa, definidas no momento da cotação (o GhostSwap tem taxa flutuante; a taxa é definida quando o depósito é confirmado).
• Sua jurisdição ou produto exige que você faça o KYC (Conheça Seu Cliente) de todos os usuários de swap — essa é uma camada que você construiria sobre ela, não abaixo dela.

Perguntas frequentes

P: Como funciona o modelo sem KYC para o integrador de API?
A: O usuário final fornece um endereço de recebimento; o GhostSwap encaminha a transação de forma não custodial e nunca retém os fundos. O integrador se autentica com uma chave de API. Nem o usuário nem o integrador enviam documentos de identidade ao GhostSwap para operações de swap.

P: Quais são os prazos típicos de liquidação?
A: De acordo com a telemetria atual do produto, o p50 leva cerca de 8 minutos de ponta a ponta e o p95 leva cerca de 30 minutos. Os tempos dependem dos requisitos de confirmação da cadeia de origem — os depósitos em Bitcoin herdam os tempos de confirmação do Bitcoin.

P: Como é calculada a participação na receita?
R: É uma porcentagem da receita de swaps do GhostSwap em transações atribuídas à sua chave de API, paga mensalmente. A discriminação exata dos níveis é compartilhada durante o processo de integração de parceiros. Os parceiros também podem adicionar sua própria margem de lucro além da taxa cotada.

P: Posso usar a API para criar uma interface de exchange completa sem KYC?
R: Sim. A API abrange descoberta de pares, cotação, criação de swaps e consulta de status — o suficiente para alimentar uma interface de usuário completa para swaps. Muitos parceiros incluem uma aba de swaps em uma carteira existente, em vez de uma exchange independente.

P: A API está documentada publicamente?
A: Sim — veja a referência da API GhostSwap Para endpoints, parâmetros, formatos de resposta e exemplos de payloads.

Início

Se você estiver avaliando APIs de swap para integração com uma carteira ou aplicativo, o caminho mais rápido é ler a referência da API e testar uma troca usando o mecanismo de swap em tempo real na página inicial para ver o fluxo de usuário final que sua integração produzirá.

Para obter informações sobre os termos da parceria, entre em contato através da página de contato.