API de misturador cripto
Misture Bitcoin, Ethereum, BNB e Solana a partir do seu próprio código. JSON simples sobre HTTPS, sem conta e sem chave de API: inicie uma mistura, envie moedas para o respetivo endereço de uso único e acompanhe-a até as moedas novas chegarem ao seu endereço de receção.
Como funciona a API do misturador
POST /api/v1/mixescom a moeda, o endereço de receção e um tempo de espera de 30 a 1200 minutos.- Envie pelo menos o mínimo para
send_to_addresse chame/sent. - As moedas são confirmadas on-chain. O seu tempo de espera começa.
- Quando o tempo de espera terminar, as moedas novas seguem para o endereço de receção. Consulte a mistura até indicar
complete.
URL base: https://bitcoinmix.io/api/v1. Especificação completa: OpenAPI 3.1. Prefere ferramentas a HTTP? Use o servidor MCP do misturador cripto.
Endpoints
| Método | Caminho | O que faz |
|---|---|---|
| GET | /api/v1/coins | Moedas, redes, mínimos, taxas e intervalo do tempo de espera |
| POST | /api/v1/mixes | Inicia uma mistura e devolve o endereço de uso único para onde enviar |
| GET | /api/v1/mixes/{mix_id} | Estado, montantes e prazos de uma mistura |
| POST | /api/v1/mixes/{mix_id}/sent | Moedas enviadas: o endereço é verificado a +1, +5 e +10 minutos |
| GET | /api/v1/mixes/{mix_id}/letter | A Carta de Garantia em texto simples |
Iniciar uma mistura
Envie JSON com coin, receiving_address e delay_minutes. Um partner_code opcional credita um parceiro. Campos desconhecidos são recusados.
curl -X POST https://bitcoinmix.io/api/v1/mixes \
-H 'Content-Type: application/json' \
-d '{
"coin": "BTC",
"receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
"delay_minutes": 120
}'A resposta, abreviada:
{
"mix_id": "5f1c…64 hex characters…a9e0",
"coin": "BTC",
"status": "waiting_for_coins",
"send_to_address": "bc1qgr7f3jfuzhpe45h3dnqxxjr3ml0de4ad2w3ysd",
"receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
"minimum_amount": "0.0015",
"delay_minutes": 120,
"service_fee_percent": 3.36,
"link_expires_at": "2026-10-17T14:49:04.943Z",
"letter_of_guarantee": "…"
}Acompanhar uma mistura
# Coins sent: check the address now
curl -X POST https://bitcoinmix.io/api/v1/mixes/$MIX_ID/sent
# Follow the mix
curl https://bitcoinmix.io/api/v1/mixes/$MIX_ID
# Save the Letter of Guarantee
curl https://bitcoinmix.io/api/v1/mixes/$MIX_ID/letter > letter.txt| Estado | Significado |
|---|---|
waiting_for_coins | O endereço de uso único está à espera das suas moedas. |
coins_received | Moedas confirmadas on-chain. O tempo de espera que escolheu está a decorrer. |
processing | O tempo de espera terminou. As moedas novas estão a caminho do endereço de receção. |
complete | As moedas novas chegaram ao endereço de receção. |
below_minimum | Chegou menos do que o mínimo. O montante fica como donativo. |
Moedas, mínimos e confirmações
| Moeda | Rede | Mínimo | Confirmações |
|---|---|---|---|
| misturador de Bitcoin | Rede Bitcoin | 0.0015 BTC | 3 |
| misturador de Ethereum | Rede principal Ethereum | 0.05 ETH | 12 |
| misturador de BNB | BNB Smart Chain | 0.15 BNB | 15 |
| misturador de Solana | Rede principal Solana | 1 SOL | 32 |
A taxa de serviço é aleatória em cada mistura, de 2.1% a 5%. Faz parte da resposta quando a mistura é criada. O Bitcoin aceita endereços 1…, 3…, bc1q… e bc1p…. Apenas rede principal (mainnet).
Erros
Todos os erros são JSON: { "error": { "code": "…", "message": "…" } }.
| HTTP | Código | Quando |
|---|---|---|
| 400 | invalid_coin | coin não é BTC, ETH, BNB nem SOL |
| 400 | invalid_address | O endereço de receção não é válido para essa moeda |
| 400 | invalid_delay | delay_minutes não é um número inteiro de 30 a 1200 |
| 400 | bad_request | Não é JSON, tem um campo desconhecido ou falta um campo |
| 404 | not_found | Não existe nenhuma mistura com esse id, ou o link expirou |
| 429 | rate_limited | Demasiadas chamadas: aguarde o tempo indicado em Retry-After |
| 503 | unavailable | A mistura está em pausa por momentos: tente novamente dentro de instantes |
Manter uma mistura privada
- O mix id é a única chave de uma mistura. Mantenha-o fora de logs, de URLs que partilhe e de código público.
- Envie a partir de um endereço que controle, para que um reembolso continue possível. Os endereços das exchanges são partilhados por muitos utilizadores.
- Guarde a Carta de Garantia até a mistura estar concluída.
API do misturador: perguntas frequentes
A API de misturador cripto precisa de chave de API?
Não. Não há chave, nem conta, nem inscrição. Cada mistura tem o seu próprio mix id de 64 caracteres, que funciona como a única chave dessa mistura.
Que moedas pode a API do misturador misturar?
Bitcoin (BTC), Ethereum (ETH), BNB na BNB Smart Chain e Solana (SOL). Cada moeda sai na sua própria rede para um endereço de receção nessa mesma rede.
Quanto custa uma mistura através da API?
A taxa de serviço é definida aleatoriamente entre 2.1% e 5% em cada mistura e é devolvida quando a mistura é criada, antes de enviar o que quer que seja. A isso somam-se as taxas de rede do pagamento.
Existe um servidor MCP para agentes de IA?
Sim. As mesmas ações estão disponíveis como ferramentas MCP sobre Streamable HTTP, para que um agente de IA possa iniciar e acompanhar uma mistura sem código personalizado.