# CC Space Canton Network explorer and data API by ITRocket. Indexed ledger data — updates, transfers, rewards, parties, validators, burns, CNS names, featured apps, locking, instruments and prices — over REST. Base URL: https://cc-api.itrocket.space Two ways to pay: per request in Canton Coin without an account, or with an API key billed in credits. ## Agent API — no signup, no API key, pay in CC or USDCx Price list: GET https://cc-api.itrocket.space/x402/rate-card Data: GET https://cc-api.itrocket.space/x402/api/v1/{endpoint} Any /api/v1 endpoint is reachable by prefixing its path with /x402. /x402/api/v1/stats returns exactly what /api/v1/stats returns. 1. Send the request without payment. The response is 402 with a PAYMENT-REQUIRED header: base64 JSON whose accepts[] holds one quote per accepted instrument, each with amount, asset, payTo, feePayer, assetTransferMethod, synchronizerId and instrumentId. 2. Pick one quote. Canton Coin is always accepts[0], so taking the first entry needs no instrument logic; to pay in another instrument run canton-agent-wallet pay --asset (wallet >= 1.2.0) — it signs the matching accepts[] entry, fails closed listing what IS offered when the id is not there, and omitting --asset pays the first entry. Spending a registry token also needs the payer's own CANTON_AGENT_PAYABLE_INSTRUMENTS opt-in. (The earlier ?pay= query parameter is retired; URLs carrying it degrade harmlessly — it is ignored.) Sign a TransferFactory_Transfer on Canton mainnet for exactly that quote, naming the merchant as receiver. Do not submit it; the facilitator relays it and pays the traffic, settling in one transaction. 3. Resend the request with a PAYMENT-SIGNATURE header. 4. The response carries the data and a PAYMENT-RESPONSE settlement receipt. Accepted instruments, at the time of writing: Canton Coin at 0.0254 CC per request, and USDCx (admin decentralized-usdc-interchain-rep) priced at the same USD value, tracked from the on-ledger governance price. Network canton:mainnet, facilitator https://facilitator.ftptech.xyz. Call GET /x402/rate-card for current prices rather than caching a number — the USDCx one moves with the CC price. Sign only a quote the door advertised: a PAYMENT-SIGNATURE whose accepted block matches no advertised quote is refused with 402 and never reaches the facilitator. One payment buys one response. Settlement happens before the upstream is called, and the settlement id is redeemable once — replaying a PAYMENT-SIGNATURE that was already served returns 402 payment_already_redeemed. Handling failures without paying twice: - 402 on a signed request — refused, nothing settled, no data. - 502 — read the error string. One form states nothing settled and the same payment can safely be retried; the others state that the payment may have settled, so do NOT sign a new transfer. In both cases resend the IDENTICAL PAYMENT-SIGNATURE: a repeated settle of the same signed bytes is idempotent at the facilitator, so the retry delivers without charging twice. - A 4xx from the upstream endpoint is a delivered answer and is charged. ## Developer API — API key, billed in credits GET https://cc-api.itrocket.space/api/v1/{endpoint} Authorization: Bearer API keys are issued from https://cc.itrocket.space under account settings. One API call costs one credit. Credits are purchased with Canton Coin at the rate shown in the account, and also pay for validator monitoring alerts. Check the balance before spending — this read is free and never billed: GET /api/v1/credits/balance -> {"balance": 4820, "freeTierBalance": 320, "paidBalance": 4500, "topUpUrl": "https://cc.itrocket.space/account#convert-panel"} The free welcome grant is spent before paid credits. Out of credits: every billed endpoint answers 402 instead of serving, and the body carries the cost, the balance and where to buy more: {"error": "insufficient credits", "message": "Out of credits: this call costs 1, your balance is 0. Top up to continue.", "required": 1, "balance": 0, "topUpUrl": "https://cc.itrocket.space/account#convert-panel"} A refused request is never served and never charged. ## Ask the API — one question, answered from live data POST https://cc-api.itrocket.space/api/v1/chat Authorization: Bearer {"messages": [{"role": "user", "content": "How many CNS names are active?"}]} An assistant that decides which endpoints answer the question, calls them with your key, and streams the answer back as server-sent events: charged (the message fee), then tool_call / tool_result / text as they happen, then done (always last, error or not). Pass "stream": false for a single JSON object. Each message costs a flat fee — chatMessageCost in https://cc-payment-mainnet.itrocket.space/api/pricing, currently 1 credit — plus the normal price of each call it makes. A message the assistant cannot answer at all is refunded; one that fetched data is not. Conversation history is yours to keep: nothing is stored here, so send the previous turns back with each message, tool_call parts and their results included. Replayed results are reused, so a follow-up costs nothing extra. ## MCP — the same endpoints for your own agent POST https://cc-api.itrocket.space/mcp Authorization: Bearer Accept: application/json, text/event-stream Model Context Protocol over Streamable HTTP, stateless. Methods: initialize, ping, tools/list, tools/call. Configure a client with: {"mcpServers": {"canton": {"url": "https://cc-api.itrocket.space/mcp", "headers": {"Authorization": "Bearer cs_live_..."}}}} Every tool is a read, and the catalogue is generated from the endpoints below. tools/list is free; a tools/call is billed as the API call it makes. There is no message fee here — you bring the model. ## Endpoints 47 endpoints in one versioned namespace, grouped as in the reference. Two are ready-made leaderboards: /api/v1/featured-apps/fees ranks featured apps by on-chain fees generated over a window (with avg_daily_markers — one marker is one featured activity record), /api/v1/featured-apps/overuse ranks them by reward-weight-per-fee ratio (the compliance question); both take period=1d|7d|30d|6m|1y|all and work through the paid /x402 door like every other endpoint. Within a group, point-in-time data comes first and time series last. An endpoint listed under two groups is one endpoint at one path. Parameters and response schemas: https://cc-api.itrocket.space/openapi.json ## Parties & Wallets ### Parties /api/v1/parties/{party_id} profile, wallet, CNS names, recent operations, reward stats /api/v1/parties/{party_id}/operations paged operations /api/v1/parties/{party_id}/rewards claimed rewards grouped by claim update /api/v1/parties/{party_id}/balance wallet balance and amulets /api/v1/party-names bulk CNS name lookup by party ID /api/v1/parties/{party_id}/reward-activity party reward volume over time /api/v1/parties/{party_id}/reward-stats party reward distribution by type /api/v1/parties/{party_id}/balance-changes party balance over time /api/v1/parties/{party_id}/cc-flow party CC earned and burned over time ### Wallets /api/v1/parties/{party_id}/balance wallet balance and amulets /api/v1/wallets/top largest balances on the network /api/v1/validators/balances balances for all validators and SVs ### CNS /api/v1/cns CNS entries /api/v1/cns/search CNS search /api/v1/party-names bulk CNS name lookup by party ID ## Validators & Super Validators ### Validators/SVs /api/v1/parties/{party_id} profile for a validator or SV — is_validator / is_sv flags, wallet, rewards /api/v1/parties/{party_id}/operations paged operations /api/v1/validators/balances balances for all validators and SVs /api/v1/validators/history/{id}/balance current balance and change over a period /api/v1/validators/history/{id}/balance/history balance time series /api/v1/validators/history/{id}/traffic current traffic overview /api/v1/validators/history/{id}/traffic/usage traffic usage delta over a period /api/v1/validators/history/{id}/traffic/purchases purchase deltas for 24h, 7d, 30d, and 3m /api/v1/validators/history/{id}/uptime uptime history over a period ## Transfers, Offers & Preapprovals ### Transfers /api/v1/transfers transfers /api/v1/transfers/{id} transfer detail /api/v1/transfer-activity transfer volume over time ### Offers /api/v1/offers offers /api/v1/offer-activity offer counts over time ### Preapprovals /api/v1/preapprovals transfer preapprovals /api/v1/preapproval-activity preapproval counts over time ### Subscriptions /api/v1/subscriptions subscriptions ## Updates ### Updates /api/v1/updates ledger updates, newest first; private verdict rows on request /api/v1/updates/{id} update detail ## Rewards & Burns ### Rewards /api/v1/rewards reward coupons /api/v1/parties/{party_id}/rewards claimed rewards grouped by claim update /api/v1/reward-activity reward volume over time /api/v1/reward-stats reward distribution by type /api/v1/parties/{party_id}/reward-activity party reward volume over time /api/v1/parties/{party_id}/reward-stats party reward distribution by type ### Burns /api/v1/burns canton Coin burns /api/v1/parties/{party_id}/cc-flow party CC earned and burned over time ## Featured Apps & Locking ### FeaturedApps /api/v1/featured-apps featured app providers, keyed on the right that minted each marker; view=beneficiaries keys on who received instead. periods 6h/1d/7d/30d/6m/1y/all; parties idle 30d are omitted; response states from/to/view /api/v1/featured-apps/{party_id} featured app detail ### Locking /api/v1/fa-locking CIP-0116 featured app locking registry /api/v1/sv-locking per-SV locking tier, weight, wallets, compliance ## Network ### Stats /api/v1/stats row counts per table ### Price /api/v1/price governance price of Canton Coin ### Instruments /api/v1/instruments CIP-0056 Token Standard instruments /api/v1/instruments/{admin}/{id} instrument detail ### Search /api/v1/search parties, updates, CNS, contracts, transfers, verdicts ### System /api/v1/indexing-status indexer cursor positions ## Governance ### Governance /api/v1/governance/voterequests super-validator proposals open for voting /api/v1/governance/voteresults decided proposals with their outcome ## Reference API reference: https://cc.itrocket.space/api-reference OpenAPI: https://cc-api.itrocket.space/openapi.json Explorer: https://cc.itrocket.space