# Stooq adapter reference

Use this as compact context for the Stooq adapter in bluedoor.

Primary URLs:

- Landing page: https://bluedoor.sh/adapters/stooq
- Docs: https://bluedoor.sh/adapters/stooq/docs
- OpenAPI JSON: https://bluedoor.sh/adapters/stooq/docs/openapi.json
- bluedoor adapter API base URL: https://api.bluedoor.sh/adapters/stooq/v1
- Current source API host: https://api.stfin.bluedoor.sh
- Source health: https://api.stfin.bluedoor.sh/v1/health
- Source catalog: https://api.stfin.bluedoor.sh/v1/endpoints

Role:

- Adapter ID: stfin
- Upstream: stooq.com
- Summary: Stooq-backed static and CSV-style market data routes for quotes, historical data, news, and symbol lookup.
- Fit: Use this adapter when low-friction Stooq quote or historical data is the desired source.
- Adapters are not standalone bluedoor products. They are source-native connectors that power larger APIs, especially Financial Data.

Coverage:

- Quotes
- Historical prices
- News
- Symbol lookup

Representative routes:

- GET /v1/constituents: Constituents
  Example: https://api.stfin.bluedoor.sh/v1/constituents?symbol=^spx
- GET /v1/corporate-actions: Corporate actions
  Example: https://api.stfin.bluedoor.sh/v1/corporate-actions?symbol=aapl.us
- GET /v1/group-quotes: Groups
  Example: https://api.stfin.bluedoor.sh/v1/group-quotes?group=main_indices
- GET /v1/market-stats: Market stats
  Example: https://api.stfin.bluedoor.sh/v1/market-stats?market=us&view=summary
- GET /v1/news: Headlines
  Example: https://api.stfin.bluedoor.sh/v1/news?category=business
- GET /v1/profile: Profile
  Example: https://api.stfin.bluedoor.sh/v1/profile?symbol=aapl.us
- GET /v1/quote-page: Quote page
  Example: https://api.stfin.bluedoor.sh/v1/quote-page?symbol=spy.us
- GET /v1/quotes: Snapshots
  Example: https://api.stfin.bluedoor.sh/v1/quotes?symbols=spy.us,aapl.us&fields=sd2t2ohlcv
- GET /v1/rss: RSS feed
  Example: https://api.stfin.bluedoor.sh/v1/rss?feed=b
- GET /v1/search: Search
  Example: https://api.stfin.bluedoor.sh/v1/search?q=aapl
- GET /v1/ticker-rank: Ticker rank
  Example: https://api.stfin.bluedoor.sh/v1/ticker-rank?symbol=spy.us&market=us&page=1
- GET /v1/calendar/company: Company events
  Example: https://api.stfin.bluedoor.sh/v1/calendar/company?section=all
- GET /v1/calendar/economic: Economic events
  Example: https://api.stfin.bluedoor.sh/v1/calendar/economic?region=us
- GET /v1/news/symbol: Symbol news
  Example: https://api.stfin.bluedoor.sh/v1/news/symbol?symbol=aapl.us
- GET /v1/quote/calendar: Calendar
  Example: https://api.stfin.bluedoor.sh/v1/quote/calendar?symbol=aapl.us
- GET /v1/quote/earnings: Earnings
  Example: https://api.stfin.bluedoor.sh/v1/quote/earnings?symbol=aapl.us
- GET /v1/quote/financials: Financials
  Example: https://api.stfin.bluedoor.sh/v1/quote/financials?symbol=aapl.us
- GET /v1/quote/holders: Holders
  Example: https://api.stfin.bluedoor.sh/v1/quote/holders?symbol=aapl.us
- GET /v1/quote/ratios: Ratios
  Example: https://api.stfin.bluedoor.sh/v1/quote/ratios?symbol=spy.us

Examples:

```bash
curl "https://api.bluedoor.sh/adapters/stooq/v1/health"
curl "https://api.bluedoor.sh/adapters/stooq/v1/news"
curl "https://bluedoor.sh/adapters/stooq/docs/openapi.json"
```