Token Command Center API

Free, read-only token data for apps and agents: revenue, net flow to holders after emissions, emissions / supply / unlock history and catalysts, with known data errors marked instead of drawn. No key needed to read; a free key lifts the per-address limit. JSON over HTTPS, or MCP for agents.

About 400 tokens with real revenue. Research data, not advice. Every answer carries generated_at; quote it.

Data vs judgment. Every field is sourced data except health_score/health, pillars, verdict/accrual_verdict, lens and tier: those are MummAI's analyst judgment (the scorecard), shown on token pages only inside a labelled "MummAI Analysis" section. Treat them as an opinion, not a measurement.

What holders keep after dilution

Annualized holders revenue vs emissions (new minting plus treasury distributions; vesting unlocks are tracked separately), and the net flow between them, as history. Free and open, for any token in the book.

curl -s 'https://tcc.0xm.app/v1/tokens/geodnet/series?metrics=ann_holders_rev,ann_emissions_usd,net_flow_usd&range=90d&interval=1w'

Emissions, supply and unlocks over an open API

Supply and unlock history and a catalyst calendar, no key, plain JSON or MCP.

curl -s 'https://tcc.0xm.app/v1/tokens/geodnet/series?metrics=pct_unlocked,circ_supply&range=all'

Upcoming catalysts

Dated unlocks, emission steps and votes across the book, soonest first.

curl -s 'https://tcc.0xm.app/v1/calendar?days=30'

Known data errors, marked

A price feed that stopped is returned as null with a `masks` entry, not drawn as a flat line; a revenue jump from a near-zero base carries `base_effect: true`; multi-source revenue is cut at the last day every source reported.

curl -s 'https://tcc.0xm.app/v1/tokens/slvr/series?metrics=price&range=all'

Years of daily revenue

DefiLlama daily revenue, summed per week, with partial weeks flagged.

curl -s 'https://tcc.0xm.app/v1/tokens/aave/series?metrics=daily_revenue&range=1y&interval=1w'

Embed a chart

Any token's history chart is a plain SVG image: no script, no iframe. Views: revenue, price, dilution, supply; theme=light for light pages (dark is the default).

<a href="https://0xm.app/tcc/aave"><img src="https://tcc.0xm.app/v1/tokens/aave/chart.svg?view=revenue&amp;range=1y" width="600" alt="Aave revenue, weekly, 1Y. Token Command Center"></a>

For agents (MCP)

claude mcp add token-command-center --transport http https://tcc.0xm.app/mcp

Read-only tools: tc_alerts, tc_brief, tc_calendar, tc_categories, tc_compare, tc_get_project, tc_get_report, tc_get_token, tc_get_token_digest, tc_ledger, tc_list_tokens, tc_moves, tc_projects, tc_resolve, tc_screen, tc_search_tokens, tc_series, tc_status. Start with tc_resolve when you only have a symbol; shared symbols come back with every candidate.

Reference

OpenAPI: /v1/openapi.json. Status and freshness: /v1/status. Browsers can call every public endpoint from any origin, with or without a key.

Limits

Keyless reads: 60 requests a minute per client address for keyless calls, as a token bucket (bursts up to the limit, refilled at that rate), counted behind the edge cache, so repeats of a cached answer do not count. Over it, the answer is 429 with a Retry-After header (seconds) and {"error": "...", "code": "rate_limited", "scope": "ip", "retry_after": n}.

Keyed calls: no per-address limit for the keyed tier; instead a daily cap per key (UTC day; defaults free 5,000/day, keyed 20,000/day; the cap is set per key). Over it: 429, scope: "key", Retry-After until midnight UTC. GET /v1/usage/me with your key returns the label, tier, cap and today's count.

Bulk objects (/v1/bundle/*: the whole export, extras, overlay, manifest; /v1/series/*: the per-token history shards) need a keyed key: 401 {"error", "code": "key_required"} without one. The same data is readable row by row without a key; the key is identity for bulk pulls, not a paywall.

Every error is JSON with error (a sentence) and code (stable: bad_request, unknown_token, not_found, key_required, key_invalid, key_revoked, key_tier, rate_limited, key_store_unavailable). The limit is enforced per server instance, so it is a courtesy limit against runaway loops, not a contract; no SLA is offered.

Keys

A key tells us who is calling so we can lift the limit, open the bulk objects and count your use under a label. Two tiers: free (identified in our usage counts, public limit still applies; for chart embeds and small apps, since an embed's key sits in page source) and keyed (no per-address limit, a daily cap, bulk objects). Both are free of charge. To ask for one, email the address on 0xm.app (the 0xm.app mailbox is being set up; until then the Contact section below applies): say what you are building and which tier; you get a key once, shown never again, which we can revoke on request or on abuse.

Send it as the X-TC-Key header on any endpoint; as Authorization: Bearer <key> on /mcp; or as ?key= on chart.svg only, where an <img> tag cannot set headers. A key that does not verify is refused (401), never treated as anonymous. We store only a hash of the key with its label, tier, cap and dates; the usage counts carry the label, never the key.

curl -s -H 'X-TC-Key: tc_...' 'https://tcc.0xm.app/v1/usage/me'

Terms

The data is free to read and stays free (decision F). A key adds identity and limits, not a license, and there is no paid tier on this data; none will be offered until the sources' terms allow it. What you may do with what you read depends on where each figure comes from, and /v1/tokens/{slug}/sources names the source per figure:

Token Command Center's own figures (emissions, unlocks, supply, net flow to holders, data flags, provenance, scorecards): use, quote and chart them with a link to the token's page on 0xm.app.

Market data from CoinGecko (price, market cap, FDV, supply snapshots): used under the CoinGecko API Terms. Where you show it, display "Powered by CoinGecko" with a link; refresh anything you cache at least every 24 hours; do not sell, sub-license, re-distribute or syndicate it or build a data feed on it.

Daily fees, revenue and long price history from DefiLlama (daily_*, price_llama, the series shards): used under DefiLlama's Terms of Use. Credit "Data: DefiLlama"; do not mirror, resell, republish or build a competing dataset on it. The series responses carry this attribution in notes; keep it.

Research data, not advice; provided as is, with no warranty and no SLA. We can revoke a key for abuse or at a source's request. Sources' terms change; this section is kept in step with the repository's decision log (decision O).

Contact

An email address on 0xm.app is being set up and will appear here; the contact address is not set yet. Data corrections are welcome with a source. The service is built by 0xM Studio; the human pages are at 0xm.app/tcc.

Sources

Daily fees, revenue and long price history: DefiLlama (api.llama.fi, coins.llama.fi). Market data: CoinGecko. Emissions, unlocks, supply, net flow and the error flags: Token Command Center's own research pipeline, with a provenance tier per figure at /v1/tokens/{slug}/sources.