Openbare API’s

Verzoek	Resultaat
GET /api/v1	Versie, omgeving, ondersteunde chains en mogelijkheden
GET /api/v1/collections?limit=20&offset=0&chain=84532	Openbare configuratie van collecties en koppelingslinks
GET /api/v1/collections/84532/{contract_address}	Eén geregistreerde collectie, met getallen van de chain uit de cache
GET /api/v1/collections/solana:devnet/{address}	Eén geregistreerde Solana-collectie
GET /api/v1/contracts/kurvdrop	Openbare KurvDrop-ABI, met prijsopgaven en minten
POST /api/v1/collections/84532/{contract_address}/mint-call	Een verse prijsopgave en de exacte aanroepen voor één koper: Minten vanaf je eigen 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());

De links van elke collectie noemen ook links.mint_window, het KURV-venster dat haar mint, en links.mint_call, het adres van haar mintplan. Beide zijn null bij een collectie die van elders is meegebracht. mint-call is de enige POST: hij leest de chain, wijzigt niets op KURV en ondertekent niets.

Alle openbare API-routes sturen Access-Control-Allow-Origin: * mee en accepteren alleen leesverzoeken. Ze hebben geen cookies nodig. Lijsten accepteren een limiet van 1 tot 50 en een offset van 0 tot 200; pagination.next_offset is null aan het eind. Versie 1 geeft een venster op de nieuwste 200 zichtbare catalogusrecords, geen onbegrensde historische index. De detailroute ondersteunt ook geregistreerde collecties die via hun directe adres worden bereikt.

Bedragen en aantallen stukken zijn decimale strings, zodat de precisie van gehele getallen behouden blijft. Bedragen staan in de kleinste eenheid van de betaalmunt van de collectie. Lees decimals() en symbol() van die munt voordat je opmaakt; ga er nooit van uit dat elke collectie in USDC met zes decimalen afrekent. max_supply komt uit de lanceringsconfiguratie totdat de status van de chain beschikbaar is. total_minted is null totdat er een meting is, in plaats van een verzonnen nul.

Detailverzoeken gebruiken de gedeelde chaincache van KURV van 15 seconden. reading.read_at legt vast wanneer een meting is gelukt; reading.status: "stale_or_unavailable" betekent dat de laatste poging is mislukt en dat eventuele getallen van de laatste geslaagde meting zijn. Een prijsopgave in dit antwoord is informatief, voor één stuk in de standaard actieve fase, en bewijst niet dat de wallet kan minten. Haal vlak voor het ondertekenen een verse quoteMint op.

Media en metadataroots van niet-onthulde tokens worden achtergehouden. Een apart gepubliceerde teaser kan zichtbaar blijven. Privé-allowlists, lijsten van publicatiebestanden, startwaarden, accountgegevens en ruwe infrastructuurfouten zitten nooit in versie 1. Fouten gebruiken { "api_version": "1", "error": { "code": "...", "message": "..." } } met de statuscodes 400, 404 of 503.

Gebruik https://testnet.kurv.fun voor Base Sepolia, chain-ID 84532. KURV voor ontwikkelaars noemt de beschikbare toegangspunten. Prijzen en vergoedingen hangen af van de collectie: lees Kosten en Risico’s en disclaimer.