API publiques

Requête	Résultat
GET /api/v1	Version, environnement, chaînes prises en charge et fonctionnalités
GET /api/v1/collections?limit=20&offset=0&chain=84532	Configuration publique des collections et liens d’intégration
GET /api/v1/collections/84532/{contract_address}	Une collection enregistrée, avec les chiffres de la chaîne en cache
GET /api/v1/collections/solana:devnet/{address}	Une collection Solana enregistrée
GET /api/v1/contracts/kurvdrop	ABI publique de KurvDrop, devis et mint compris
POST /api/v1/collections/84532/{contract_address}/mint-call	Un devis récent et les appels exacts pour un acheteur : Minter depuis votre page

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

Les links de chaque collection indiquent aussi links.mint_window, la fenêtre KURV qui la minte, et links.mint_call, l’adresse de son plan de mint. Les deux valent null pour une collection apportée d’ailleurs. mint-call est le seul POST : il lit la chaîne, ne change rien sur KURV et ne signe rien.

Toutes les routes de l’API publique envoient Access-Control-Allow-Origin: * et n’acceptent que des lectures. Elles ne demandent aucun cookie. Les listes acceptent une limite de 1 à 50 et un décalage de 0 à 200 ; pagination.next_offset vaut null à la fin. La version 1 expose une fenêtre des 200 entrées visibles les plus récentes du catalogue, et non un index historique illimité. La route de détail prend aussi en charge les collections enregistrées atteintes par leur adresse directe.

Les montants et les quantités en circulation sont des chaînes décimales, ce qui préserve la précision des entiers. Les montants utilisent la plus petite unité du jeton de paiement de la collection. Lisez decimals() et symbol() de ce jeton avant de formater ; ne supposez jamais que chaque collection se règle en USDC à six décimales. max_supply provient de la configuration du lancement tant que l’état de la chaîne n’est pas disponible. total_minted vaut null tant qu’il n’existe aucune lecture, plutôt qu’un zéro inventé.

Les lectures de détail réutilisent le cache de chaîne partagé de KURV, de 15 secondes. reading.read_at enregistre le moment où une lecture a réussi ; reading.status: "stale_or_unavailable" signifie que la dernière tentative a échoué et que les éventuels chiffres proviennent de la dernière lecture réussie. Un devis dans cette réponse est indicatif, pour une pièce dans la phase active par défaut, et ne prouve pas que le portefeuille peut minter. Obtenez un quoteMint récent juste avant de signer.

Les médias et les racines de métadonnées des jetons non révélés sont retenus. Un aperçu publié séparément peut rester visible. Les listes d’accès privées, les listes de fichiers de publication, les graines, les identifiants de compte et les erreurs brutes de l’infrastructure ne sont jamais inclus dans la version 1. Les erreurs utilisent { "api_version": "1", "error": { "code": "...", "message": "..." } } avec les codes d’état 400, 404 ou 503.

Utilisez https://testnet.kurv.fun pour Base Sepolia, ID de chaîne 84532. KURV pour les développeurs liste les points d’entrée disponibles. Les prix et les frais dépendent de la collection : lisez Frais et Risques et avertissement.