公开 API

请求	结果
GET /api/v1	版本、环境、支持的链和功能
GET /api/v1/collections?limit=20&offset=0&chain=84532	公开的合集配置和集成链接
GET /api/v1/collections/84532/{contract_address}	一个已登记的合集，包括缓存的链上数字
GET /api/v1/contracts/kurvdrop	公开的 KurvDrop ABI，包括报价和铸造

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

所有公开 API 路由都会发送 Access-Control-Allow-Origin: *，并且只接受读取。它们不需要 Cookie。列表接受 1 到 50 的 limit 和 0 到 200 的 offset；到末尾时，pagination.next_offset 为 null。版本 1 只提供最新 200 条可见目录记录的窗口，而不是不设上限的历史索引。详情路由也支持通过合集的直接地址访问已登记的合集。

金额和供应数量都是十进制字符串，以保留整数精度。金额以合集支付代币的最小单位表示。格式化之前，请先读取该代币的 decimals() 和 symbol()；永远不要假定每个合集都用六位小数的 USDC 结算。在链上状态可用之前，max_supply 来自发行配置。在有读数之前，total_minted 为 null，而不是一个虚构的零。

详情读取会复用 KURV 共享的 15 秒链上缓存。reading.read_at 记录读取成功的时间；reading.status: "stale_or_unavailable" 表示最近一次尝试失败，所有数字都来自上一次成功的读取。此响应中的报价仅供参考，针对的是默认活跃阶段中的一件藏品，并不能证明该钱包可以铸造。请在签名之前立即获取一个新的 quoteMint。

未揭晓的代币媒体和元数据根地址会被保密。单独发布的预告图可以保持可见。私有白名单、发布文件列表、种子、账户凭据和原始基础设施错误，永远不会出现在版本 1 中。错误使用 { "api_version": "1", "error": { "code": "...", "message": "..." } } 格式，状态码为 400、404 或 503。

Base Sepolia 请使用 https://testnet.kurv.fun，chain id 为 84532。面向开发者的 KURV 列出了可用的入口。价格和费用取决于具体合集：请阅读费用和风险与免责声明。