Saltar al contenido principal
Los 48 endpoints viven bajo https://api.cctools.network, devuelven el envoltorio estándar { data, pagination, meta } y requieren el header X-API-Key. La única excepción es /api/v1/public/status, que no necesita clave y responde directamente con su payload. Los endpoints de listado aceptan ?limit= y ?offset=. Lo habitual es un valor por defecto de 50 y un máximo de 200, pero varias listas tienen topes más bajos (50 o 100) y algunas ignoran limit por completo. Lee el limit que viene de vuelta en pagination en lugar de darlo por sentado. Un valor fuera del rango aceptado se ajusta en silencio al valor válido más cercano; nunca devuelve un error. pagination.total es el total real en la mayoría de las listas. En /news y /markets/tokens es solo el tamaño de la página que recibiste, así que pagina hasta recibir menos elementos que tu limit en vez de compararlo con total.
Sustituye cck_... por una de tus claves de /profile/api. Hay un explorador interactivo con botón de envío en vivo en cctools.network/api-docs.
Caché en frío. La mayoría de los endpoints servidos desde una caché calentada por cron responden 503 con el código warming_up en lugar de devolver un cuerpo vacío. Trátalo como un reintento, no como un resultado vacío. Tres se comportan de otra manera y conviene saberlo antes de construir sobre ellos: /governance y /network/stats responden 200 con campos nulos o en cero, y /featured-apps/{slug} responde 404, indistinguible de un slug que no existe.
Hay un tope por IP además del límite de tu clave. Cada solicitud a /api/, en todos los tiers incluido Validator, cuenta contra un tope de 600 solicitudes por minuto por dirección IP. Los excesos sostenidos escalan a un bloqueo temporal de la IP, así que retrocede cuando veas un 429 en lugar de reintentar de inmediato. Si necesitas un tope mayor para una carga histórica, avísanos antes de ejecutarla.
La columna Uso dice si los datos del endpoint pueden usarse en un producto comercial (Planes Data) o son para uso personal, y la columna Fuente de dónde vienen. Los planes y sus límites están en Planes y límites.

Ecosistema

Projects, categories, rankings, trending.

Red Canton

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

Mercados y DeFi

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

Contenido y directorios

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

Perfiles públicos

Public profiles, badges, contributions, activity.

Earn

Opportunities (campaigns, app rewards, community).

Clasificaciones

Top users by XP.

Estado

Service health and incidents. No key needed.