MoneroSwapper: Monero Swap API e Afiliados em BTC 2026

Um usuário da sua carteira troca 0,5 BTC por XMR direto na tela de swap dentro do app. A transação liquida, a MoneroSwapper fica com a margem de provedor, e entre 0,3% e 1,5% daquele volume — algo como US$ 30 a US$ 150 em Bitcoin a preços atuais — cai no seu saldo de afiliado em segundos. Sem KYC, sem nota fiscal, sem prazo de 30 dias para receber. Multiplique isso por algumas centenas de swaps mensais vindos de uma carteira com atividade moderada e a Monero swap API para devs de carteira deixa de ser um item de checklist e vira uma linha real de receita na sua planilha.

Este guia é para quem efetivamente escreve código de carteira: engenheiros mobile, mantenedores de desktop, autores de extensão de navegador, devs de bot do Telegram e os indie hackers construindo o próximo app de custódia voltado à privacidade. A tese é simples. Em 2026, Monero (XMR) é um dos ativos mais pedidos e menos suportados nas carteiras de consumidor. Se você consegue oferecer um swap limpo para XMR dentro da sua carteira — sem empurrar o usuário para uma exchange centralizada que talvez nem liste mais o ativo — você resolve um problema de retenção e transforma cada swap em uma comissão denominada em Bitcoin no mesmo movimento. A MoneroSwapper existe para fazer essa integração caber em uma tarde, e não em uma sprint inteira.

Por que devs de carteira precisam de uma Monero swap API em 2026

O contexto de mercado do XMR mudou de forma dura nos últimos dois anos, e qualquer time de carteira que esteja planejando o roadmap de 2026 precisa levar isso em conta. Várias grandes exchanges centralizadas deslistaram a Monero ou bloquearam o ativo por geolocalização em jurisdições importantes, citando pressão regulatória sobre privacy coins. Os usuários que já têm ou querem ter XMR estão sendo cada vez mais empurrados para caminhos não custodiais: marketplaces P2P, atomic swaps e APIs de swap embarcadas nas carteiras em que já confiam.

Essa migração é uma notícia boa e ruim ao mesmo tempo para devs de carteira. Boa: os holders estão ativamente procurando trilhos de swap não custodiais, e a carteira que entregar a melhor experiência de XMR dentro do app captura uma atenção desproporcional. Ruim: construir esses trilhos por conta própria — rodar liquidez, fazer hedge de estoque, integrar order books e sobreviver à ambiguidade regulatória das privacy coins — é trabalho para uma empresa inteira, não para uma feature.

É exatamente esse gap que uma Monero swap API fecha. Em vez de construir o motor de swap, você chama um endpoint REST, renderiza uma cotação, deposita a moeda de origem do usuário em um endereço gerado dinamicamente e deixa o provedor cuidar de roteamento, liquidez e liquidação. Do ponto de vista do usuário, ele tocou em "Trocar por XMR" e recebeu XMR. Do seu ponto de vista, você entregou uma feature que seria praticamente inviável para um time pequeno e abriu um canal de comissão no mesmo passo. A Monero swap API para devs de carteira, bem feita, é daquelas integrações raras em que ganho de engenharia e ganho de negócio apontam para a mesma direção.

Tem ainda um lado de retenção. Carteira vive ou morre pela porcentagem de usuários que continuam com o app instalado depois da quarta semana. Toda vez que alguém precisa sair da sua carteira para fazer swap em uma exchange — copiar endereço, enviar fundos, esperar, sacar, colar — você perde a sessão, e estatisticamente parte desses usuários simplesmente não volta. Um swap dentro do app que cota em dois segundos e liquida em uma única confirmação é uma das features de retenção mais impactantes que você pode entregar, e ela se paga sozinha.

Como funciona a API da MoneroSwapper

A MoneroSwapper expõe uma API REST não custodial pensada para ser embarcada dentro de uma carteira, não para uma interface de exchange independente. O modelo mental é de um broker de swap: seu app pede uma cotação, o usuário confirma, seu app mostra um endereço de depósito de uso único, o usuário envia o valor, o provedor roteia a ordem entre fontes de liquidez e a moeda de destino chega no endereço do usuário. Em nenhum momento a MoneroSwapper mantém conta de usuário, exige KYC ou assume custódia além do swap em andamento.

A superfície de endpoints é intencionalmente enxuta. get_pairs retorna a lista de pares de origem e destino suportados, então você só renderiza o que de fato é swappable naquele momento. get_estimate recebe um par mais o valor e devolve cotação, taxas e o mínimo de rede. create_exchange recebe a cotação, o endereço de destino do usuário e seu token de afiliado, e devolve um endereço de depósito junto com um order ID. get_status consulta esse order ID e retorna um dos poucos estados possíveis — waiting, confirming, exchanging, sending, finished ou failed — para você montar uma UI de progresso limpa. A integração inteira são essas quatro chamadas, mais o que você quiser fazer em torno de estados de erro.

Três propriedades importam especificamente para devs de carteira. Primeira: são mais de 1.700 moedas suportadas, então a mesma integração que te dá swaps de XMR também te dá BTC, ETH, USDT (em várias redes), LTC, BCH, SOL e a long tail toda. Você entrega uma única tela de swap, cobre a lista de ativos que o usuário realmente quer, e o Monero vira um par carro-chefe em vez de uma integração isolada. Segunda: o fluxo é não custodial de ponta a ponta — os fundos do usuário tocam um endereço de depósito amarrado àquele pedido específico, não uma carteira agrupada, e chegam no endereço de destino do próprio usuário. Terceira: o gancho de afiliado está na mesma chamada de criação do swap. Você passa o identificador de afiliado em create_exchange e a comissão é atribuída automaticamente — não tem API de receita separada para integrar nem para conciliar.

O cadastro é gratuito, leva cerca de trinta segundos e é no-KYC. Você informa um e-mail, confirma, recebe um token de afiliado e um link de indicação. A partir desse momento sua conta já consegue atribuir swaps e acumular comissão. Não tem análise de cadastro, não tem mínimo de tráfego, não tem exclusividade e não tem negociação de contrato. Se sua carteira está no TestFlight com 50 usuários, você pode integrar hoje; se tem 500 mil ativos diários, também pode integrar hoje; o programa trata os dois do mesmo jeito.

Você ainda tem dois caminhos de integração e pode usar os dois. O link de indicação é uma URL pronta para copiar e colar com seu token de afiliado embutido — coloque na documentação, nas respostas de suporte, na bio do X (Twitter), na descrição do YouTube. Todo swap originado a partir desse link credita sua conta. A integração completa via API é o caminho dentro da carteira descrito acima, em que o swap acontece dentro da sua UI e a comissão é atribuída pelo parâmetro de afiliado em create_exchange. A maioria dos times de carteira mais sérios acaba rodando os dois: o link cobre tráfego passivo de blog posts e changelogs, a API cobre swaps ativos dentro do app. Eles não competem; eles se somam.

Estrutura de comissão — quanto você realmente ganha

Cada swap concluído paga uma comissão de 0,3% a 1,5% do volume swapado, denominada em Bitcoin, enviada para um endereço BTC que você controla. A alíquota exata depende do par e das condições atuais de mercado; pares com XMR ficam na faixa mais alta da banda porque a rota envolve uma liquidez mais sofisticada. A comissão é creditada em tempo real no instante em que o swap atinge o estado finished, não em ciclo semanal ou mensal, e um dashboard em tempo real mostra o total corrente junto com o detalhamento por ordem, que pode ser exportado.

O pagamento mínimo é de 0,0001 BTC — pequeno o suficiente para que poucos swaps concluídos já passem do piso — e não existe teto de ganhos mensais. Se sua carteira gera US$ 1.000 ou US$ 10 milhões em volume mensal de swap, vale o mesmo percentual por swap e o mesmo crédito instantâneo. O programa não estrangula quem fatura muito e não impõe pisos de volume que penalizariam o dev indie começando do zero.

Dois pontos para quem pensa como engenheiro. Primeiro: o pagamento em BTC importa mais do que parece. Uma comissão denominada em BTC e creditada na hora da conclusão do swap é, na prática, uma posição comprada em Bitcoin acumulada um swap por vez, sem você precisar pensar em gestão de tesouraria nem em timing de conversão para fiat. Segundo: o crédito em tempo real muda a sensação do dashboard. Você consegue rodar um swap, atualizar a página e ver a comissão já no saldo. Para quem está acostumado com programas de afiliado de cookie de 60 dias e fechamento trimestral, essa diferença de latência reposiciona a integração como parte do produto, e não como um apêndice de marketing.

O modelo de receita mais limpo para uma carteira é aquele em que toda ação bem-sucedida do usuário também gera margem. Um swap de XMR dentro do app movido por uma API de afiliado por volume é exatamente isso — o usuário recebe a feature pela qual veio, você recebe uma comissão denominada em Bitcoin creditada no momento em que o swap finaliza, e nenhuma das duas pontas troca privacidade por conveniência.

Padrões de integração para carteiras mobile, desktop, navegador e Telegram

Os quatro formatos comuns de carteira impõem restrições que vale considerar antes de começar a escrever código. Abaixo está um recorte prático de como integrar a Monero swap API para devs de carteira em cada ambiente, com as pegadinhas que os times normalmente encontram.

Carteiras mobile (iOS / Android). As duas armadilhas aqui são polling em background e o manejo do clipboard. Use get_estimate com um debounce curto enquanto o usuário digita o valor, e depois congele a cotação no momento de chamar create_exchange para ele não ser pego por uma taxa pior na hora de confirmar. Para get_status, faça polling a cada 5 a 10 segundos enquanto a tela de swap estiver em foreground, e troque para uma checagem única acionada por push quando o app for para o background — bateria e rate limit agradecem. Mostre o endereço de depósito como QR e como botão de copiar, e pré-selecione a rede quando a chain de destino tiver várias representações. Destaque no onboarding o ângulo do "swap grátis" subsidiado pelo afiliado: uma carteira que ganha silenciosamente em cada swap pode cobrar zero do usuário e ainda assim ser lucrativa, o que é uma vantagem competitiva difícil de bater.

Carteiras desktop. O usuário de desktop tende a fazer swaps maiores e se importa mais com controle fino de taxa. Renderize a taxa por rede e o spread do provedor separadamente na tela de cotação — usuário sofisticado vai conferir, e essa transparência constrói confiança. Faça cache do get_pairs no boot do app e atualize a cada hora; isso deixa a UI de swap parecer instantânea mesmo antes da chamada de rede retornar. Se você suporta hardware wallet, roteie a transação de depósito pelo mesmo fluxo de assinatura usado para envios, tratando o endereço do swap como apenas mais um destino. Aí o swap "parece nativo" em vez de parecer um fluxo web embarcado.

Extensões de navegador. Extensão vive e morre pelo tamanho do bundle, então isole o módulo de swap atrás de um dynamic import e só carregue quando o usuário abrir a aba de swap. Use a integração via link de indicação como fallback para qualquer par ou jurisdição que o fluxo interno não suporte — em vez de mostrar "não suportado", abra uma nova aba com a URL de indicação e o par pré-selecionado. Você continua ganhando comissão, o usuário continua fazendo o swap e sua extensão continua leve. Cuidado em expor o token de afiliado para o contexto da página; mantenha as chamadas de API dentro do service worker de background.

Carteiras e bots do Telegram. O Telegram é onde os devs de carteira mais subestimam o teto de receita. Fluxos com inline buttons convertem absurdamente bem porque tiram o atrito de navegar para outro app. Um bot que aceita o usuário digitar /swap 0.1 btc xmr, responde com uma cotação e oferece um único botão "Confirmar" pode rotear um volume surpreendente — especialmente em regiões onde o Telegram é o app de mensagens dominante (e o Brasil tem uma comunidade cripto bem ativa por lá). Use a API do mesmo jeito que no mobile, mas renderize o endereço de depósito como um bloco de código clicável e copiável; quem usa pelo celular vai agradecer o copy em um toque só.

Nos quatro formatos há um princípio de design que dobra a sua conversão: cotação primeiro, cadastro nunca. Mostre a taxa para o usuário antes de pedir qualquer coisa. Ele veio para fazer swap, não para ler copy de marketing. As carteiras que mais crescem tratam o swap como uma primitiva — igual a enviar e receber — e a receita de afiliado vai se acumulando silenciosamente embaixo.

Passo a passo: cadastro mais a primeira integração nesta semana

Aqui está a sequência real para sair do zero e chegar ao seu primeiro swap comissionado em uma semana, com estimativas de tempo realistas para um dev sozinho.

Dia 1, manhã — cadastro e orientação (cerca de uma hora). Vá à página do programa de afiliados da MoneroSwapper, cadastre-se com um e-mail, confirme e pegue seu token de afiliado no dashboard. Já aproveite e cadastre um endereço BTC de pagamento. Leia a referência da API de ponta a ponta; é curta o bastante para absorver em uma sessão. Faça um curl descartável contra get_pairs para confirmar que seu token funciona.

Dia 1, tarde — protótipo de cotação (duas a três horas). Na stack que sua carteira já usa, escreva uma única função que chama get_estimate com um par fixo de BTC para XMR e imprime a cotação. Embrulhe isso em uma UI mínima — um campo de texto para o valor, um label para a saída estimada, um botão de refresh. O objetivo é confirmar que o encanamento de rede funciona dentro do seu ambiente de build, incluindo eventuais caprichos de TLS ou proxy específicos da plataforma.

Dia 2 — o happy path completo (meio dia). Ligue create_exchange com seu token de afiliado. Renderize o endereço de depósito retornado como texto e como QR code. Implemente um loop de polling em get_status. Dirija uma UI de quatro etapas: aguardando depósito, confirmando na chain de origem, trocando, enviado. Teste ponta a ponta com um swap real pequeno. Olhe seu dashboard de afiliado. A comissão aparece em tempo real. Esse momento — ver sua primeira comissão em BTC creditada por um swap que nasceu do código que você acabou de escrever — é a prova de conceito que transforma um "talvez depois" em compromisso de roadmap.

Dia 3 — estados de erro e edge cases (meio dia). Construa a UI dos caminhos infelizes. Depósito abaixo do mínimo. Depósito acima do máximo. Estado de espera com timeout. Estado de falha/reembolso. Cada um deles é um único status code; expô-los com clareza é o que separa um swap em que o usuário confia de outro em que não.

Dia 4 — cobertura de pares e roteamento (meio dia). Saia do par fixo BTC-XMR e vá para um seletor de par dinâmico apoiado em get_pairs. Adicione o sentido inverso (XMR para qualquer coisa), porque ele é tão comum quanto. Ordene a lista de ativos pelo uso real na sua carteira para maximizar relevância.

Dia 5 — lançamento atrás de feature flag (meio dia). Libere a tela de swap para 5% a 10% dos usuários atrás de uma flag remota. Olhe o dashboard. Se a comissão acumula e as reclamações não, escale para 100% na semana seguinte. Se algo parecer estranho, dá para desligar com um clique. O arco inteiro, do cadastro até o rollout em camadas, cabe em uma semana útil. A maior parte dos times descobre que a integração é a parte fácil; decidir quais ativos destacar na UI demora mais do que escrever o código da API.

Perguntas frequentes

Eu ou meus usuários precisamos de KYC para usar a swap API ou o programa de afiliados?

Não. O cadastro como afiliado é gratuito e no-KYC — você fornece um e-mail, escolhe um endereço de pagamento e em uns trinta segundos já tem um token de afiliado. O próprio fluxo de swap também é no-KYC para o usuário final no caso padrão; o usuário envia a moeda de origem para um endereço de depósito gerado e recebe a moeda de destino no endereço que ele especificou. O provedor pode marcar transações incomuns conforme a política de risco, mas não há conta, não há upload de documento de identidade e não há onboarding estilo exchange para o usuário final.

Quanto eu realmente posso ganhar como dev de carteira?

A comissão é de 0,3% a 1,5% do volume por swap concluído, paga em BTC. Não tem mínimo nem teto. Uma carteira que roteia US$ 10.000 de volume mensal ganha algo entre US$ 30 e US$ 150 em BTC; em US$ 1.000.000 fica em torno de US$ 3.000 a US$ 15.000. Os números reais dependem da composição de ativos, da distribuição de tamanho dos swaps e de onde cada par se posiciona dentro da faixa percentual. O programa não garante renda específica — os ganhos escalam junto com o volume de swap que sua carteira realmente gera.

Quando e como eu recebo?

A comissão é creditada em tempo real no instante em que o swap atinge o estado finished — não em ciclo semanal nem mensal. Os pagamentos são denominados em Bitcoin e enviados para um endereço BTC que você configura no dashboard. O pagamento mínimo é de 0,0001 BTC, valor que a maior parte das carteiras passa depois de um punhado de swaps bem-sucedidos. Não há taxas de pagamento além da taxa padrão da rede Bitcoin.

Quais moedas são elegíveis para comissão?

Todo swap concluído dentro das mais de 1.700 moedas suportadas é elegível. Isso inclui XMR, BTC, ETH, USDT (em várias redes), LTC, BCH, SOL, DOGE, TRX e a long tail. Não existe uma lista especial de "ativos elegíveis" — se o par é swappable e o swap conclui, a comissão é atribuída e creditada.

Sou elegível se minha carteira tem pouquíssimos usuários hoje?

Sim. Não há mínimo de tráfego, piso de volume, análise de cadastro nem contrato. Um dev solo com uma carteira ainda em beta é elegível do mesmo jeito que um time de carteira com centenas de milhares de usuários. O percentual de comissão é o mesmo; o que muda é só o volume absoluto.

Link de indicação ou integração via API — por qual começar?

Comece pelo que cabe na sua restrição imediata. Se você consegue subir a integração de API esta semana, vá nela — swap dentro da carteira converte muito mais do que link externo, e ainda traz o benefício de retenção. Se você está travado em revisão de loja ou em uma janela de freeze, ponha o link de indicação na documentação, no changelog e nas respostas de suporte primeiro; você já começa a ganhar enquanto finaliza a integração. Os dois caminhos se compõem, e a maior parte dos times roda ambos.

O fluxo de swap é mesmo não custodial?

É. Cada swap gera um endereço de depósito amarrado àquele pedido específico, o usuário envia os fundos para ele, o provedor roteia a ordem e a moeda de destino chega no endereço que o usuário informou em create_exchange. Não há conta de custódia agrupada, não há saldo de usuário guardado na plataforma e não há passo de saque para o usuário final — a moeda de destino vai direto para a carteira dele.

Qual é o tamanho da pegada de integração no código?

Quatro endpoints REST — get_pairs, get_estimate, create_exchange, get_status — mais polling. Uma tela completa de swap para um único par geralmente cabe em 200 a 400 linhas incluindo UI; cobertura completa de pares com estados de erro e renderização de QR fica mais perto de uma tarde longa. Não há SDK que prende você; a API é JSON puro sobre HTTPS, então encaixa em qualquer stack que você já use.

Conclusão

A Monero swap API para devs de carteira é uma daquelas integrações raras em que o racional de engenharia e o racional de negócio concordam por inteiro. Seus usuários querem um jeito limpo e não custodial de fazer swap para XMR sem sair do seu app; você quer uma feature que retém esses usuários e uma receita que escala com o uso. A MoneroSwapper entrega as duas coisas pelos mesmos quatro endpoints. Cadastro grátis e no-KYC, comissão de 0,3% a 1,5% por swap concluído pago em BTC, pagamento em tempo real com mínimo de 0,0001 BTC e sem teto, e cobertura de mais de 1.700 moedas para que a integração gere comissão muito além dos pares de XMR.

Se sua carteira já suporta — ou poderia suportar — envio e recebimento de um punhado de ativos, um swap dentro do app movido por uma API de afiliado por volume é uma feature que paga a própria engenharia dentro de um trimestre para a maior parte dos times, e segue pagando depois disso. Pegue seu token de afiliado, ligue get_estimate e create_exchange atrás da sua tela de swap existente e deixe cada swap concluído pingar Bitcoin no seu saldo em tempo real. Entre no programa de afiliados da MoneroSwapper — grátis, no-KYC, e seu link de afiliado fica vivo em cerca de trinta segundos.