Endpoint reference

All 48 endpoints live under https://api.cctools.network, return the standard { data, pagination, meta } envelope, and require the X-API-Key header. The one exception is /api/v1/public/status, which needs no key and answers with its payload directly. List endpoints accept ?limit= and ?offset=. The common shape is a default of 50 and a maximum of 200, but several lists cap lower (50 or 100) and a few ignore limit entirely. Read the limit echoed back in pagination rather than assuming. A value outside the accepted range is clamped to the nearest valid one silently; it never returns an error. pagination.total is the real total on most lists. On /news and /markets/tokens it is only the size of the page you got back, so paginate until you receive fewer items than your limit instead of comparing against total.

Replace cck_... with one of your keys from /profile/api. An interactive explorer with a live Send button is at cctools.network/api-docs.

Cold cache. Most endpoints served from a cron-warmed cache answer 503 with code warming_up rather than returning an empty body. Treat that as a retry, not as an empty result. Three behave differently and are worth knowing before you build on them: /governance and /network/stats answer 200 with null or zero fields, and /featured-apps/{slug} answers 404, which is indistinguishable from a slug that does not exist.

There is a per-IP ceiling on top of your key’s limit. Every request to /api/, on every tier including Validator, counts against 600 requests per minute per IP address. Sustained breaches escalate to a temporary IP block, so back off when you see a 429 instead of retrying immediately. If you need a higher ceiling for a backfill, ask before you run it.

The Use column says whether the endpoint’s data may be used in a commercial product (Data plans) or is for personal use, and the Source column where the data comes from. The plans and their limits are in Plans and limits.

Ecosystem

Projects, categories, rankings, trending.

Endpoint	Description	Use	Source
`GET /api/v1/public/ecosystem/categories`	List categories with counts	Data plans	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects`	List projects	Data plans	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}`	Get project by slug	Data plans	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}/analytics`	Engagement analytics for a project	Personal use	CCTools engagement analytics
`GET /api/v1/public/ecosystem/projects/{slug}/campaigns`	Project campaigns	Data plans	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}/token`	Project token stats	Personal use	DexScreener, cached by CCTools
`GET /api/v1/public/ecosystem/rankings`	Projects ranked by metric	Data plans	CCTools ecosystem directory, ranked by upvotes, views and clicks
`GET /api/v1/public/ecosystem/trending`	Top 20 trending projects this epoch	Data plans	CCTools ecosystem directory, scored from upvotes, views and clicks

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

Canton network

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

Endpoint	Description	Use	Source
`GET /api/v1/public/assets`	Canton assets	Personal use	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	Personal use	Issuers’ CIP-56 asset registries, read by CCTools; the CC supply is from Canton Network Scan
`GET /api/v1/public/cips`	CIP reference corpus	Personal use	Canton Improvement Proposals, a static reference corpus kept by CCTools
`GET /api/v1/public/featured-apps`	Featured App registry	Data plans	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	Data plans	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	Personal use	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	Personal use	Loop Data (formerly Lighthouse) indexer data, cached by CCTools
`GET /api/v1/public/network/cc-price`	Canton Coin price	Personal use	CoinGecko, with CoinPaprika as the fallback, cached by CCTools
`GET /api/v1/public/network/history`	Network history	Personal use	Loop Data (formerly Lighthouse) indexer data, cached by CCTools
`GET /api/v1/public/network/stats`	Network stats	Personal use	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	Data plans	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	Personal use	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	Data plans	Canton Network Scan, read through api.cantonnodes.com
`GET /api/v1/public/validators/sv-votes`	Super Validator price votes	Data plans	Canton Network Scan, read through api.cantonnodes.com
`GET /api/v1/public/validators/top-app-rewards`	Top app providers by reward	Data plans	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	Data plans	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"

Markets and DeFi

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

Endpoint	Description	Use	Source
`GET /api/v1/public/markets/pools/oneswap`	OneSwap liquidity pools	Personal use	OneSwap, cached by CCTools
`GET /api/v1/public/markets/pools/send`	Send liquidity pools	Personal use	Send, cached by CCTools
`GET /api/v1/public/markets/pools/tradecraft`	Tradecraft liquidity pools	Personal use	Tradecraft, cached by CCTools
`GET /api/v1/public/markets/protocols`	Canton DeFi protocols	Personal use	DefiLlama, cached by CCTools
`GET /api/v1/public/markets/tickers`	Trading pairs	Personal use	Temple, cached by CCTools
`GET /api/v1/public/markets/tokens`	Token registry	Data plans	CCTools token registry
`GET /api/v1/public/markets/trades`	Recent trades	Personal use	Temple

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

Content and directories

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

Endpoint	Description	Use	Source
`GET /api/v1/public/academy/posts`	List Academy posts	Personal use	CCTools Academy
`GET /api/v1/public/academy/posts/{slug}`	Academy post by slug	Personal use	CCTools Academy
`GET /api/v1/public/badges`	Badge catalog	Data plans	CCTools badge catalog
`GET /api/v1/public/devtools`	Developer tooling directory	Data plans	CCTools developer tooling directory, with repository data from GitHub
`GET /api/v1/public/learn/paths`	Learn path catalog	Personal use	CCTools Learn
`GET /api/v1/public/learn/paths/{slug}`	Learn path by slug	Personal use	CCTools Learn
`GET /api/v1/public/news`	Canton news	Personal use	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"

Public profiles

Public profiles, badges, contributions, activity.

Endpoint	Description	Use	Source
`GET /api/v1/public/users/{username}`	Public profile	Personal use	CCTools community profiles
`GET /api/v1/public/users/{username}/activity`	Recent XP events	Personal use	CCTools community profiles
`GET /api/v1/public/users/{username}/badges`	Badges earned	Personal use	CCTools community profiles
`GET /api/v1/public/users/{username}/contributions`	Approved submissions + edits	Personal use	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	Description	Use	Source
`GET /api/v1/public/earn`	List opportunities	Data plans	CCTools earn opportunities
`GET /api/v1/public/earn/{slug}`	Opportunity by slug	Data plans	CCTools earn opportunities

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

Leaderboards

Top users by XP.

Endpoint	Description	Use	Source
`GET /api/v1/public/leaderboard`	Top users by total XP	Personal use	CCTools community profiles
`GET /api/v1/public/leaderboard/projects`	Project leaderboard	Data plans	CCTools engagement analytics
`GET /api/v1/public/leaderboard/validators`	Validator leaderboard	Data plans	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	Description	Use	Source
`GET /api/v1/public/status`	Service status	-	-

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

​Ecosystem

​Canton network

​Markets and DeFi

​Content and directories

​Public profiles

​Earn

​Leaderboards

​Status

Ecosystem

Canton network

Markets and DeFi

Content and directories

Public profiles

Earn

Leaderboards

Status