Aggre documentation
Aggre is one keyed HTTP API in front of market, macro, filings, legal, health and on-chain datasets, with a console to manage keys.
Aggre is a data bank. You read many kinds of data (exchange candles, official macro series, SEC filings, Taiwan equities, statutes and government name lists, health registries, DeFi figures) through one HTTP API and one kind of API key, and every row says where it came from, when it was read and what credit its publisher asks for.
The pieces#
| Piece | Address | What it is |
|---|---|---|
| Data API | https://api.aggre.org | Read-only JSON over HTTPS. API key in a header. No cookies, no browser (CORS) access. |
| Console | https://app.aggre.org | Sign in, create API keys, manage organizations, see usage, browse datasets. |
| Accounts API | https://accounts.aggre.org | What the console calls (cookie session). You only need it to build your own console. |
| Documentation | https://docs.aggre.org | This site. Every page is also available as Markdown. |
What you can read#
| Family | Examples | Guide |
|---|---|---|
| Market data | Candles, funding rates, open interest, latest tickers by venue | Market data |
| Macro | Official series with revisions kept as versions, the release calendar | Macro |
| Filings and trades | SEC EDGAR filings, XBRL facts, insider trades, 13F holdings, Congress trades | Filings |
| Taiwan equities | TWSE and TPEx closes, valuation, institutional and margin data, revenue, statements | Taiwan equities |
| Statutes | Current text of laws from ten jurisdictions; Taiwan judgments and retrieval | Statutes |
| Name lists and legal documents | OFAC, UN and HHS-OIG lists, Taiwan FSC news, standard-form contracts | Regulatory and legal documents |
| Health | openFDA, EMA, NPPES, ClinicalTrials.gov, WHO, Eurostat mortality | Health |
| On-chain | DeFi protocol TVL | On-chain |
The full list with dataset ids is on Datasets. Which datasets hold data right now is not fixed in these pages: each source is switched on only after a person has read its publisher's terms, and the API tells you the state on every response (meta.status, and 503 terms_unread where a source is still gated). See Freshness and availability.
Where to start#
- Quickstart: get a key and make your first call in five minutes.
- Concepts: the rules that hold on every route (envelope, errors, paging, attribution).
- Data API reference: every route, its parameters and an example, generated from the OpenAPI file.
- For agents:
.mdURLs,llms.txt, OpenAPI and the MCP compatibility routes.
Agent friendly#
Every page on this site has a Markdown twin: add .md to the address (/quickstart is also /quickstart.md, and this page is /index.md), or send Accept: text/markdown. Links inside the Markdown are absolute and point to other .md pages, so an agent that follows them stays in Markdown. /llms.txt lists every page; /llms-full.txt is all of them in one file.
Source: content/index.md