API mixer crypto
Mixa Bitcoin, Ethereum, BNB e Solana dal tuo codice. Semplice JSON su HTTPS, senza account e senza chiave API: avvia un mix, invia le monete al suo indirizzo monouso, poi seguilo finché le monete nuove non raggiungono il tuo indirizzo di ricezione.
Come funziona l’API del mixer
POST /api/v1/mixescon la moneta, l’indirizzo di ricezione e un ritardo da 30 a 1200 minuti.- Invia almeno il minimo a
send_to_address, poi chiama/sent. - Le monete vengono confermate on-chain. Il tuo ritardo inizia.
- Quando il ritardo finisce, le monete nuove vanno all’indirizzo di ricezione. Interroga il mix finché non risulta
complete.
URL di base: https://bitcoinmix.io/api/v1. Specifica completa: OpenAPI 3.1. Preferisci gli strumenti all’HTTP? Usa il server MCP del mixer crypto.
Endpoint
| Metodo | Percorso | Cosa fa |
|---|---|---|
| GET | /api/v1/coins | Monete, reti, minimi, commissioni e intervallo di ritardo |
| POST | /api/v1/mixes | Avvia un mix e ottieni l’indirizzo monouso a cui inviare |
| GET | /api/v1/mixes/{mix_id} | Stato, importi e tempi di un mix |
| POST | /api/v1/mixes/{mix_id}/sent | Monete inviate: l’indirizzo viene controllato dopo +1, +5 e +10 minuti |
| GET | /api/v1/mixes/{mix_id}/letter | La Lettera di garanzia in testo semplice |
Avviare un mix
Invia un JSON con coin, receiving_address e delay_minutes. Un partner_code facoltativo accredita un partner. I campi sconosciuti vengono rifiutati.
curl -X POST https://bitcoinmix.io/api/v1/mixes \
-H 'Content-Type: application/json' \
-d '{
"coin": "BTC",
"receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
"delay_minutes": 120
}'La risposta, abbreviata:
{
"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": "…"
}Seguire un mix
# 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| Stato | Significato |
|---|---|
waiting_for_coins | L’indirizzo monouso è in attesa delle tue monete. |
coins_received | Monete confermate on-chain. Il ritardo che hai scelto è in corso. |
processing | Il ritardo è terminato. Le monete nuove sono in viaggio verso l’indirizzo di ricezione. |
complete | Le monete nuove sono arrivate all’indirizzo di ricezione. |
below_minimum | È arrivato meno del minimo. L’importo resta come donazione. |
Monete, minimi e conferme
| Moneta | Rete | Minimo | Conferme |
|---|---|---|---|
| mixer Bitcoin | Rete Bitcoin | 0.0015 BTC | 3 |
| mixer Ethereum | Mainnet Ethereum | 0.05 ETH | 12 |
| mixer BNB | BNB Smart Chain | 0.15 BNB | 15 |
| mixer Solana | Mainnet Solana | 1 SOL | 32 |
La commissione di servizio è casuale per ogni mix, dal 2.1% al 5%. Fa parte della risposta quando il mix viene creato. Bitcoin accetta indirizzi 1…, 3…, bc1q… e bc1p…. Solo mainnet.
Errori
Ogni errore è in JSON: { "error": { "code": "…", "message": "…" } }.
| HTTP | Codice | Quando |
|---|---|---|
| 400 | invalid_coin | coin non è BTC, ETH, BNB o SOL |
| 400 | invalid_address | L’indirizzo di ricezione non è valido per quella moneta |
| 400 | invalid_delay | delay_minutes non è un numero intero da 30 a 1200 |
| 400 | bad_request | Non è JSON, un campo è sconosciuto o un campo manca |
| 404 | not_found | Nessun mix con quell’id, oppure il suo link è scaduto |
| 429 | rate_limited | Troppe richieste: attendi Retry-After |
| 503 | unavailable | Il mix è sospeso per un momento: riprova tra poco |
Mantenere privato un mix
- L’id del mix è l’unica chiave di accesso al mix. Tienilo fuori dai log, dagli URL che condividi e dal codice pubblico.
- Invia da un indirizzo che controlli tu, così un rimborso resta possibile. Gli indirizzi degli exchange sono condivisi da molti utenti.
- Conserva la Lettera di garanzia finché il mix non risulta completato.
FAQ sull’API del mixer
L’API mixer crypto richiede una chiave API?
No. Non servono chiave, account o iscrizione. Ogni mix ha il proprio id di 64 caratteri, che funziona come unica chiave per quel mix.
Quali monete può mixare l’API del mixer?
Bitcoin (BTC), Ethereum (ETH), BNB su BNB Smart Chain e Solana (SOL). Ogni moneta esce sulla propria rete verso un indirizzo di ricezione sulla stessa rete.
Quanto costa un mix tramite l’API?
La commissione di servizio è stabilita a caso tra il 2.1% e il 5% per ogni mix e viene restituita alla creazione del mix, prima che tu invii qualcosa. Le commissioni di rete per il pagamento si aggiungono.
Esiste un server MCP per gli agenti AI?
Sì. Le stesse azioni sono disponibili come strumenti MCP su Streamable HTTP, così un agente AI può avviare e seguire un mix senza codice personalizzato.