API publik

Permintaan	Hasil
GET /api/v1	Versi, lingkungan, chain yang didukung, dan kapabilitas
GET /api/v1/collections?limit=20&offset=0&chain=84532	Konfigurasi koleksi publik dan tautan integrasi
GET /api/v1/collections/84532/{contract_address}	Satu koleksi terdaftar, termasuk angka blockchain yang di-cache
GET /api/v1/contracts/kurvdrop	ABI KurvDrop publik, termasuk kuotasi dan mint

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

Semua rute API publik mengirim Access-Control-Allow-Origin: * dan hanya menerima pembacaan. Rute-rute ini tidak memerlukan cookie. Daftar menerima limit 1 hingga 50 dan offset 0 hingga 200; pagination.next_offset bernilai null di akhir daftar. Versi 1 menyediakan jendela berisi 200 catatan katalog terbaru yang terlihat, bukan indeks historis tanpa batas. Rute detail juga mendukung koleksi terdaftar yang diakses lewat alamat langsungnya.

Jumlah dan hitungan suplai berupa string desimal, untuk menjaga presisi bilangan bulat. Jumlah memakai satuan terkecil koin pembayaran koleksi. Baca decimals() dan symbol() koin itu sebelum memformat; jangan pernah menganggap setiap koleksi diselesaikan dalam USDC enam desimal. max_supply berasal dari konfigurasi peluncuran sampai status blockchain tersedia. total_minted bernilai null sampai ada pembacaan, alih-alih angka nol yang dikarang.

Pembacaan detail memakai ulang cache blockchain bersama milik KURV yang berlaku 15 detik. reading.read_at mencatat kapan pembacaan berhasil; reading.status: "stale_or_unavailable" berarti percobaan terakhir gagal dan angka apa pun berasal dari pembacaan terakhir yang berhasil. Kuotasi dalam respons ini bersifat informatif, untuk satu karya di fase aktif bawaan, dan tidak membuktikan bahwa dompet itu bisa mint. Ambil quoteMint terbaru tepat sebelum menandatangani.

Media karya dan root metadata yang belum diungkap dirahasiakan. Teaser yang dipublikasikan terpisah bisa tetap terlihat. Daftar izin pribadi, daftar berkas publikasi, seed, kredensial akun, dan pesan galat infrastruktur mentah tidak pernah disertakan di versi 1. Galat memakai { "api_version": "1", "error": { "code": "...", "message": "..." } } dengan kode status 400, 404, atau 503.

Pakai https://testnet.kurv.fun untuk Base Sepolia, chain id 84532. KURV untuk pengembang mencantumkan titik masuk yang tersedia. Harga dan biaya bergantung pada koleksinya: baca Biaya dan Risiko dan penafian.