Um widget de troca de criptomoedas é um componente integrado de interface do usuário e API que permite aos usuários da sua carteira trocar uma moeda por outra sem sair do seu aplicativo. O widget é renderizado dentro da sua carteira; uma API de backend cota a taxa, gera um endereço de depósito e liquida a troca. No GhostSwap, a integração não exige KYC (Conheça Seu Cliente) para seus usuários finais — você não passa nenhum requisito de identidade para eles — e não é custodial, portanto, os fundos são transferidos e nunca são retidos pelo GhostSwap ou pelo seu aplicativo.
Resumindo: você chama a API do GhostSwap para obter uma taxa, criar uma troca e receber um endereço de depósito; seu aplicativo exibe o widget, o usuário envia as moedas e a API retorna o status da liquidação via webhook. Sem necessidade de conta, sem KYC para os usuários finais, mais de 1,600 moedas.
Um widget de troca é um recurso de carteira que permite ao usuário trocar moedas dentro do aplicativo. Ele combina uma pequena interface (valor, moedas de origem/destino, endereço de recebimento) com uma API de troca no backend que lida com cotações, roteamento e liquidação.
O que é um widget de troca e por que as carteiras o incluem?
Um widget de troca transforma uma carteira de um único ativo ou de múltiplos ativos em um local onde os usuários também podem converter entre moedas — BTC para XMR, SOL para ETH — sem precisar enviar fundos para uma corretora externa primeiro. A carteira fornece a interface; uma API de troca fornece a liquidez e a liquidação.
Os desenvolvedores de carteiras digitais incorporam uma taxa de integração por dois motivos. Primeiro, retenção: um usuário que pode realizar trocas dentro do aplicativo não tem motivos para recorrer a uma corretora centralizada. Segundo, receita: cada troca pode gerar uma taxa de integração, de forma que a carteira lucre por transação, em vez de apenas nos planos premium.
A questão da ausência de KYC (Conheça Seu Cliente) é especialmente importante para desenvolvedores de carteiras digitais. Se o seu provedor de swaps exige verificação de identidade do usuário final, essa obrigação de conformidade recai sobre seus usuários e, indiretamente, sobre você. Uma API de swaps sem KYC limita a integração a um endereço de recebimento e um depósito — nenhum dado de identidade é transmitido pelo seu aplicativo. O GhostSwap é uma exchange de criptomoedas sem KYC: não é necessário criar uma conta, usar um e-mail ou verificar sua identidade para realizar swaps.
Passo a passo: integre a API do GhostSwap ao seu aplicativo
A integração consiste em quatro chamadas à API, além da renderização de um widget. Consulte a referência da API do GhostSwap para obter detalhes sobre os endpoints e a autenticação.
- Obter uma chave de API — Solicite uma chave de integrador. Isso identifica seu aplicativo para cotação de tarifas e, se habilitado, para atribuição de compartilhamento de receita.
- Obter uma taxa — Ligue para o ponto de extremidade de cotação com
from,toe valor. O GhostSwap retorna uma estimativa de taxa flutuante calculada a partir da liquidez agregada dos principais mercados de criptomoedas. Taxa flutuante significa que o preço é definido quando os fundos do usuário chegam, não quando ele clica — normalmente dentro do spread cotado. - Crie a troca — Envie o par de moedas, o valor e o endereço de recebimento do usuário. A API retorna um endereço de depósito exclusivo para essa troca. Os fundos são transferidos sem custódia — o GhostSwap nunca os retém.
- Renderize o widget — Mostre o endereço de depósito (e um código QR) na interface da sua carteira para que o usuário possa enviar fundos do saldo do aplicativo com um único toque.
- Acompanhe a liquidação via webhook — Registre um URL de webhook. O GhostSwap publica atualizações de status (aguardando, confirmando, trocando, concluído) para que seu aplicativo possa atualizar a interface do usuário sem precisar ficar consultando o status repetidamente.
O tempo médio de conclusão de uma troca é de cerca de 8 minutos, com um percentil 95 de aproximadamente 30 minutos quando a cadeia está congestionada — deixe essa expectativa visível no seu widget para que os usuários não sejam surpreendidos pela lentidão.
Compartilhamento de receita: como os parceiros da carteira ganham por troca
Os integradores de carteiras digitais podem ganhar uma parte da taxa de swap em cada transação roteada por meio de seu aplicativo. Como a atribuição está vinculada à sua chave de API de integrador, você não precisa de uma camada de rastreamento separada — os swaps gerados pelo seu widget são contabilizados automaticamente.
Algumas dicas práticas para desenvolvedores:
- A receita é acumulada por cada troca concluída, não por cotação ou por fluxo abandonado.
- As transações de maior valor geram proporcionalmente mais, portanto, as carteiras que atendem usuários avançados tendem a apresentar retornos mais expressivos por transação.
- Como o fluxo não é custodial e não exige KYC (Conheça Seu Cliente) para os usuários finais, não há funil de integração que possa resultar em perda de conversões — o usuário realiza a troca de dispositivo na mesma sessão em que abre o widget.
Para obter os termos exatos de compartilhamento de taxas, solicite-os juntamente com sua chave de API — eles não são publicados como um número público fixo.
API GhostSwap vs SimpleSwap vs SideShift — comparação de recursos
Todas as três oferecem trocas programáticas para integradores. As diferenças que importam para um desenvolvedor de carteiras são o KYC do usuário final, o modelo de custódia e a cobertura de criptomoedas. Os dados abaixo foram extraídos dos materiais públicos de cada provedor e consultados em 28/07/2026.
| Característica | API GhostSwap | Troca Simples | Deslocamento lateral |
|---|---|---|---|
| KYC do usuário final | nenhuma ação é necessária | Nenhuma exigência para trocas padrão | nenhuma ação é necessária |
| Custódia | Passagem não custodial | Consulte os termos do fornecedor. | Consulte os termos do fornecedor. |
| Suporte para moedas | 1,600+ moedas | Declarado publicamente no site do fornecedor | Declarado publicamente no site do fornecedor |
| Tipo de tarifa | Flutuante (liquidez agregada) | Flutuante e fixa | Flutuante |
| Participação na receita do integrador | Sim, por troca concluída. | Programa de afiliados | Programa de afiliados/API |
| atualizações de liquidação de webhook | Sim | Consulte a documentação da API. | Consulte a documentação da API. |
Antes de se comprometer, confirme os termos e condições atuais de cada concorrente em relação à documentação deles, pois as políticas dos provedores mudam. O GhostSwap não é um serviço financeiro registrado; verifique de forma independente as normas de conformidade aplicáveis à sua jurisdição e aos seus usuários.
Requisitos técnicos: chave de API, fluxo de troca, suporte a webhook
Para enviar um widget funcional, você precisa de:
- Uma chave de API de integração — para autenticação e atribuição de receita.
- Um fluxo de citação seguida de criação — Obtenha uma estimativa da taxa flutuante e, em seguida, crie a operação de swap para obter um endereço de depósito. Não armazene as cotações em cache; busque-as novamente antes de cada swap, pois a taxa é flutuante.
- Um endereço de recebimento por troca. — Seu aplicativo coleta o endereço de destino do usuário (e, para algumas redes, um memorando ou etiqueta de destino). Passe-o para a chamada de criação.
- Manipulação de webhooks — um endpoint HTTPS público para receber callbacks de status, para que sua interface de usuário reflita a liquidação em tempo quase real.
- Manipulação de borda específica da cadeia — Alguns ativos exigem uma descrição ou etiqueta de destino. Se o seu widget for compatível com essas moedas, colete o campo adicional, caso contrário, os fundos podem ser enviados para o nó correto, mas para a conta errada.
Essa é toda a superfície. Os documentos de referência da API descrevem os endpoints e parâmetros; um teste funcional com uma pequena troca de BTC para XMR no par BTC/XMR é a maneira mais rápida de validar sua integração de ponta a ponta.
Perguntas frequentes
P: Meus usuários precisam criar uma conta ou concluir o processo KYC para usar o widget de troca?
R: Não. O GhostSwap não exige conta, e-mail ou verificação de identidade para realizar trocas. Seus usuários fornecem um endereço de recebimento e enviam fundos; nenhuma outra informação é coletada deles por meio do seu aplicativo.
P: O sistema de swaps é custodiado — o GhostSwap ou meu aplicativo detém os fundos dos usuários?
R: Não. As trocas são transações diretas e sem custódia. Os fundos são encaminhados pelo mecanismo de troca e liquidados no endereço de recebimento do usuário; eles nunca são retidos pelo GhostSwap ou pelo seu aplicativo de carteira.
P: Quantas moedas posso oferecer através da API?
A: Mais de 1,600 moedas, incluindo BTC, ETH, XMR, SOL e outras redes de altcoins, estão acessíveis via API. Você pode exibir a lista completa ou restringir o widget aos pares suportados pela sua carteira.
P: Taxa flutuante ou taxa fixa — qual delas a API retorna?
A: Preços flutuantes baseados na liquidez agregada. O preço é definido quando os fundos do usuário chegam, normalmente dentro do spread cotado, em vez de ser fixado no momento do clique. A cotação é atualizada antes de cada swap.
P: Quanto tempo demora uma troca e como meu aplicativo sabe quando ela terminou?
A: O tempo médio de conclusão é de cerca de 8 minutos; o percentil 95 é de aproximadamente 30 minutos em condições de congestionamento na cadeia. Registre um webhook e o GhostSwap enviará atualizações de status até a liquidação, para que sua interface do usuário possa refletir o progresso sem a necessidade de sondagem constante.
Início
Se você estiver criando uma carteira e quiser uma troca integrada ao aplicativo que não adicione nenhuma verificação KYC aos seus usuários, comece com a referência da API do GhostSwap e valide o fluxo com uma troca de BTC para XMR ou de SOL para XMR.
Tem dúvidas sobre a integração? A referência da API é o ponto de partida ideal.
