Endpoint 参考

全部 48 个 endpoint 都位于 https://api.cctools.network 下，返回标准的 { data, pagination, meta } 信封结构，并且需要 X-API-Key header。唯一的例外是 /api/v1/public/status，它无需密钥，直接返回自身的 payload。列表类 endpoint 接受 ?limit= 和 ?offset=。常见形式是默认 50、最大 200，但有几个列表的上限更低（50 或 100），还有几个完全忽略 limit。请读取 pagination 中回传的 limit，不要凭假设。超出可接受范围的值会被静默地调整为最接近的有效值，而不会返回错误。在大多数列表中，pagination.total 是真实总数。但在 /news 和 /markets/tokens 中，它只是你这一页拿到的条数，所以请分页直到收到的条目少于你的 limit，而不要拿它和 total 比较。

把 cck_... 替换为你在 /profile/api 中的任意一个密钥。 cctools.network/api-docs 提供了带实时发送按钮的交互式浏览器。

冷缓存。 大多数由 cron 预热缓存提供的 endpoint 在缓存为空时会返回 503 并带上 warming_up 代码，而不是返回空内容。请把它当作需要重试，而不是空结果。有三个的行为不同，在基于它们开发之前值得了解：/governance 和 /network/stats 会返回 200，字段为 null 或 0；/featured-apps/{slug} 会返回 404，这与 slug 不存在无法区分。

除了密钥自身的限制之外，还有一个按 IP 的上限。 对 /api/ 的每一次请求，在包括 Validator 在内的所有套餐上，都会计入每个 IP 地址每分钟 600 次请求的上限。持续超限会升级为对该 IP 的临时封禁，所以看到 429 时请退避，不要立即重试。如果你需要更高的上限来做一次历史回填，请先告诉我们再执行。

“用途”列说明该 endpoint 的数据可否用于商业产品（Data 套餐）还是仅供个人使用，“来源”列说明数据来自哪里。各套餐及其限制见套餐与限制。

生态系统

Projects, categories, rankings, trending.

Endpoint	说明	用途	来源
`GET /api/v1/public/ecosystem/categories`	List categories with counts	Data 套餐	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects`	List projects	Data 套餐	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}`	Get project by slug	Data 套餐	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}/analytics`	Engagement analytics for a project	个人使用	CCTools engagement analytics
`GET /api/v1/public/ecosystem/projects/{slug}/campaigns`	Project campaigns	Data 套餐	CCTools ecosystem directory
`GET /api/v1/public/ecosystem/projects/{slug}/token`	Project token stats	个人使用	DexScreener, cached by CCTools
`GET /api/v1/public/ecosystem/rankings`	Projects ranked by metric	Data 套餐	CCTools ecosystem directory, ranked by upvotes, views and clicks
`GET /api/v1/public/ecosystem/trending`	Top 20 trending projects this epoch	Data 套餐	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 网络

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

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

市场与 DeFi

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

Endpoint	说明	用途	来源
`GET /api/v1/public/markets/pools/oneswap`	OneSwap liquidity pools	个人使用	OneSwap, cached by CCTools
`GET /api/v1/public/markets/pools/send`	Send liquidity pools	个人使用	Send, cached by CCTools
`GET /api/v1/public/markets/pools/tradecraft`	Tradecraft liquidity pools	个人使用	Tradecraft, cached by CCTools
`GET /api/v1/public/markets/protocols`	Canton DeFi protocols	个人使用	DefiLlama, cached by CCTools
`GET /api/v1/public/markets/tickers`	Trading pairs	个人使用	Temple, cached by CCTools
`GET /api/v1/public/markets/tokens`	Token registry	Data 套餐	CCTools token registry
`GET /api/v1/public/markets/trades`	Recent trades	个人使用	Temple

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

内容与目录

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

Endpoint	说明	用途	来源
`GET /api/v1/public/academy/posts`	List Academy posts	个人使用	CCTools Academy
`GET /api/v1/public/academy/posts/{slug}`	Academy post by slug	个人使用	CCTools Academy
`GET /api/v1/public/badges`	Badge catalog	Data 套餐	CCTools badge catalog
`GET /api/v1/public/devtools`	Developer tooling directory	Data 套餐	CCTools developer tooling directory, with repository data from GitHub
`GET /api/v1/public/learn/paths`	Learn path catalog	个人使用	CCTools Learn
`GET /api/v1/public/learn/paths/{slug}`	Learn path by slug	个人使用	CCTools Learn
`GET /api/v1/public/news`	Canton news	个人使用	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, badges, contributions, activity.

Endpoint	说明	用途	来源
`GET /api/v1/public/users/{username}`	Public profile	个人使用	CCTools community profiles
`GET /api/v1/public/users/{username}/activity`	Recent XP events	个人使用	CCTools community profiles
`GET /api/v1/public/users/{username}/badges`	Badges earned	个人使用	CCTools community profiles
`GET /api/v1/public/users/{username}/contributions`	Approved submissions + edits	个人使用	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	说明	用途	来源
`GET /api/v1/public/earn`	List opportunities	Data 套餐	CCTools earn opportunities
`GET /api/v1/public/earn/{slug}`	Opportunity by slug	Data 套餐	CCTools earn opportunities

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

排行榜

Top users by XP.

Endpoint	说明	用途	来源
`GET /api/v1/public/leaderboard`	Top users by total XP	个人使用	CCTools community profiles
`GET /api/v1/public/leaderboard/projects`	Project leaderboard	Data 套餐	CCTools engagement analytics
`GET /api/v1/public/leaderboard/validators`	Validator leaderboard	Data 套餐	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"

状态

Service health and incidents. No key needed.

Endpoint	说明	用途	来源
`GET /api/v1/public/status`	Service status	-	-

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

​生态系统

​Canton 网络

​市场与 DeFi

​内容与目录

​公开资料

​Earn

​排行榜

​状态

生态系统

Canton 网络

市场与 DeFi

内容与目录

公开资料

Earn

排行榜

状态