APIs públicas

Pedido	Resultado
GET /api/v1	Versão, ambiente, redes aceitas e recursos
GET /api/v1/collections?limit=20&offset=0&chain=84532	Configuração pública das coleções e links de integração
GET /api/v1/collections/84532/{contract_address}	Uma coleção registrada, com os números da blockchain em cache
GET /api/v1/collections/solana:devnet/{address}	Uma coleção registrada da Solana
GET /api/v1/contracts/kurvdrop	ABI pública do KurvDrop, com cotações e cunhagem
POST /api/v1/collections/84532/{contract_address}/mint-call	Uma cotação recente e as chamadas exatas para um comprador: Cunhe pela sua 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());

Os links de cada coleção também trazem links.mint_window, a janela do KURV que a cunha, e links.mint_call, o endereço do plano de cunhagem. Os dois são null em uma coleção trazida de outro lugar. mint-call é o único POST: lê a rede, não altera nada no KURV e não assina nada.

Todas as rotas da API pública enviam Access-Control-Allow-Origin: * e aceitam só leituras. Elas não exigem cookies. As listas aceitam um limit de 1 a 50 e um offset de 0 a 200; pagination.next_offset é null no fim. A versão 1 expõe uma janela com os 200 registros visíveis mais recentes do catálogo, e não um índice histórico sem limite. A rota de detalhe também aceita coleções registradas acessadas pelo endereço direto.

Os valores e as contagens de oferta são strings decimais, para preservar a precisão dos inteiros. Os valores usam a menor unidade do token de pagamento da coleção. Leia decimals() e symbol() desse token antes de formatar; nunca presuma que toda coleção é liquidada em USDC com seis casas decimais. max_supply vem da configuração do lançamento até o estado da blockchain estar disponível. total_minted é null até existir uma leitura, em vez de um zero inventado.

As leituras de detalhe reaproveitam o cache compartilhado de 15 segundos que o KURV mantém da blockchain. reading.read_at registra quando uma leitura deu certo; reading.status: "stale_or_unavailable" significa que a última tentativa falhou e que os números pertencem à última leitura bem-sucedida. Uma cotação nesta resposta é informativa, para uma peça na fase ativa padrão, e não prova que a carteira pode cunhar. Obtenha um quoteMint novo imediatamente antes de assinar.

As mídias e as raízes de metadados dos tokens ainda não revelados ficam retidas. Uma prévia publicada à parte pode continuar visível. Listas de acesso privadas, listas de arquivos da publicação, sementes, credenciais de conta e erros brutos de infraestrutura nunca são incluídos na versão 1. Os erros usam { "api_version": "1", "error": { "code": "...", "message": "..." } } com os códigos de status 400, 404 ou 503.

Use https://testnet.kurv.fun para a Base Sepolia, chain id 84532. KURV para desenvolvedores lista os pontos de entrada disponíveis. Os preços e as taxas dependem da coleção: leia Taxas e Riscos e isenção de responsabilidade.