# Aggre documentation > Aggre is a data bank behind one keyed HTTP API: crypto market data, official macro series, SEC filings, Taiwan equities, statutes and name lists, health and on-chain datasets. These pages document the API, the datasets, the console and how an agent should use them. Append `.md` to any page URL for the Markdown version. Every page below is also available as Markdown (the link). The complete text of all pages is in llms-full.txt, and the machine-readable API description is the OpenAPI file. ## Get started - [Introduction](https://docs.aggre.org/index.md): Aggre is one keyed HTTP API in front of market, macro, filings, legal, health and on-chain datasets, with a console to manage keys. - [Quickstart](https://docs.aggre.org/quickstart.md): Create an API key and read your first rows from the Aggre data API in a few minutes. - [Authentication and API keys](https://docs.aggre.org/authentication.md): How the data API authenticates requests, what an API key is, and the limits you can set on it. ## Concepts - [Response format](https://docs.aggre.org/concepts/response-format.md): The envelope every data route returns, the meta object, strict query parameters and the rules that hold on every route. - [Identifiers and values](https://docs.aggre.org/concepts/identifiers.md): How instruments, datasets, series and statutes are identified, and how times and numbers are written. - [Pagination](https://docs.aggre.org/concepts/pagination.md): How cursors, limits and ordering work across the data API. - [Errors](https://docs.aggre.org/concepts/errors.md): The error envelope, every error code and what to do about each. - [Rate limits and quotas](https://docs.aggre.org/concepts/rate-limits.md): The two limits on the data API, how to tell them apart, and how to stay under them. - [Freshness and availability](https://docs.aggre.org/concepts/freshness.md): What meta.status means, why a dataset can be empty or answer terms_unread, and how revisions are kept as versions. - [Attribution and licensing](https://docs.aggre.org/concepts/attribution.md): Why rows carry credit, attribution and license, and what whoever displays them must do. ## Datasets - [Datasets](https://docs.aggre.org/datasets.md): Every dataset family, its dataset ids and the route that serves it. - [Market data](https://docs.aggre.org/datasets/market.md): Candles, instruments, latest tickers, funding rates and open interest from crypto venues. - [Macro data](https://docs.aggre.org/datasets/macro.md): Official macroeconomic series, their revisions as versions, the release calendar and computed series. - [Filings and trades](https://docs.aggre.org/datasets/filings.md): SEC EDGAR companies, filings, XBRL facts, fundamentals, insider transactions, fails-to-deliver, 13F holdings and 8-K news, plus US Congress stock trades. - [Taiwan equities](https://docs.aggre.org/datasets/taiwan-equities.md): Taiwan listed (TWSE) and OTC (TPEx) after-hours data: closes, valuation, institutional and margin data, revenue, statements and indices. - [Statutes](https://docs.aggre.org/datasets/legal-statutes.md): The current text of laws from official sources, how to find and read them, and the Taiwan judgments and retrieval routes. - [Regulatory lists and legal documents](https://docs.aggre.org/datasets/legal-regulatory.md): Government sanctions and exclusion lists, the Taiwan FSC news feed and Taiwan standard-form contracts. - [Health](https://docs.aggre.org/datasets/health.md): openFDA drug and device records, EMA medicines, NPPES providers, ClinicalTrials.gov, WHO indicators and Eurostat mortality. - [On-chain data](https://docs.aggre.org/datasets/onchain.md): DeFi protocol total value locked by day. ## API reference - [Data API](https://docs.aggre.org/api/data.md): Every read route of https://api.aggre.org: what each does, its parameters and an example. - [Service routes](https://docs.aggre.org/api/data/service.md): Health checks, the dataset list and the calling key. - [Accounts API](https://docs.aggre.org/api/accounts.md): The control-plane API behind the console: browser contract, sessions, login flow, roles and handles. - [Accounts API reference](https://docs.aggre.org/api/accounts/reference.md): Login, sessions, accounts, organizations, invitations and API-key management routes. - [Market data](https://docs.aggre.org/api/data/market.md): Candles, funding rates, open interest, instruments and the latest tickers. - [Macro data](https://docs.aggre.org/api/data/macro.md): The economic calendar, official macro series and their observations, and derived series. - [Schema reference](https://docs.aggre.org/api/schemas.md): JSON Schemas of every row and of the error envelope. - [Filings and trades (SEC EDGAR, US Congress)](https://docs.aggre.org/api/data/filings.md): Companies, filings, XBRL facts, fundamentals, insider transactions, fails-to-deliver, 13F holdings, 8-K news and Congress trades. - [OpenAPI and schema files](https://docs.aggre.org/api/openapi.md): Download the machine-readable API description and JSON Schemas. - [Taiwan equities](https://docs.aggre.org/api/data/equities-tw.md): TWSE and TPEx securities, daily closes, valuation, institutional and margin data, revenue, statements and indices. - [Legal data](https://docs.aggre.org/api/data/legal.md): Statutes, sanctions and exclusion lists, the Taiwan FSC news feed and Taiwan standard-form contracts. - [Health: openFDA](https://docs.aggre.org/api/data/health-openfda.md): The 19 openFDA datasets (drug labels, NDC, approvals, shortages, recalls, device clearances and more). - [Health: registries and statistics](https://docs.aggre.org/api/data/health-registries.md): EMA medicines, NPPES providers, ClinicalTrials.gov, FDA 510(k) summaries, WHO GHO and Eurostat mortality. - [On-chain data](https://docs.aggre.org/api/data/onchain.md): Total value locked in DeFi protocols, by protocol and chain. ## Console and accounts - [The console](https://docs.aggre.org/console/overview.md): What the Aggre console at app.aggre.org does: sign in, accounts and organizations, API keys, usage, and a browser for the datasets. - [API keys in the console](https://docs.aggre.org/console/api-keys.md): Create, limit, inspect and revoke API keys from the console. - [Organizations and members](https://docs.aggre.org/console/organizations.md): Create an organization, invite people, and what each role can do. - [Usage and audit log](https://docs.aggre.org/console/usage.md): See how many requests each key has made and who changed what in an account. - [Browsing the data](https://docs.aggre.org/console/browsing-data.md): The console's dataset browser, statute reader, API reference and playground. ## For agents - [Agent-friendly documentation](https://docs.aggre.org/agents/overview.md): How an AI agent or script can read these docs as Markdown, discover every page, and call the API. - [Best practices for agents](https://docs.aggre.org/agents/best-practices.md): How to use the Aggre API reliably and honestly from an AI agent or automated pipeline. - [MCP compatibility](https://docs.aggre.org/agents/mcp.md): The legacy MCP tool table served by GET /v1/mcp/tools and POST /v1/mcp/call, with each tool's arguments. ## Reference - [Versioning and compatibility](https://docs.aggre.org/reference/versioning.md): What changes the API makes without notice, and what it promises not to change. - [Glossary](https://docs.aggre.org/reference/glossary.md): Terms used across the Aggre documentation. ## Machine-readable files - [OpenAPI, data API (YAML)](https://docs.aggre.org/openapi/data.yaml): every read route of https://api.aggre.org - [OpenAPI, data API (JSON)](https://docs.aggre.org/openapi/data.json) - [OpenAPI, accounts API (YAML)](https://docs.aggre.org/openapi/accounts.yaml): the console's control-plane routes - [JSON Schemas](https://docs.aggre.org/schemas/candles.json): one file per row type, named in the schema reference - [Full text of this documentation](https://docs.aggre.org/llms-full.txt) - [Search index](https://docs.aggre.org/search-index.json)