Публичные 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 самых новых видимых записей каталога, а не неограниченный исторический индекс. Маршрут подробностей также поддерживает зарегистрированные коллекции, к которым обращаются по прямому адресу.

Суммы и количества выпуска это десятичные строки, чтобы сохранить точность целых чисел. Суммы указаны в наименьших единицах платёжного токена коллекции. Прежде чем форматировать, прочитайте 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 для разработчиков. Цены и комиссии зависят от коллекции: прочитайте Комиссии и Риски и отказ от ответственности.