# Finance Foundation
> The open data and intelligence layer for global finance. Structured reference data on companies, markets, assets, funds, banks, countries and macro indicators — with an open JSON API, a knowledge-graph endpoint and an open schema. Data: seed-0.7 · marketcap-1 · 2026-08-30. Licensing: our compilation, schema and text are CC BY 4.0; values sourced from a provider carry that provider's terms — every such field is labelled with its source. Figures are approximate reference values, NOT real-time prices.

## Markdown twins (clean text for LLMs)
- Any page: append .md (e.g. https://finance.foundation/markets/nyse.md, https://finance.foundation/companies/apple.md) or send the header Accept: text/markdown
- Collection twins: /companies.md /markets.md /assets.md /funds.md /banks.md /countries.md /economy.md /clearing.md /research.md

## Correct uses
- Entity resolution, classification, relationships, jurisdiction/venue context, research grounding.
- NOT for live quotes. Every API response carries data_version.

## MCP server (native agent tools)
- https://finance.foundation/mcp : Model Context Protocol server (Streamable HTTP, stateless, no auth).
- Tools: lookup, list, search, resolve_identifier, graph, live_data.
- Claude Code: claude mcp add --transport http finance https://finance.foundation/mcp

## API (no key, CORS enabled, JSON)
- https://finance.foundation/api/v1 : endpoint index
- https://finance.foundation/api/v1/all : entire dataset in one response (agent-friendly)
- https://finance.foundation/api/v1/companies : 121 companies (?q= ?sector= ?country= ?limit=); append .csv to any collection for CSV export
- https://finance.foundation/api/v1/companies/{id} : one company
- https://finance.foundation/api/v1/markets : 48 exchanges (MIC codes)
- https://finance.foundation/api/v1/assets : 56 assets (?type=Crypto|Index|Bond|Currency|Commodity)
- https://finance.foundation/api/v1/funds : 32 funds
- https://finance.foundation/api/v1/banks : 20 systemically important banks
- https://finance.foundation/api/v1/countries : 37 jurisdictions
- https://finance.foundation/api/v1/clearing : 20 clearing houses and central securities depositories, each with the LEI of the legal person — distinct from the venue it serves; 5 carry a tokenization field: the blockchain networks their own documents name, with the document and the date checked
- https://finance.foundation/api/v1/indicators : 8 macro indicator definitions
- https://finance.foundation/api/v1/research : 9 research briefs (full text)
- https://finance.foundation/api/v1/graph/{type}/{id} : knowledge-graph neighborhood (nodes + edges)
- https://finance.foundation/api/v1/graph/full : the entire knowledge graph in one payload (incl. member_of index edges and fund holds edges)
- https://finance.foundation/api/v1/schema : entity & relationship schema (FF Schema v0.1)
- https://finance.foundation/api/v1/openapi.json : OpenAPI 3.1 specification of this API
- https://finance.foundation/api/v1/resolve?q= : resolve a ticker, LEI, ISIN, FIGI, MIC or name to an entity
- POST https://finance.foundation/api/v1/ingest {"text": "..."} : LLM-extract entities+relationships from unstructured text into FF Schema (20/day per IP; output returned to caller only, never written into the dataset)
- https://finance.foundation/api/v1/sources : every upstream source with licence, refresh cadence and limits
- https://finance.foundation/api/v1/worldbank : annual country indicators (GDP, growth, population, inflation, listed market cap, listed companies, private credit) from World Bank Open Data
- https://finance.foundation/api/v1/live : reference values refreshed every 3 hours (crypto, FX, ECB rate, US 10Y, US CPI) with source + observation date — NOT real-time
- https://finance.foundation/api/v1/search?q= : cross-entity search

## Attribution
- Cite this site as: Data: Finance Foundation (https://finance.foundation). Our compilation, schema and text are CC BY 4.0; values sourced from a provider carry that provider's terms and are labelled with their source. Full register: https://finance.foundation/sources
- Upstream sources per figure: https://finance.foundation/sources (human) · https://finance.foundation/api/v1/sources (machine).
- Live values carry source, observation date and retrieved_at in the API; country indicators also carry the World Bank lastupdated stamp.

## Key pages
- https://finance.foundation/data : datasets, pipeline, sources, licensing
- https://finance.foundation/standards : identifiers (LEI, ISIN, MIC, FIGI) and the FF Schema
- https://finance.foundation/ai : how agents should use this site
- https://finance.foundation/research : structural research on financial infrastructure (RSS: https://finance.foundation/rss.xml, monthly cadence)