API pubbliche

Richiesta	Risultato
GET /api/v1	Versione, ambiente, chain supportate e funzionalità
GET /api/v1/collections?limit=20&offset=0&chain=84532	Configurazione pubblica delle collezioni e link di integrazione
GET /api/v1/collections/84532/{contract_address}	Una collezione registrata, con i dati della blockchain in cache
GET /api/v1/collections/solana:devnet/{address}	Una collezione Solana registrata
GET /api/v1/contracts/kurvdrop	ABI pubblica di KurvDrop, quotazioni e mint compresi
POST /api/v1/collections/84532/{contract_address}/mint-call	Una quotazione aggiornata e le chiamate esatte per un acquirente: Minta dalla tua pagina

const origin = 'https://testnet.kurv.fun';
const { collections } = await fetch(`${origin}/api/v1/collections?limit=20`)
  .then(response => response.json());
const collection = collections[0];
const { collection: current } = await fetch(
  `${origin}/api/v1/collections/${collection.chain_id}/${collection.contract_address}`
).then(response => response.json());

I links di ogni collezione indicano anche links.mint_window, la finestra KURV che la minta, e links.mint_call, l’indirizzo del suo piano di mint. Sono entrambi null per una collezione portata da altrove. mint-call è l’unico POST: legge la chain, non cambia nulla su KURV e non firma nulla.

Tutte le route dell’API pubblica inviano Access-Control-Allow-Origin: * e accettano solo letture. Non richiedono cookie. Gli elenchi accettano un limit da 1 a 50 e un offset da 0 a 200; pagination.next_offset è null alla fine. La versione 1 espone una finestra dei 200 record più recenti visibili nel catalogo, non un indice storico illimitato. La route di dettaglio supporta anche le collezioni registrate raggiunte tramite il loro indirizzo diretto.

Gli importi e i conteggi della supply sono stringhe decimali, per mantenere la precisione degli interi. Gli importi usano l’unità più piccola del token di pagamento della collezione. Leggi decimals() e symbol() di quel token prima di formattarli; non dare mai per scontato che ogni collezione si regoli in USDC a sei decimali. max_supply viene dalla configurazione del lancio finché lo stato della blockchain non è disponibile. total_minted è null finché non c’è una lettura, invece di uno zero inventato.

Le letture di dettaglio riusano la cache condivisa della blockchain di KURV, di 15 secondi. reading.read_at registra quando una lettura è riuscita; reading.status: "stale_or_unavailable" significa che l’ultimo tentativo non è riuscito e che gli eventuali dati appartengono all’ultima lettura riuscita. Una quotazione in questa risposta è informativa, per un pezzo nella fase attiva predefinita, e non dimostra che il wallet possa mintare. Ottieni un quoteMint aggiornato subito prima di firmare.

I media dei token non ancora rivelati e le radici dei metadati restano riservati. Un’anteprima pubblicata separatamente può restare visibile. Allowlist private, elenchi dei file di pubblicazione, semi, credenziali degli account ed errori grezzi dell’infrastruttura non sono mai inclusi nella versione 1. Gli errori usano { "api_version": "1", "error": { "code": "...", "message": "..." } } con i codici di stato 400, 404 o 503.

Usa https://testnet.kurv.fun per Base Sepolia, chain id 84532. KURV per sviluppatori elenca i punti di accesso disponibili. Prezzi e commissioni dipendono dalla collezione: leggi Commissioni e Rischi e avvertenze.