API de mezclador cripto
Mezcla Bitcoin, Ethereum, BNB y Solana desde tu propio código. JSON simple sobre HTTPS, sin cuenta ni API key: inicia una mezcla, envía las monedas a su dirección de un solo uso y síguela hasta que lleguen monedas nuevas a tu dirección de recepción.
Cómo funciona la API del mezclador
POST /api/v1/mixescon la moneda, la dirección de recepción y un retraso de 30 a 1200 minutos.- Envía al menos el mínimo a
send_to_addressy luego llama a/sent. - Las monedas se confirman on-chain. Empieza tu retraso.
- Cuando termina el retraso, las monedas nuevas van a la dirección de recepción. Consulta la mezcla periódicamente hasta que indique
complete.
URL base: https://bitcoinmix.io/api/v1. Especificación completa: OpenAPI 3.1. ¿Prefieres herramientas en lugar de HTTP? Usa el servidor MCP del mezclador cripto.
Endpoints
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /api/v1/coins | Monedas, redes, mínimos, comisiones y el rango de retraso |
| POST | /api/v1/mixes | Inicia una mezcla y obtén la dirección de un solo uso a la que enviar |
| GET | /api/v1/mixes/{mix_id} | Estado, cantidades y tiempos de una mezcla |
| POST | /api/v1/mixes/{mix_id}/sent | Monedas enviadas: la dirección se comprueba a los +1, +5 y +10 minutos |
| GET | /api/v1/mixes/{mix_id}/letter | La Carta de Garantía en texto plano |
Iniciar una mezcla
Envía un JSON con coin, receiving_address y delay_minutes. Un partner_code opcional acredita a un socio. Los campos desconocidos se rechazan.
curl -X POST https://bitcoinmix.io/api/v1/mixes \
-H 'Content-Type: application/json' \
-d '{
"coin": "BTC",
"receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
"delay_minutes": 120
}'La respuesta, 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": "…"
}Seguir una mezcla
# 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 | La dirección de un solo uso está esperando tus monedas. |
coins_received | Monedas confirmadas on-chain. El retraso que elegiste está en curso. |
processing | El retraso terminó. Las monedas nuevas van de camino a la dirección de recepción. |
complete | Las monedas nuevas llegaron a la dirección de recepción. |
below_minimum | Llegó menos del mínimo. Se conserva como donación. |
Monedas, mínimos y confirmaciones
| Moneda | Red | Mínimo | Confirmaciones |
|---|---|---|---|
| mezclador de Bitcoin | Red de Bitcoin | 0.0015 BTC | 3 |
| mezclador de Ethereum | Red principal de Ethereum | 0.05 ETH | 12 |
| mezclador de BNB | BNB Smart Chain | 0.15 BNB | 15 |
| mezclador de Solana | Red principal de Solana | 1 SOL | 32 |
La comisión de servicio es aleatoria en cada mezcla, del 2.1 % al 5 %. Forma parte de la respuesta cuando se crea la mezcla. Bitcoin acepta direcciones 1…, 3…, bc1q… y bc1p…. Solo mainnet.
Errores
Todos los errores son JSON: { "error": { "code": "…", "message": "…" } }.
| HTTP | Código | Cuándo |
|---|---|---|
| 400 | invalid_coin | coin no es BTC, ETH, BNB ni SOL |
| 400 | invalid_address | La dirección de recepción no es válida para esa moneda |
| 400 | invalid_delay | delay_minutes no es un número entero entre 30 y 1200 |
| 400 | bad_request | No es JSON, hay un campo desconocido o falta un campo |
| 404 | not_found | No existe ninguna mezcla con ese id, o su enlace ha caducado |
| 429 | rate_limited | Demasiadas solicitudes: espera lo que indique Retry-After |
| 503 | unavailable | La mezcla está en pausa por un momento: vuelve a intentarlo en breve |
Cómo mantener privada una mezcla
- El mix id es la única llave de una mezcla. Mantenlo fuera de los logs, de las URL que compartas y del código público.
- Envía desde una dirección que controles tú, para que un reembolso siga siendo posible. Las direcciones de los exchanges las comparten muchos usuarios.
- Guarda la Carta de Garantía hasta que la mezcla indique complete.
Preguntas frecuentes sobre la API del mezclador
¿La API de mezclador cripto necesita una API key?
No. No hay clave, ni cuenta, ni registro. Cada mezcla tiene su propio mix id de 64 caracteres, que funciona como la única llave de esa mezcla.
¿Qué monedas puede mezclar la API del mezclador?
Bitcoin (BTC), Ethereum (ETH), BNB en BNB Smart Chain y Solana (SOL). Cada moneda sale por su propia red hacia una dirección de recepción en esa misma red.
¿Cuánto cuesta una mezcla a través de la API?
La comisión de servicio se fija al azar entre el 2.1 % y el 5 % en cada mezcla y se devuelve al crear la mezcla, antes de que envíes nada. Las comisiones de red del pago se suman aparte.
¿Hay un servidor MCP para agentes de IA?
Sí. Las mismas acciones están disponibles como herramientas MCP sobre Streamable HTTP, así que un agente de IA puede iniciar y seguir una mezcla sin código a medida.