The REST surface.
A thin HTTP twin of the MCP tool surface. Every endpoint calls the same service function as the tool it mirrors, returns the same envelope, and obeys the same bounds — so the choice between MCP and REST is a transport choice, not a data one.
The surface
Straight from the published specification's own description:
Read-only REST access to agent-datasets: normalized SEC filings and fundamentals, US and euro-area macro series, FDIC bank financials, fund holdings and proxy votes, CMBS deals, CFTC futures positioning, ECB FX rates, federal awards, canonical geographies, real-estate series, FDA approvals, and the platform's own catalog and freshness. Every response uses the shared {data, meta, pagination} envelope: values carry unit, currency, period, as_of, and source attribution, result sets are bounded and cursor-paginated, and failures use one error taxonomy — see /docs/conventions for the full contract. Requests authenticate with an X-API-KEY header. This specification covers the public surface only: provider-licensed endpoints are omitted entirely, and endpoints whose payload degrades for public keys state that restriction in their description.
This reference is generated from the public OpenAPI document the API itself serves. Provider-licensed endpoints are absent from that document entirely, so they are absent here; the four endpoints whose payload narrows for public keys say so on their own entry.
Base URL
Every path below is relative to this origin.
| Base URL | Environment | API version |
|---|---|---|
| https://api.agentdatasets.com | Production | 0.1.0 |
Authentication
Requests carry an X-API-KEY header. Create, rotate, and revoke keys in the dashboard; use a public-surface key whenever the credential may leave your organisation, since public keys enforce the redistribution gate.
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/banks/financials?cert=1"Keys are secrets: keep them out of source control, and out of anything a browser can read.
Response contract
REST and MCP share one envelope, one set of bounds, one cursor scheme, and one error taxonomy. The contract is documented once, on the conventions page.
Endpoints by category
Categories come from the specification's own tags; names and launch status are shared with the MCP tool catalog.
| Category | Endpoints | Status | Coverage |
|---|---|---|---|
| Banks/v1/banks | 2 | Available | US commercial bank financials and institution profiles from the FDIC BankFind Suite. |
| CMBS/v1/cmbs | 2 | Soon | Commercial mortgage-backed securities — deal registry and loan/property collateral detail from public SEC EDGAR ABS-EE EX-102 filings. |
| Legal Entities/v1/entities | 3 | Soon | GLEIF Legal Entity Identifier profiles and accounting-consolidation relationships from the Level-1 and Level-2 golden copies. |
| FDA/v1/fda | 2 | Soon | Drug application, product, and approval history for pilot US-listed biotech and pharmaceutical sponsors from Drugs@FDA. |
| Funds/v1/funds | 3 | Soon | SEC N-PORT fund holdings and N-PX proxy-voting records for registered investment funds. |
| Futures/v1/futures | 2 | Soon | Weekly CFTC Commitments of Traders positioning for curated financial-futures markets — Treasuries, SOFR, E-mini equity indices, and major FX — by trader category. |
| Foreign Exchange/v1/fx | 2 | Available | Daily ECB euro reference rates and EUR-triangulated conversions. |
| Geography/v1/geo | 4 | Available | Canonical US Census/OMB and Australian ABS ASGS geography identity, containment hierarchies, aliases, and official crosswalks. |
| Federal spending/v1/gov | 2 | Soon | US federal award recipients and obligation aggregates from USAspending — recipient registry, fiscal-year obligation trends, and top awarding agencies. |
| Hazards/v1/hazards | 3 | Soon | US natural-hazard risk — FEMA National Risk Index county and census-tract profiles, components, and rankings. |
| Macro/v1/macro | 4 | Soon | US macroeconomic time series — Treasury yields, BLS employment and inflation measures, and BEA national accounts. |
| Platform/v1/platform | 2 | Available | Catalog and freshness metadata for the Agent Datasets platform. |
| Real Estate/v1/re | 4 | Available | US housing and real-estate indicators — FHFA house price indices and related series. |
| Stocks/v1/stocks | 28 | Soon | US public equity markets — fundamentals, filings, prices, and corporate actions sourced from SEC EDGAR and market data providers. |
63 operations in total, across 14 categories.