Публічні API

Запит	Результат
GET /api/v1	Версія, середовище, підтримувані мережі й можливості
GET /api/v1/collections?limit=20&offset=0&chain=84532	Публічна конфігурація колекцій і посилання для інтеграції
GET /api/v1/collections/84532/{contract_address}	Одна зареєстрована колекція разом із кешованими показниками з мережі
GET /api/v1/collections/solana:devnet/{address}	Одна зареєстрована колекція Solana
GET /api/v1/contracts/kurvdrop	Публічний ABI KurvDrop, зокрема ціни й мінт
POST /api/v1/collections/84532/{contract_address}/mint-call	Свіже котирування й точні виклики для одного покупця: Мінт із вашої сторінки

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

У links кожної колекції є також links.mint_window, вікно KURV для мінту, і links.mint_call, адреса плану мінту. Для колекції, перенесеної з іншого місця, обидва дорівнюють null. mint-call єдиний POST: він читає мережу, нічого не змінює в KURV і нічого не підписує.

Усі публічні маршрути API надсилають Access-Control-Allow-Origin: * і приймають лише читання. Кукі вони не потребують. Списки приймають limit від 1 до 50 і offset від 0 до 200; наприкінці pagination.next_offset дорівнює null. Версія 1 відкриває вікно з 200 найновіших видимих записів каталогу, а не необмежений історичний індекс. Маршрут деталей також підтримує зареєстровані колекції, до яких звертаються за прямою адресою.

Суми й кількості NFT це десяткові рядки, що зберігають точність цілих чисел. Суми вказано в найменших одиницях платіжного токена колекції. Перш ніж форматувати, прочитайте decimals() і symbol() цього токена; ніколи не вважайте, що кожна колекція розраховується в USDC із шістьма знаками після коми. max_supply береться з конфігурації запуску, доки немає стану з мережі. total_minted дорівнює null, доки немає зчитування, а не вигаданому нулю.

Читання деталей використовують спільний 15-секундний кеш мережі KURV. reading.read_at записує, коли зчитування вдалося; reading.status: "stale_or_unavailable" означає, що остання спроба не вдалася і всі показники належать до останнього вдалого зчитування. Ціна в цій відповіді має довідковий характер, вона для одного NFT у типовій активній фазі і не доводить, що гаманець може мінтити. Отримайте свіжий quoteMint безпосередньо перед підписом.

Медіа й корені метаданих нерозкритих токенів приховано. Окремо опублікований тизер може лишатися видимим. Приватні списки доступу, списки файлів публікації, сіди, облікові дані акаунтів і сирі помилки інфраструктури ніколи не входять у версію 1. Помилки мають формат { "api_version": "1", "error": { "code": "...", "message": "..." } } з кодами статусу 400, 404 або 503.

Для Base Sepolia використовуйте https://testnet.kurv.fun, chain id 84532. На сторінці KURV для розробників перелічено доступні точки входу. Ціни й комісії залежать від колекції: прочитайте Комісії і Ризики та застереження.