API públicas

Solicitud	Resultado
GET /api/v1	Versión, entorno, cadenas admitidas y capacidades
GET /api/v1/collections?limit=20&offset=0&chain=84532	Configuración pública de las colecciones y enlaces de integración
GET /api/v1/collections/84532/{contract_address}	Una colección registrada, con las cifras de la cadena en caché
GET /api/v1/collections/solana:devnet/{address}	Una colección de Solana registrada
GET /api/v1/contracts/kurvdrop	ABI pública de KurvDrop, con cotizaciones y acuñación
POST /api/v1/collections/84532/{contract_address}/mint-call	Una cotización reciente y las llamadas exactas para un comprador: Acuña desde tu página

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

Los links de cada colección también incluyen links.mint_window, la ventana de KURV que la acuña, y links.mint_call, la dirección de su plan de acuñación. Ambos son null en una colección traída de otro lugar. mint-call es el único POST: lee la cadena, no cambia nada en KURV y no firma nada.

Todas las rutas de la API pública envían Access-Control-Allow-Origin: * y solo aceptan lecturas. No necesitan cookies. Las listas aceptan un límite de 1 a 50 y un desplazamiento de 0 a 200; pagination.next_offset es null al final. La versión 1 expone una ventana con los 200 registros visibles más recientes del catálogo, no un índice histórico sin límite. La ruta de detalle también admite colecciones registradas a las que se llega por su dirección directa.

Los importes y las cantidades de suministro son cadenas decimales, para conservar la precisión de los enteros. Los importes usan la unidad más pequeña del token de pago de la colección. Lee decimals() y symbol() de ese token antes de darles formato; nunca des por hecho que todas las colecciones se liquidan en USDC con seis decimales. max_supply sale de la configuración del lanzamiento hasta que el estado de la cadena está disponible. total_minted es null hasta que hay una lectura, en lugar de un cero inventado.

Las lecturas de detalle reutilizan la caché compartida de la cadena de KURV, de 15 segundos. reading.read_at registra cuándo tuvo éxito una lectura; reading.status: "stale_or_unavailable" significa que el último intento falló y que cualquier cifra corresponde a la última lectura correcta. Una cotización en esta respuesta es informativa, para una pieza en la fase activa por defecto, y no demuestra que la cartera pueda acuñar. Obtén un quoteMint reciente justo antes de firmar.

Los medios y las raíces de metadatos de los tokens sin revelar se reservan. Un avance publicado por separado puede seguir visible. Las listas de acceso privadas, las listas de archivos de publicación, las semillas, las credenciales de cuentas y los errores en bruto de la infraestructura nunca se incluyen en la versión 1. Los errores usan { "api_version": "1", "error": { "code": "...", "message": "..." } } con los códigos de estado 400, 404 o 503.

Usa https://testnet.kurv.fun para Base Sepolia, chain id 84532. KURV para desarrolladores enumera los puntos de entrada disponibles. Los precios y las comisiones dependen de la colección: lee Comisiones y Riesgos y aviso legal.