APIs públicas

Pedido	Resultado
GET /api/v1	Versão, ambiente, cadeias suportadas e capacidades
GET /api/v1/collections?limit=20&offset=0&chain=84532	Configuração pública das coleções e ligações de integração
GET /api/v1/collections/84532/{contract_address}	Uma coleção registada, incluindo os números da cadeia em cache
GET /api/v1/collections/solana:devnet/{address}	Uma coleção registada da Solana
GET /api/v1/contracts/kurvdrop	ABI pública do KurvDrop, incluindo cotações e cunhagem
POST /api/v1/collections/84532/{contract_address}/mint-call	Uma cotação recente e as chamadas exatas para um comprador: Cunhar a partir da 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 indicam também links.mint_window, a janela do KURV que a cunha, e links.mint_call, o endereço do plano de cunhagem. Ambos são null numa coleção trazida de outro local. mint-call é o único POST: lê a rede, não altera nada no KURV e não assina nada.

Todas as rotas públicas da API enviam Access-Control-Allow-Origin: * e só aceitam leituras. Não precisam de cookies. As listas aceitam um limite de 1 a 50 e um deslocamento de 0 a 200; pagination.next_offset é null no fim. A versão 1 expõe uma janela com os 200 registos visíveis mais recentes do catálogo, e não um índice histórico ilimitado. A rota de detalhe também suporta coleções registadas a que se chega pelo endereço direto.

Os montantes e as contagens de oferta são cadeias de texto decimais, para preservar a precisão dos inteiros. Os montantes usam a unidade mais pequena do token de pagamento da coleção. Leia decimals() e symbol() desse token antes de formatar; nunca parta do princípio de que todas as coleções são liquidadas em USDC com seis casas decimais. max_supply vem da configuração do lançamento até o estado da cadeia estar disponível. total_minted é null até haver uma leitura, em vez de um zero inventado.

As leituras de detalhe reutilizam a cache partilhada da cadeia do KURV, de 15 segundos. reading.read_at regista quando uma leitura teve êxito; reading.status: "stale_or_unavailable" significa que a tentativa mais recente falhou e que os números que existirem são da última leitura bem-sucedida. Uma cotação nesta resposta é apenas informativa, para uma peça na fase ativa predefinida, e não prova que a carteira possa cunhar. Obtenha um quoteMint atualizado imediatamente antes de assinar.

Os media e as raízes de metadados dos tokens por revelar ficam retidos. Uma pré-visualização publicada à parte pode continuar visível. Listas de acesso privadas, listas de ficheiros de 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 estado 400, 404 ou 503.

Use https://testnet.kurv.fun para Base Sepolia, chain id 84532. KURV para programadores lista os pontos de entrada disponíveis. Os preços e as comissões dependem da coleção: leia Comissões e Riscos e aviso legal.