Um widget de troca de criptomoedas é um componente de exchange incorporável que permite aos usuários da sua carteira trocar uma moeda por outra sem sair do seu aplicativo. Com um widget de troca não custodial como o da GhostSwap, os fundos são transferidos e nunca ficam retidos pela GhostSwap ou pela sua carteira — a cotação da troca é gerada, o usuário envia e a moeda de destino chega ao endereço dele. Você adiciona cobertura a mais de 1,600 pares sem precisar manter nenhum relacionamento com uma exchange.
Resumindo: Integre a API de swaps do GhostSwap à sua carteira, implemente o fluxo de cotação e envio na sua interface e direcione os usuários para um swap sem KYC e sem custódia. Os usuários finais não precisam de conta; você não precisa de nenhum processo de KYC. A participação nos lucros dos parceiros está disponível na página de parceiros do GhostSwap.
Um widget de troca não custodial é uma interface de câmbio integrada ao aplicativo que cota uma taxa, coleta o endereço de destino do usuário e encaminha a troca por meio de um provedor intermediário — assim, a carteira nunca toca ou retém os fundos diretamente.
O que é um widget de swap não custodial?
Um widget de swap não custodial é um fluxo de swap integrado ao seu aplicativo de carteira que nunca detém a custódia dos fundos do usuário. O usuário solicita uma cotação, envia suas moedas para um endereço de depósito específico para aquele swap e recebe as moedas de saída em seu próprio endereço. O GhostSwap não é custodial — os fundos são transferidos diretamente; eles nunca são retidos pelo GhostSwap ou pelo seu aplicativo de carteira.
Isso é importante para os desenvolvedores de carteiras digitais por três motivos concretos:
- Sem custódia, sem risco de custódia — Seu aplicativo nunca armazena saldos de swaps, portanto não há uma superfície de fundos agrupados para proteger.
- Sem processo KYC — O GhostSwap não exige conta, e-mail ou verificação de identidade dos usuários finais, portanto, você não tem nenhuma sobrecarga de verificação para a própria troca.
- Cobertura completa de criptomoedas a partir de uma única integração. — O GhostSwap suporta mais de 1,600 pares em aproximadamente 200 ativos, abrangendo as redes BTC, ETH, XMR, SOL e altcoins. Você oferece essa variedade sem precisar negociar um relacionamento com uma corretora específica para cada moeda.
A precificação é feita a taxas flutuantes com base na liquidez agregada — o usuário obtém a taxa no momento em que seus fundos chegam, dentro do spread cotado, em vez de uma taxa fixa que pode falhar em caso de derrapagem.
Passo a passo: integre a API de swap do GhostSwap à sua carteira.
Em linhas gerais, a integração de uma carteira segue os mesmos cinco passos, independentemente da plataforma. Leia a referência do endpoint atual na documentação da API do GhostSwap antes de começar a desenvolver — a documentação é a fonte oficial de informações sobre parâmetros, limites de taxa e formatos de resposta.
- Obtenha acesso à API. Solicite as credenciais da API de parceiros através do canal de parceiros do GhostSwap. Isso também o inscreve no programa de compartilhamento de receita (veja abaixo).
- Solicite um orçamento. Chame o endpoint de estimativa com a moeda de entrada, a moeda de saída e o valor. Você receberá como resposta um valor de saída esperado na taxa de câmbio flutuante atual. Exiba isso na interface do seu widget para que o usuário veja o que receberá.
- Crie a troca. Envie o par de entrada/saída e o endereço de destino do usuário. A API retorna um endereço de depósito para essa operação de swap e um ID de ordem para rastreá-la.
- Solicite ao usuário que envie. Sua carteira já contém a moeda inserida pelo usuário, então inicie seu fluxo de envio normal para o endereço de depósito retornado. Os fundos são transferidos sem custódia a partir desse ponto.
- Status da enquete até que esteja concluída. Acompanhe o ID da ordem até que a moeda de saída chegue ao endereço do usuário. O tempo médio de conclusão da troca é de aproximadamente 8 minutos, variando conforme a congestão da rede (percentil 95 próximo de 30 minutos em redes congestionadas).
Como o usuário fornece seu próprio endereço de recebimento e (quando aplicável) um endereço de reembolso, todo o fluxo funciona sem a necessidade de uma conta. Teste a transação de ida e volta com um pequeno valor primeiro — por exemplo, uma troca real de ETH para XMR — antes de implementar o widget em produção.
GhostSwap versus outras APIs de troca sem KYC para integração com carteiras
Ao avaliar um provedor de swap para uma carteira digital, as variáveis que importam são o modelo de custódia, os requisitos de KYC (Conheça Seu Cliente) para os usuários finais, a cobertura de moedas e o tipo de taxa. Veja como o GhostSwap se compara a outros dois provedores sem KYC com programas públicos de afiliados/integração.
| Característica | Troca de fantasmas | Exolix | Deslocamento lateral |
|---|---|---|---|
| Conta de usuário final / KYC | nenhuma ação é necessária | nenhuma ação é necessária | nenhuma ação é necessária |
| Custódia | Passagem não custodial | Sem custódia | Sem custódia |
| Cobertura de moedas | Mais de 1,600 pares (aproximadamente 200 ativos) | Consulte o site do fornecedor. | Consulte o site do fornecedor. |
| Tipo de tarifa | taxa flutuante | Fixo + flutuante | Fixo + flutuante |
| Participação na receita do parceiro | Sim — através do canal de parceiros | Consulte o site do fornecedor. | Consulte o site do fornecedor. |
Os números para Exolix e SideShift não são reproduzidos aqui porque estão sujeitos a alterações; consulte a documentação de cada provedor para obter informações atualizadas sobre cobertura e termos antes de tomar uma decisão. No caso do GhostSwap, a quantidade de mais de 1,600 pares e o modelo sem custódia são referentes ao produto em funcionamento.
Compartilhamento de receita: como os parceiros de carteira ganham com as trocas
Os parceiros de carteira podem ganhar uma parte do spread de swap sobre o volume que encaminham para o GhostSwap. Como o preço é variável e baseado na liquidez agregada, a parte do parceiro é extraída da estrutura de swap, em vez de ser adicionada como uma taxa separada que seus usuários veem discriminada.
As taxas específicas para parceiros dependem do volume e do tipo de integração, portanto, são negociadas diretamente, em vez de serem publicadas como um valor único. Solicite os termos atuais por meio do canal de parceiros do GhostSwap ao provisionar o acesso à API. Configure os dois juntos: uma única etapa de integração garante as credenciais da API e o acordo de compartilhamento de receita.
A vantagem prática para uma carteira: você adiciona um recurso de troca que seus usuários já desejam, não precisa se preocupar com custódia nem com a burocracia do KYC (Conheça Seu Cliente) e transforma o volume de trocas em uma fonte de receita em vez de um custo de suporte.
Armadilhas comuns na integração e como evitá-las
- Definir uma taxa diretamente no código. Taxa flutuante significa que o preço é definido quando os fundos chegam, não quando o usuário clica em "swap". Sempre mostre a estimativa como tal e refaça a cotação se o usuário demorar.
- Ignorando o endereço de reembolso. Para as redes que oferecem esse serviço, colete um endereço para reembolso, para que depósitos não efetuados ou abaixo do valor mínimo possam ser devolvidos. Não presuma que o depósito será sempre processado com sucesso.
- A votação não foi concluída. Exiba o status em tempo real do seu pedido até que o produto seja entregue. A mediana é de aproximadamente 8 minutos, mas a sobrecarga na cadeia de suprimentos pode prolongar esse tempo — ajuste as expectativas do usuário de acordo.
- Testes insuficientes. Cada par tem um mínimo. Teste pequenas trocas reais entre seus pares principais antes do lançamento.
Perguntas frequentes
P: Meus usuários precisam de uma conta ou de KYC para usar o widget de troca?
R: Não. O GhostSwap não exige conta, e-mail ou verificação de identidade para trocas. Seus usuários fornecem apenas um endereço de recebimento e, quando aplicável, um endereço de reembolso.
P: O GhostSwap ou minha carteira retém os fundos durante uma troca?
R: Não. O GhostSwap não é custodial — os fundos são transferidos e nunca retidos pelo GhostSwap. Sua carteira apenas envia a moeda de entrada do usuário para o endereço de depósito da plataforma de swap; a moeda de saída é enviada para o endereço do usuário.
P: Quantas moedas posso oferecer por meio de uma única integração?
A: O GhostSwap suporta mais de 1,600 pares em aproximadamente 200 ativos, incluindo BTC, ETH, XMR e SOL. Uma única integração de API oferece essa cobertura à sua carteira sem a necessidade de negociações individuais com cada corretora.
P: Quanto tempo demora uma troca?
A: O tempo médio de conclusão de uma troca é de cerca de 8 minutos, variando conforme a congestão da cadeia. Em redes congestionadas, a cauda demora mais (p95 próximo de 30 minutos), portanto, o status da ordem é consultado regularmente e apresentado ao usuário.
P: Como funciona o compartilhamento de receita com os parceiros?
A: Os parceiros de carteira podem ganhar uma parte do volume de swaps que encaminham. As taxas dependem do volume e do tipo de integração e são definidas quando você provisiona o acesso à API — entre em contato com o canal de parceiros do GhostSwap para obter os termos atuais.
Comece a construir
Se você estiver adicionando swaps a uma carteira, comece pela documentação da API do GhostSwap e, em seguida, teste o fluxo com um par ativo, como BTC para XMR, ou faça uma cotação pelo widget de swap na página inicial para ver o fluxo de cotação e envio de ponta a ponta.