API documentation
Read-only access to the Canton ecosystem as CCTools sees it: the validator and Featured App registries, governance, burn and mint, DeFi protocol TVL and liquidity, the project directory with scoring, learn and Academy content, and public profiles.
Authentication
Every /api/v1/public endpoint except /api/v1/public/status requires an X-Api-Key header; /api/v1/x402/markets/tickers takes an x402 payment instead, and the open record files under /api/open/network-record/v1/ need neither. Keys look like cck_ followed by 56 hex characters. Request one from your profile. Canton validator operators can ask for verification there: once approved, the Validator tier is free for 12 months, with no limit on the key, under the 600 requests a minute per IP every client gets.
Kept in this browser only, never sent anywhere except the API request you trigger.
Tiers and rate limits
| Tier | Limit | Who |
|---|---|---|
evaluation | 60 / minute per key and endpoint, 1,000 a day per account | Issued by our team on request, 30 days, for testing. |
pro | 60 / minute per key and endpoint, 1,000 a day per account | Included with a CCTools Pro subscription. Self-service. |
data | 120 / minute per key and endpoint, 20,000 a day per account | Commercial use, with attribution. Checkout in Canton Coin. |
data_team | 600 / minute per key and endpoint | Commercial use, with attribution. Checkout in Canton Coin. |
validator | No per-key limit | Canton validator operators, verified. Free for 12 months. |
paid | No per-key limit | Commercial use inside your product, under an agreed order. Contact us. |
Responses carry the remaining allowance in meta.rate_limit_remaining. Over the limit returns 429 with a Retry-After header.
Response shape
{
"data": …,
"pagination": { "limit": 50, "offset": 0, "total": 123 } | null,
"meta": { "tier": "validator", "rate_limit_remaining": null, "daily_limit_remaining": null }
}Errors return { "error", "code" }. Endpoints served from a cron-warmed cache answer 503 warming_up on a cold cache rather than an empty body, so treat that as a retry, not an empty result.
Endpoints51
ecosystem
Projects, categories, rankings, trending.
canton
Canton network data: validators, Super Validators, Featured Apps, governance, burn and mint, CIPs.
markets
DeFi and trading: protocol TVL, token registry, liquidity pools, tickers and trades.
content
Academy posts, learn paths, news, developer tooling and the badge catalog.
status
Service health and incidents. No key needed.
users
Public profiles, badges, contributions, activity.
earn
Opportunities (campaigns, app rewards, community).
leaderboard
Top users by XP.
auth
Self-service API key management + eligibility.