API pública de CCTools

La API pública de CCTools te da acceso programático y de solo lectura a los mismos datos de Canton Network que impulsan cctools.network: el directorio del ecosistema, las campañas de Earn, las clasificaciones, los perfiles públicos de usuario, la gobernanza, las noticias y las estadísticas de la red en vivo.

URL base

https://api.cctools.network

Los endpoints con clave viven bajo el prefijo /api/v1/public/ y devuelven JSON. Una ruta más, de pago por llamada con x402 en lugar de una clave, vive bajo /api/v1/x402/: consulta Paga por llamada con x402.

Autenticación

Todos los endpoints de /api/v1/public/, excepto /api/v1/public/status, requieren una clave de API, enviada en la cabecera X-API-Key. No existe un esquema Authorization: Bearer, y una cabecera Bearer se rechaza.

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

Una clave viene con un plan de tu cuenta: consulta Los planes de un vistazo más abajo. Genera y administra tus claves en cctools.network/profile/api. Consulta Autenticación para ver el flujo completo.

Estructura de la respuesta

Las respuestas correctas comparten una misma forma:

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

data: el payload (objeto o array, según el endpoint).
pagination: presente en los endpoints de listado; null en el resto.
meta.tier: el plan de tu clave: evaluation, pro, data, data_team, validator o paid para Enterprise.
meta.rate_limit_remaining: tu tope por minuto.
meta.daily_limit_remaining: las llamadas que te quedan hoy bajo el tope diario de tu plan; null cuando tu plan no tiene ninguno.

Los errores son { "error": "message", "code": "..." } con un estado HTTP 400, 401, 403, 404, 422, 429, 500, 502 o 503; la tabla de Autenticación explica qué significa cada uno. Un 503 con el código warming_up significa que un conjunto de datos precalentado por cron tiene la caché fría: reinténtalo en un minuto en lugar de tratarlo como un resultado vacío.

Los planes de un vistazo

Una clave tiene el plan de la cuenta que la creó. El límite por minuto cuenta las solicitudes de cada clave y endpoint; el límite diario cuenta las llamadas de toda la cuenta durante un día UTC.

Plan	Uso	Por minuto	Por día	Cómo
Evaluation	Solo para pruebas	60 por minuto	1.000 por día	Una clave que emite nuestro equipo a petición
Pro	Uso personal	60 por minuto	1.000 por día	Incluido con CCTools Pro. Al instante, en autoservicio en /profile/api
Data Starter	Uso comercial, con atribución	120 por minuto	20.000 por día	Se compra en Canton Coin en /profile/api, mensual o anual
Data Team	Uso comercial, con atribución	600 por minuto	Sin tope diario	Se compra en Canton Coin en /profile/api, mensual o anual
Validator	Uso comercial de los endpoints marcados como Planes Data, según lo aprobado en nuestro grant del Canton Development Fund	Sin límite por clave	Sin tope diario	Envía tu party ID; lo revisa una persona, normalmente en un día hábil. Gratis durante 12 meses
Enterprise	Uso comercial dentro de tu producto, según el pedido acordado	Sin límite por clave	Sin tope diario	Contáctanos

Todos los planes, incluido Validator, están además sujetos a un tope de 600 solicitudes por minuto por dirección IP en toda la API. Los precios, el número de claves que permite cada plan y la tabla completa están en Planes y límites, generada a partir de la spec de la API. Las mismas cifras están en cctools.network/api-docs, y los términos que se aplican a todos los planes en cctools.network/terms/api.

Gratis y sin clave

Estos recursos no necesitan clave ni cuenta, y todos se sirven desde https://api.cctools.network:

El registro diario abierto de la red, en /api/open/network-record/v1/, publicado bajo CC BY 4.0.
Los feeds que leen los agregadores, en /api/markets/.
El endpoint de estado, /api/v1/public/status.
El archivo OpenAPI, /api/v1/openapi.json.
El servidor MCP, /api/mcp.

Todo lo demás bajo /api/v1/public/ necesita una clave.

Próximos pasos

Inicio rápido

Consigue un plan y una clave, y haz tu primera llamada en dos minutos.

Autenticación

Claves, planes, límites de solicitudes y códigos de error.

Planes y límites

Precios, límites y para qué puede usarse cada plan.

Endpoints

Todos los endpoints de solo lectura con un ejemplo listo para copiar y pegar.

Administrar claves

Elige un plan y luego crea, lista y revoca tus claves.

Pruébalo en vivo

Ejecuta cualquier endpoint con tu propia clave desde el navegador.

Términos de la API

Qué permite cada plan, la atribución y el pago.

Canton es una marca registrada de Digital Asset (Switzerland) GmbH. Digital Asset no está afiliada a CCTools, y no lo ha patrocinado ni respaldado.

​URL base

​Autenticación

​Estructura de la respuesta

​Los planes de un vistazo

​Gratis y sin clave

​Próximos pasos

Inicio rápido

Autenticación

Planes y límites

Endpoints

Administrar claves

Pruébalo en vivo

Términos de la API

URL base

Autenticación

Estructura de la respuesta

Los planes de un vistazo

Gratis y sin clave

Próximos pasos