Referência de endpoints

Os 48 endpoints ficam sob https://api.cctools.network, devolvem o envelope padrão { data, pagination, meta } e exigem o header X-API-Key. A única exceção é /api/v1/public/status, que não precisa de chave e responde direto com o payload. Os endpoints de listagem aceitam ?limit= e ?offset=. O formato comum é padrão de 50 e máximo de 200, mas várias listas têm teto menor (50 ou 100) e algumas ignoram limit por completo. Leia o limit devolvido em pagination em vez de supor. Um valor fora da faixa aceita é ajustado em silêncio para o valor válido mais próximo; nunca retorna erro. pagination.total é o total real na maioria das listas. Em /news e /markets/tokens ele é apenas o tamanho da página que você recebeu, então pagine até receber menos itens que o seu limit em vez de comparar com total.

Troque cck_... por uma das suas chaves em /profile/api. Existe um explorador interativo com botão de envio ao vivo em cctools.network/api-docs.

Cache frio. A maioria dos endpoints servidos por um cache aquecido por cron responde 503 com o código warming_up em vez de devolver um corpo vazio. Trate isso como nova tentativa, não como resultado vazio. Três se comportam de outro jeito e vale saber antes de construir em cima deles: /governance e /network/stats respondem 200 com campos nulos ou zerados, e /featured-apps/{slug} responde 404, indistinguível de um slug que não existe.

Existe um teto por IP além do limite da sua chave. Toda requisição a /api/, em todos os tiers incluindo o Validator, conta contra um teto de 600 requisições por minuto por endereço IP. Excessos sustentados escalam para um bloqueio temporário do IP, então recue quando vir um 429 em vez de tentar de novo na hora. Se você precisa de um teto maior para uma carga histórica, avise antes de rodar.

A coluna Uso diz se os dados do endpoint podem ser usados em um produto comercial (Planos Data) ou são para uso pessoal, e a coluna Fonte de onde vêm. Os planos e seus limites estão em Planos e limites.

Ecossistema

Projects, categories, rankings, trending.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/ecosystem/categories`	List categories with counts	Planos Data	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects`	List projects	Planos Data	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}`	Get project by slug	Planos Data	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}/analytics`	Engagement analytics for a project	Uso pessoal	CCTools engagement analytics
`GET /api/v1/public/ecosystem/projects/{slug}/campaigns`	Project campaigns	Planos Data	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}/token`	Project token stats	Uso pessoal	DexScreener, cached by CCTools
`GET /api/v1/public/ecosystem/rankings`	Projects ranked by metric	Planos Data	CCTools ecosystem directory, ranked by upvotes, views and clicks
`GET /api/v1/public/ecosystem/trending`	Top 20 trending projects this epoch	Planos Data	CCTools ecosystem directory, scored from upvotes, views and clicks

curl -H "X-API-Key: cck_..." \
  "https://api.cctools.network/api/v1/public/ecosystem/categories"

Rede Canton

Canton network data: validators, Super Validators, Featured Apps, governance, burn and mint, CIPs.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/assets`	Canton assets	Uso pessoal	Issuers’ CIP-56 asset registries, read by CCTools; the CC supply is from Canton Network Scan
`GET /api/v1/public/assets/{slug}`	Canton asset detail	Uso pessoal	Issuers’ CIP-56 asset registries, read by CCTools; the CC supply is from Canton Network Scan
`GET /api/v1/public/cips`	CIP reference corpus	Uso pessoal	Canton Improvement Proposals, a static reference corpus kept by CCTools
`GET /api/v1/public/featured-apps`	Featured App registry	Planos Data	Canton Network Scan, read through api.cantonnodes.com. Reward totals are frozen at the last round the provider aggregated, the round each response gives in rewards_as_of_round, closed at rewards_as_of.
`GET /api/v1/public/featured-apps/{slug}`	Featured App detail	Planos Data	Canton Network Scan, read through api.cantonnodes.com. Reward totals are frozen at the last round the provider aggregated, the round each response gives in rewards_as_of_round, closed at rewards_as_of.
`GET /api/v1/public/governance`	Governance proposals	Uso pessoal	Loop Data (formerly Lighthouse) indexer data, cached by CCTools for the proposals; Canton Network Scan for the Super Validators, their count, weights and price votes, the vote threshold and each Super Validator’s vote on the open proposals; the CCTools directory for the projects behind requesters, targets and Super Validators
`GET /api/v1/public/network/burn-mint`	Burn and mint volume	Uso pessoal	Loop Data (formerly Lighthouse) indexer data, cached by CCTools
`GET /api/v1/public/network/cc-price`	Canton Coin price	Uso pessoal	CoinGecko, with CoinPaprika as the fallback, cached by CCTools
`GET /api/v1/public/network/history`	Network history	Uso pessoal	Loop Data (formerly Lighthouse) indexer data, cached by CCTools
`GET /api/v1/public/network/stats`	Network stats	Uso pessoal	Loop Data (formerly Lighthouse) indexer data, cached by CCTools; the CC price is from CoinGecko, with CoinPaprika as the fallback
`GET /api/v1/public/validators`	List validators	Planos Data	Canton Network Scan, read through api.cantonnodes.com. Reward totals are frozen at the last round the provider aggregated, the round each response gives in rewards_as_of_round, closed at rewards_as_of.
`GET /api/v1/public/validators/{partyId}`	Validator detail	Uso pessoal	Loop Data (formerly Lighthouse) indexer data, cached by CCTools; the ranking is from Canton Network Scan
`GET /api/v1/public/validators/super-validators`	Super Validators	Planos Data	Canton Network Scan, read through api.cantonnodes.com
`GET /api/v1/public/validators/sv-votes`	Super Validator price votes	Planos Data	Canton Network Scan, read through api.cantonnodes.com
`GET /api/v1/public/validators/top-app-rewards`	Top app providers by reward	Planos Data	Canton Network Scan, read through api.cantonnodes.com. Reward totals are frozen at the last round the provider aggregated, the round each response gives in rewards_as_of_round, closed at rewards_as_of.
`GET /api/v1/public/validators/top-rewards`	Top validators by reward	Planos Data	Canton Network Scan, read through api.cantonnodes.com. Reward totals are frozen at the last round the provider aggregated, the round each response gives in rewards_as_of_round, closed at rewards_as_of.

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

Mercados e DeFi

DeFi and trading: protocol TVL, token registry, liquidity pools, tickers and trades.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/markets/pools/oneswap`	OneSwap liquidity pools	Uso pessoal	OneSwap, cached by CCTools
`GET /api/v1/public/markets/pools/send`	Send liquidity pools	Uso pessoal	Send, cached by CCTools
`GET /api/v1/public/markets/pools/tradecraft`	Tradecraft liquidity pools	Uso pessoal	Tradecraft, cached by CCTools
`GET /api/v1/public/markets/protocols`	Canton DeFi protocols	Uso pessoal	DefiLlama, cached by CCTools
`GET /api/v1/public/markets/tickers`	Trading pairs	Uso pessoal	Temple, cached by CCTools
`GET /api/v1/public/markets/tokens`	Token registry	Planos Data	CCTools token registry
`GET /api/v1/public/markets/trades`	Recent trades	Uso pessoal	Temple

curl -H "X-API-Key: cck_..." \
  "https://api.cctools.network/api/v1/public/markets/pools/oneswap"

Conteúdo e diretórios

Academy posts, learn paths, news, developer tooling and the badge catalog.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/academy/posts`	List Academy posts	Uso pessoal	CCTools Academy
`GET /api/v1/public/academy/posts/{slug}`	Academy post by slug	Uso pessoal	CCTools Academy
`GET /api/v1/public/badges`	Badge catalog	Planos Data	CCTools badge catalog
`GET /api/v1/public/devtools`	Developer tooling directory	Planos Data	CCTools developer tooling directory, with repository data from GitHub
`GET /api/v1/public/learn/paths`	Learn path catalog	Uso pessoal	CCTools Learn
`GET /api/v1/public/learn/paths/{slug}`	Learn path by slug	Uso pessoal	CCTools Learn
`GET /api/v1/public/news`	Canton news	Uso pessoal	News publishers, named on each item (source and source_url)

curl -H "X-API-Key: cck_..." \
  "https://api.cctools.network/api/v1/public/academy/posts"

Perfis públicos

Public profiles, badges, contributions, activity.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/users/{username}`	Public profile	Uso pessoal	CCTools community profiles
`GET /api/v1/public/users/{username}/activity`	Recent XP events	Uso pessoal	CCTools community profiles
`GET /api/v1/public/users/{username}/badges`	Badges earned	Uso pessoal	CCTools community profiles
`GET /api/v1/public/users/{username}/contributions`	Approved submissions + edits	Uso pessoal	CCTools community profiles

curl -H "X-API-Key: cck_..." \
  "https://api.cctools.network/api/v1/public/users/sharpagent358"

Earn

Opportunities (campaigns, app rewards, community).

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/earn`	List opportunities	Planos Data	CCTools earn opportunities
`GET /api/v1/public/earn/{slug}`	Opportunity by slug	Planos Data	CCTools earn opportunities

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

Classificações

Top users by XP.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/leaderboard`	Top users by total XP	Uso pessoal	CCTools community profiles
`GET /api/v1/public/leaderboard/projects`	Project leaderboard	Planos Data	CCTools engagement analytics
`GET /api/v1/public/leaderboard/validators`	Validator leaderboard	Planos Data	Canton Network Scan, read through api.cantonnodes.com. Reward totals are frozen at the last round the provider aggregated, the round each response gives in rewards_as_of_round, closed at rewards_as_of.

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

Status

Service health and incidents. No key needed.

Endpoint	Descrição	Uso	Fonte
`GET /api/v1/public/status`	Service status	-	-

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

​Ecossistema

​Rede Canton

​Mercados e DeFi

​Conteúdo e diretórios

​Perfis públicos

​Earn

​Classificações

​Status

Ecossistema

Rede Canton

Mercados e DeFi

Conteúdo e diretórios

Perfis públicos

Earn

Classificações

Status