Open API · v1
API
The whole site as a versioned JSON API. No key, CORS enabled, honest data versioning.
Auth
None
Open access, no API key. Fair-use rate limits at the edge.
Format
JSON + CORS
Every response is JSON with access-control-allow-origin: * — callable from browsers and agents.
Versioning
/v1 — stable
Breaking changes only under a new version prefix. Data version in every response envelope.
Endpoints
| Endpoint | Description |
|---|---|
| GET /api/v1 | API index — all endpoints, machine-readable |
| GET /api/v1/companies | List companies. Filters: ?q=, ?sector=, ?country=, ?limit= |
| GET /api/v1/companies/{id} | One company + graph links |
| GET /api/v1/markets · /markets/{id} | Exchanges with MIC codes |
| GET /api/v1/assets · /assets/{id} | Assets. Filter: ?type=Crypto|Index|Bond|Currency|Commodity |
| GET /api/v1/funds · /funds/{id} | Funds with managers and AUM |
| GET /api/v1/banks · /banks/{id} | Systemically important banks |
| GET /api/v1/countries · /countries/{id} | Jurisdictions: currency, central bank, GDP |
| GET /api/v1/indicators | Macro indicator definitions |
| GET /api/v1/research · /research/{id} | Research briefs (full text) |
| GET /api/v1/graph/{type}/{id} | Knowledge-graph neighborhood of an entity (nodes + edges) |
| POST /api/v1/ingest | Extract FF-Schema entities from unstructured text (LLM, validated; 20/day per IP; never written into the dataset) |
| GET /api/v1/schema | Finance Foundation Schema v0.1 |
| GET /api/v1/openapi.json | OpenAPI 3.1 specification of this API |
| GET /api/v1/search?q= | Search across all entity types |
| GET /api/v1/all | The entire dataset in one response (~agent-friendly) |
Example
curl -s https://finance.foundation/api/v1/companies/apple
{
"data_version": "seed-0.7 · marketcap-1 · 2026-08-30",
"entity": "company",
"data": { "id": "apple", "ticker": "AAPL", … },
"links": {
"graph": "/api/v1/graph/companies/apple",
"html": "/companies/apple"
}
}
Plans
Free — live now
$0
Full seed dataset, all endpoints, fair use. Attribution appreciated (CC BY 4.0).
Pro — planned
Deeper data
Extended coverage, historical series, bulk exports, priority limits.
Enterprise — planned
Custom
Private datasets, SLAs, custom entities and identifiers.
Free tier and the open MCP server exist today — the paid tiers describe the roadmap, not a current offering. Interested in early access? admin@digitaldomains.market