API Access

The data behind Fundamentals, as an API

Everything on the Fundamentals dashboard — token functionalities and their strengths, sector classifications, system attributes, value dynamics — is available as a structured REST API. If the MCP server is how an AI assistant reads Fundamentals, the REST API is how a product, script, or data pipeline does.

The API is read-only, returns JSON, and every record carries a canonical fundamentals.fyi link back to the source.

Base URL: https://fundamentals.fyi/api

Open access

Some endpoints are open to anyone, no key required:

  • Search — GET /api/search?q=aave
  • Token index — GET /api/tokens (a summary of every token: name, ticker, sector, system, and links)
  • System index — GET /api/systems
  • Sector taxonomy — GET /api/sectors
  • The framework — GET /api/framework (our classification vocabulary)
  • Sample profiles — full detail for a small set of well-known tokens and their systems, so you can judge the depth before requesting a key: BTC, ETH, USDC, SOL, BNB. For example GET /api/tokens/bitcoin.
  • The spec — GET /api/openapi.json

Full access (with a key)

The full analytical surface requires an API key:

  • Full token profiles — GET /api/tokens/{name} — a token's functionalities, strengths, scope, descriptions, and system.
  • Full system profiles — GET /api/systems/{name} — operating model, value creation and capture, governance, sector mappings, and the tokens within.
  • Compare — GET /api/compare?tokens=aave,morpho — tokens aligned side by side.
  • Rank — GET /api/rank?functionality=Governance — leaderboards over our structured judgments.

Requesting a key

Keys are issued by hand, so we know who is building on the data and can support you. Email ops@publicwealth.io with a line about what you are building. There is no charge for the pilot tier.

Using your key

Send it in the X-API-Key header:

curl -H "X-API-Key: YOUR_KEY" https://fundamentals.fyi/api/tokens/aave

The same endpoints now return full data.

Attribution

The API is free to use with attribution. When you display Fundamentals data, credit Fundamentals and link back to the source. Every response includes the canonical profile URL in its url field, so you can link each token or system straight to its page on fundamentals.fyi.

Rate limits

Requests are rate limited per key, and per IP for keyless access. The pilot limits are generous for research and product use. If you expect heavy or automated throughput, mention it when you request your key and we will set an appropriate limit.

For AI assistants

If your goal is to let an AI assistant such as Claude or ChatGPT query Fundamentals as you chat, use the MCP server instead. It is purpose-built for that and needs a sign-in rather than an API key.