Öffentliche APIs

Anfrage	Ergebnis
GET /api/v1	Version, Umgebung, unterstützte Chains und Fähigkeiten
GET /api/v1/collections?limit=20&offset=0&chain=84532	Öffentliche Konfiguration der Kollektion und Integrationslinks
GET /api/v1/collections/84532/{contract_address}	Eine registrierte Kollektion, mit zwischengespeicherten Zahlen von der Chain
GET /api/v1/collections/solana:devnet/{address}	Eine registrierte Solana-Kollektion
GET /api/v1/contracts/kurvdrop	Öffentliche KurvDrop-ABI, mit Angeboten und Minten
POST /api/v1/collections/84532/{contract_address}/mint-call	Ein frisches Angebot und die genauen Aufrufe für einen Käufer: Von deiner Seite aus minten

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());

Die links jeder Kollektion nennen auch links.mint_window, das KURV-Fenster zum Minten, und links.mint_call, die Adresse ihres Mint-Plans. Bei einer von anderswo mitgebrachten Kollektion sind beide null. mint-call ist das einzige POST: Es liest die Chain, ändert nichts auf KURV und signiert nichts.

Alle öffentlichen API-Routen senden Access-Control-Allow-Origin: * und nehmen nur Lesezugriffe an. Sie brauchen keine Cookies. Listen akzeptieren ein Limit von 1 bis 50 und einen Offset von 0 bis 200; pagination.next_offset ist am Ende null. Version 1 zeigt ein Fenster der neuesten 200 sichtbaren Katalogeinträge, keinen unbegrenzten historischen Index. Die Detailroute unterstützt außerdem registrierte Kollektionen, die über ihre direkte Adresse erreicht werden.

Beträge und Mengenangaben sind dezimale Strings, damit die Ganzzahlgenauigkeit erhalten bleibt. Beträge nutzen die kleinste Einheit des Zahlungstokens der Kollektion. Lies decimals() und symbol() dieses Tokens, bevor du formatierst; nimm nie an, dass jede Kollektion in USDC mit sechs Dezimalstellen abrechnet. max_supply kommt aus der Startkonfiguration, bis der Zustand auf der Chain verfügbar ist. total_minted ist null, bis es einen Messwert gibt, statt einer erfundenen Null.

Detailabfragen nutzen den gemeinsamen Chain-Cache von KURV mit 15 Sekunden. reading.read_at hält fest, wann ein Messwert erfolgreich war; reading.status: "stale_or_unavailable" bedeutet, dass der letzte Versuch fehlgeschlagen ist und alle Zahlen zum letzten erfolgreichen Messwert gehören. Ein Angebot in dieser Antwort dient nur der Information, für ein Stück in der standardmäßig aktiven Phase, und beweist nicht, dass die Wallet minten kann. Hol dir direkt vor dem Signieren ein frisches quoteMint.

Medien und Metadaten-Roots nicht aufgedeckter Tokens werden zurückgehalten. Ein separat veröffentlichter Teaser kann sichtbar bleiben. Private Allowlists, Dateilisten von Veröffentlichungen, Startwerte, Zugangsdaten zu Konten und rohe Infrastrukturfehler sind in Version 1 nie enthalten. Fehler nutzen { "api_version": "1", "error": { "code": "...", "message": "..." } } mit den Statuscodes 400, 404 oder 503.

Nutze https://testnet.kurv.fun für Base Sepolia, Chain-ID 84532. KURV für Entwickler listet die verfügbaren Einstiegspunkte. Preise und Gebühren hängen von der Kollektion ab: Lies Gebühren und Risiken und Haftungsausschluss.