Publiczne API

Żądanie	Wynik
GET /api/v1	Wersja, środowisko, obsługiwane sieci i możliwości
GET /api/v1/collections?limit=20&offset=0&chain=84532	Publiczna konfiguracja kolekcji i linki integracji
GET /api/v1/collections/84532/{contract_address}	Jedna zarejestrowana kolekcja, łącznie z wartościami z sieci z pamięci podręcznej
GET /api/v1/collections/solana:devnet/{address}	Jedna zarejestrowana kolekcja z Solany
GET /api/v1/contracts/kurvdrop	Publiczne ABI KurvDrop, łącznie z wycenami i mintem
POST /api/v1/collections/84532/{contract_address}/mint-call	Świeża wycena i dokładne wywołania dla jednego kupującego: Mint z Twojej strony

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

W links każdej kolekcji są też links.mint_window, okno KURV, które ją mintuje, oraz links.mint_call, adres jej planu mintu. Oba mają wartość null dla kolekcji przeniesionej z innego miejsca. mint-call to jedyny POST: odczytuje łańcuch, niczego nie zmienia w KURV i niczego nie podpisuje.

Wszystkie trasy publicznego API wysyłają Access-Control-Allow-Origin: * i przyjmują tylko odczyty. Nie wymagają plików cookie. Listy przyjmują limit od 1 do 50 i przesunięcie od 0 do 200; na końcu pagination.next_offset ma wartość null. Wersja 1 udostępnia okno 200 najnowszych widocznych rekordów katalogu, a nie nieograniczony indeks historyczny. Trasa szczegółów obsługuje też zarejestrowane kolekcje, do których dochodzi się bezpośrednio po adresie.

Kwoty i liczby egzemplarzy są dziesiętnymi ciągami znaków, co zachowuje precyzję liczb całkowitych. Kwoty są w najmniejszej jednostce tokenu płatności kolekcji. Przed formatowaniem odczytaj decimals() i symbol() tego tokenu; nigdy nie zakładaj, że każda kolekcja rozlicza się w USDC z sześcioma miejscami po przecinku. max_supply pochodzi z konfiguracji wypuszczenia, dopóki nie jest dostępny stan z sieci. total_minted ma wartość null, dopóki nie ma odczytu, zamiast wymyślonego zera.

Odczyty szczegółów korzystają ze wspólnej, 15-sekundowej pamięci podręcznej KURV dla danych z sieci. reading.read_at zapisuje, kiedy odczyt się powiódł; reading.status: "stale_or_unavailable" oznacza, że ostatnia próba się nie powiodła, a wszystkie wartości pochodzą z ostatniego udanego odczytu. Wycena w tej odpowiedzi ma charakter informacyjny, dotyczy jednego NFT w domyślnej aktywnej fazie i nie dowodzi, że portfel może mintować. Tuż przed podpisem pobierz świeże quoteMint.

Media i korzenie metadanych nieodsłoniętych tokenów są ukryte. Osobno opublikowany zwiastun może pozostać widoczny. Prywatne listy dostępu, listy plików publikacji, ziarna, dane logowania kont i surowe błędy infrastruktury nigdy nie są zawarte w wersji 1. Błędy mają postać { "api_version": "1", "error": { "code": "...", "message": "..." } } z kodami statusu 400, 404 lub 503.

Dla Base Sepolia użyj https://testnet.kurv.fun, chain id 84532. Dostępne punkty wejścia wymienia strona KURV dla programistów. Ceny i opłaty zależą od kolekcji: przeczytaj Opłaty i Ryzyka i zastrzeżenia.