API per lo scambio di criptovalute con condivisione dei ricavi per i partner che utilizzano i wallet.

Un'API per lo scambio di criptovalute consente a un wallet, un exchange o un prodotto fintech di offrire conversioni da criptovaluta a criptovaluta senza dover gestire autonomamente liquidità, custodia o conformità. L'integratore trasmette all'API la criptovaluta di origine, la criptovaluta di destinazione e l'indirizzo di ricezione dell'utente; il fornitore calcola il tasso di cambio, genera un indirizzo di deposito, monitora il deposito e inoltra l'asset convertito alla destinazione. L'integratore non gestisce mai i fondi.

TL; DR: L'API di GhostSwap espone lo stesso motore di scambio non custodiale che alimenta ghostswap.io — oltre 1,600 coppie su più di 200 asset supportati, prezzi a tasso variabile e regolamento p50 in circa 8 minuti — con un modello di condivisione dei ricavi con i wallet che instradano il volume attraverso di esso.

Un'API per lo scambio di criptovalute È un'interfaccia REST/JSON che esegue programmaticamente scambi tra criptovalute. A differenza di un'API di scambio (che presuppone che l'utente abbia un account e un saldo presso l'exchange), un'API di scambio tratta ogni transazione come una conversione unica e non custodiale: deposito in, scambio, prelievo.

Perché i wallet integrano un'API di scambio invece di crearne una propria

Costruire un proprio motore di scambio significa reperire liquidità, gestire il rischio di inventario, creare un sistema di instradamento degli ordini tra piattaforme centralizzate e decentralizzate e garantire la conformità normativa richiesta da ciascuna di esse. Per un team di wallet focalizzato sull'esperienza utente, questa è la sfida sbagliata.

Un'API di scambio semplifica tutto questo lavoro riducendolo a poche chiamate HTTP. I tuoi utenti ottengono scambi direttamente nel portafoglio; tu ottieni una fonte di reddito che prima non esisteva; e il fornitore di scambio si fa carico della complessità operativa. Questo è lo stesso schema che diversi portafogli nativi di Monero hanno utilizzato per offrire l'accesso in-app da BTC, ETH o stablecoin a XMR: Feather Wallet (desktop) e Monerujo (Android) sono esempi comunemente citati di portafogli che hanno pubblicato integrazioni di scambio di terze parti nelle loro note di rilascio.

Il compromesso è semplice: si rinuncia al controllo diretto sull'economia degli swap in cambio della possibilità di non doverli costruire. Un programma di condivisione dei ricavi ben strutturato è ciò che chiude il cerchio.

Come funziona l'API GhostSwap dall'inizio alla fine

1. GET /v1/pairs — Elenca le oltre 1,600 coppie supportate. Filtra per asset di origine o di destinazione.
2. GET /v1/rate?from=BTC&to=XMR&amount=0.05 — Richiedi un preventivo a tasso variabile. I preventivi sono indicativi; il tasso finale viene stabilito al momento della conferma del deposito dell'utente.
3. POST /v1/swap — crea uno scambio. Tu fornisci from, to, amount, destination_address, e un facoltativo refund_addressLa risposta contiene un indirizzo per il versamento di un deposito una tantum.
4. L'utente invia il deposito. L'interfaccia utente del tuo portafoglio mostra l'indirizzo, il codice QR e l'importo indicativo che riceverai.
5. GET /v1/swap/{id} — sondaggio sullo stato. Il ciclo di vita è awaiting_deposit → received → exchanging → sending → complete.
6. I fondi vengono accreditati all'indirizzo di destinazione dell'utente. Il tempo di liquidazione tipico end-to-end è di circa 8 minuti per p50 e di circa 30 minuti per p95.

L'utente finale non deve creare un account, né effettuare verifiche KYC o fornire un indirizzo email: l'integratore autentica l'utente tramite una chiave API e quest'ultimo deve solo fornire l'indirizzo di destinazione.

Come GhostSwap si confronta con altre API di scambio

Il confronto è descrittivo, non valutativo. I partner sono tenuti a verificare i dati aggiornati sul sito web di ciascun fornitore prima di sottoscrivere qualsiasi accordo.

Il modello di condivisione dei ricavi con i partner

GhostSwap restituisce una parte dei ricavi derivanti dagli scambi ai wallet e alle app che si integrano. La percentuale è proporzionale al volume mensile gestito: i volumi più elevati ricevono una quota maggiore. I pagamenti vengono effettuati mensilmente nella valuta scelta dal partner (in genere BTC, ETH, USDT o XMR).

Tre note pratiche per la valutazione del programma:

1. L'attribuzione è limitata alla chiave API. Ogni scambio creato con la tua chiave partner ti viene attribuito per tutta la durata dello scambio stesso. Non ci sono vincoli legati ai cookie o alla fragilità dei link di affiliazione.
2. Si imposta la tariffa visibile all'utente. I partner possono aggiungere un ricarico alla tariffa indicata; tale ricarico spetta al partner in aggiunta alla sua quota di ricavi di base.
3. Non è richiesto alcun accordo di esclusiva. È possibile utilizzare GhostSwap insieme ad altri provider e instradare le connessioni per coppia in base a quale offre la tariffa migliore ai propri utenti.

GhostSwap non è un servizio finanziario registrato. Il programma di affiliazione è un'integrazione commerciale; i partner sono responsabili dei propri obblighi giurisdizionali.

Quando l'API GhostSwap è la soluzione ideale

È la scelta giusta se:

• Gestisci un portafoglio non custodiale e desideri effettuare scambi in-app senza trattenere i fondi degli utenti.
• Ai tuoi utenti interessa non creare account o fornire documenti d'identità per scambi di routine.
• Desideri un'unica API che supporti BTC, ETH, XMR, LTC, stablecoin e oltre 1,600 combinazioni di coppie, non solo EVM-to-EVM.
• È preferibile generare entrate piuttosto che costruire un'infrastruttura di liquidità.

Non è adatto se:

• È necessario disporre di punti di accesso per le valute fiat all'interno della stessa chiamata API (GhostSwap è una conversione da criptovaluta a criptovaluta).
• Hai bisogno di preventivi a tasso fisso bloccati al momento del preventivo (GhostSwap ha un tasso variabile; il tasso viene impostato alla conferma del deposito).
• La tua giurisdizione o il tuo prodotto ti impongono di effettuare la verifica dell'identità (KYC) di ogni utente di swap: si tratta di un livello aggiuntivo da implementare in aggiunta, non al di sotto.

FAQ

D: Come funziona il modello no-KYC per l'integratore di API?
A: L'utente finale fornisce un indirizzo di ricezione; GhostSwap instrada lo scambio in modo non custodiale e non trattiene mai i fondi. L'integratore si autentica tramite una chiave API. Né l'utente né l'integratore inviano documenti di identità a GhostSwap per le operazioni di scambio.

D: Quali sono i tempi di liquidazione tipici?
R: Secondo i dati di telemetria del prodotto, p50 richiede circa 8 minuti end-to-end e p95 circa 30 minuti. I tempi dipendono dai requisiti di conferma della blockchain di origine: i depositi Bitcoin ereditano i tempi di conferma di Bitcoin.

D: Come viene calcolata la quota di ricavi?
R: Si tratta di una percentuale dei ricavi di GhostSwap derivanti dagli scambi effettuati tramite la tua chiave API, pagata mensilmente. La ripartizione esatta dei livelli viene condivisa durante la fase di onboarding dei partner. I partner possono anche aggiungere un proprio margine di profitto alla tariffa indicata.

D: Posso utilizzare l'API per creare un'interfaccia di scambio completa senza KYC?
R: Sì. L'API copre la scoperta delle coppie, la quotazione, la creazione di swap e il monitoraggio dello stato: tutto ciò che serve per alimentare un'interfaccia utente completa per gli swap. Molti partner offrono una scheda dedicata agli swap all'interno di un wallet esistente, anziché in un exchange separato.

D: L'API è documentata pubblicamente?
A: Sì — vedi Il riferimento API di GhostSwap per endpoint, parametri, forme di risposta ed esempi di payload.

Inizia

Se stai valutando le API di scambio per un portafoglio o un'integrazione con un'app, il percorso più veloce è leggere il riferimento API e prova uno scambio di prova contro il motore di scambio in tempo reale sulla homepage per visualizzare il flusso utente finale che la tua integrazione genererà.

Per i termini della partnership, contattaci tramite la pagina dei contatti.