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

TierLimitWho
evaluation60 / minute per key and endpoint, 1,000 a day per accountIssued by our team on request, 30 days, for testing.
pro60 / minute per key and endpoint, 1,000 a day per accountIncluded with a CCTools Pro subscription. Self-service.
data120 / minute per key and endpoint, 20,000 a day per accountCommercial use, with attribution. Checkout in Canton Coin.
data_team600 / minute per key and endpointCommercial use, with attribution. Checkout in Canton Coin.
validatorNo per-key limitCanton validator operators, verified. Free for 12 months.
paidNo per-key limitCommercial 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.