# Financial Data API reference

Use this as compact context for the live bluedoor Financial Data API.

Primary URLs:

- API base URL: https://api.bluedoor.sh/financial-data/v1
- OpenAPI JSON: https://bluedoor.sh/apis/financial-data/docs/openapi.json
- Upstream raw OpenAPI JSON: https://api.bluedoor.sh/financial-data/v1/openapi.json
- Docs: https://bluedoor.sh/apis/financial-data/docs
- Source API docs index: https://bluedoor.sh/apis/financial-data/sources
- Landing page: https://bluedoor.sh/apis/financial-data

Shape:

- Federated financial-data facade over 26+ bluedoor source providers.
- Public Financial Data routes are intent-first and normalized.
- Source-native -fin routes remain available for existing integrations and are documented separately.
- Responses use a common evidence envelope: meta plus data.consensus and/or data.observations.
- Source-level failures are preserved in data.observations; a response can be HTTP 200 with meta.status=partial.
- Anonymous reads are allowed; contact/key identities receive higher limits.

Catalog & system routes:

- /v1/openapi.json
- /v1/health
- /v1/sources
- /v1/catalog/sources
- /v1/catalog/capabilities
- /v1/catalog/datasets
- /v1/catalog/fields
- /v1/coverage
- /v1/source-health
- /v1/endpoints

The full set of data routes is described in the OpenAPI document above.

Core route families:

- Quotes: /v1/quote, /v1/quote/{symbol}, /v1/instruments/{symbol}/quote
- Search and identity: /v1/search, /v1/autocomplete, /v1/entities/resolve, /v1/identifiers/map
- Prices and history: /v1/history, /v1/history/{symbol}, /v1/compare/returns, /v1/compare/chart
- Options: /v1/options, /v1/options/{symbol}/chain, /v1/options/flow, /v1/options/most-active
- Fundamentals: /v1/profile/{symbol}, /v1/fundamentals/{symbol}, /v1/financials/{symbol}/statements
- News and calendars: /v1/news, /v1/news/search, /v1/calendar/earnings, /v1/calendar/dividends
- Markets and datasets: /v1/markets/summary, /v1/screener, /v1/regulatory/short-interest, /v1/filings/{symbol}
- Official sources: /v1/entities/{entity_id}/facts, /v1/banks/{fdic_cert}, /v1/macro/series/{series_id}

Source API docs:

- Index: https://bluedoor.sh/apis/financial-data/sources
- Example source docs: https://bluedoor.sh/apis/financial-data/sources/yfin
- Example source OpenAPI: https://bluedoor.sh/apis/financial-data/sources/cfin/openapi.json

Examples:

```bash
curl "https://api.bluedoor.sh/financial-data/v1/sources"
curl "https://api.bluedoor.sh/financial-data/v1/quote?symbols=AAPL,MSFT&max_sources=2"
curl "https://api.bluedoor.sh/financial-data/v1/financials/AAPL/statements?statement=income&period=annual"
```