API pública do CCTools

A API pública do CCTools oferece acesso programático e somente leitura aos mesmos dados da Canton Network que alimentam o cctools.network: o diretório do ecossistema, as campanhas de earn, os leaderboards, os perfis públicos de usuários, a governança, as notícias e as estatísticas da rede em tempo real.

URL base

https://api.cctools.network

Os endpoints com chave ficam sob o prefixo /api/v1/public/ e retornam JSON. Mais uma rota, paga por chamada com x402 em vez de uma chave, fica sob /api/v1/x402/: veja Pague por chamada com x402.

Autenticação

Todos os endpoints de /api/v1/public/, exceto /api/v1/public/status, exigem uma chave de API, enviada no header X-API-Key. Não existe esquema Authorization: Bearer, e um header Bearer é rejeitado.

curl -H "X-API-Key: cck_your_key_here" \
  "https://api.cctools.network/api/v1/public/network/stats"

Uma chave vem com um plano da sua conta: veja Os planos em resumo, mais abaixo. Gere e gerencie suas chaves em cctools.network/profile/api. Veja Autenticação para o fluxo completo.

Envelope de resposta

As respostas bem-sucedidas compartilham um mesmo formato:

{
  "data": { "...": "..." },
  "pagination": { "limit": 50, "offset": 0, "total": 491 },
  "meta": { "tier": "pro", "rate_limit_remaining": 60, "daily_limit_remaining": 999 }
}

data: o payload (objeto ou array, dependendo do endpoint).
pagination: presente nos endpoints de listagem; null nos demais.
meta.tier: o plano da sua chave: evaluation, pro, data, data_team, validator ou paid para o Enterprise.
meta.rate_limit_remaining: seu teto por minuto.
meta.daily_limit_remaining: as chamadas que restam hoje sob o limite diário do seu plano; null quando o seu plano não tem nenhum.

Os erros vêm como { "error": "message", "code": "..." } com status HTTP 400, 401, 403, 404, 422, 429, 500, 502 ou 503; a tabela de Autenticação explica o que cada um significa. Um 503 com o código warming_up indica que um conjunto de dados aquecido por cron está com o cache frio: tente de novo em um minuto, em vez de tratar isso como um resultado vazio.

Os planos em resumo

Uma chave tem o plano da conta que a criou. O limite por minuto conta as requisições de cada chave e endpoint; o limite diário conta as chamadas da conta inteira ao longo de um dia UTC.

Plano	Uso	Por minuto	Por dia	Como
Evaluation	Somente para testes	60 por minuto	1.000 por dia	Uma chave que nossa equipe emite sob pedido
Pro	Uso pessoal	60 por minuto	1.000 por dia	Incluído no CCTools Pro. Na hora, em autoatendimento em /profile/api
Data Starter	Uso comercial, com atribuição	120 por minuto	20.000 por dia	Comprado em Canton Coin em /profile/api, mensal ou anual
Data Team	Uso comercial, com atribuição	600 por minuto	Sem limite diário	Comprado em Canton Coin em /profile/api, mensal ou anual
Validator	Uso comercial dos endpoints marcados como Planos Data, conforme aprovado no nosso grant do Canton Development Fund	Sem limite por chave	Sem limite diário	Envie o party ID; revisado por uma pessoa, normalmente em até um dia útil. Gratuito por 12 meses
Enterprise	Uso comercial dentro do seu produto, conforme o pedido combinado	Sem limite por chave	Sem limite diário	Fale conosco

Todos os planos, incluindo o Validator, também estão sujeitos a um teto de 600 requisições por minuto por endereço IP em toda a API. Os preços, o número de chaves que cada plano permite e a tabela completa estão em Planos e limites, gerada a partir da spec da API. Os mesmos números estão em cctools.network/api-docs, e os termos que valem para todos os planos estão em cctools.network/terms/api.

Gratuito e sem chave

Estes recursos não precisam de chave nem de conta, e todos são servidos em https://api.cctools.network:

O registro diário aberto da rede, em /api/open/network-record/v1/, publicado sob CC BY 4.0.
Os feeds que os agregadores leem, em /api/markets/.
O endpoint de status, /api/v1/public/status.
O arquivo OpenAPI, /api/v1/openapi.json.
O servidor MCP, /api/mcp.

Todo o resto sob /api/v1/public/ exige uma chave.

Próximos passos

Início rápido

Consiga um plano e uma chave, e faça sua primeira chamada em dois minutos.

Autenticação

Chaves, planos, limites de requisições e códigos de erro.

Planos e limites

Preços, limites e para que cada plano pode ser usado.

Endpoints

Todos os endpoints somente leitura com um exemplo pronto para copiar e colar.

Gerenciar chaves

Escolha um plano e depois crie, liste e revogue suas chaves.

Teste ao vivo

Rode qualquer endpoint com a sua própria chave direto no navegador.

Termos da API

O que cada plano permite, a atribuição e o pagamento.

Canton é uma marca registrada da Digital Asset (Switzerland) GmbH. A Digital Asset não é afiliada ao CCTools e não o patrocinou nem o endossou.

​URL base

​Autenticação

​Envelope de resposta

​Os planos em resumo

​Gratuito e sem chave

​Próximos passos

Início rápido

Autenticação

Planos e limites

Endpoints

Gerenciar chaves

Teste ao vivo

Termos da API

URL base

Autenticação

Envelope de resposta

Os planos em resumo

Gratuito e sem chave

Próximos passos