# MarketScreener adapter reference

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

Primary URLs:

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

Role:

- Adapter ID: msfin
- Upstream: marketscreener.com
- Summary: MarketScreener-backed routes for search, quotes, financials, estimates, consensus, and company tables.
- Fit: Use this adapter when MarketScreener consensus or financial table extraction is useful.
- Adapters are not standalone bluedoor products. They are source-native connectors that power larger APIs, especially Financial Data.

Coverage:

- Search
- Quotes
- Financial tables
- Consensus and estimates

Representative routes:

- GET /v1/agenda-calendar: Agenda
  Example: https://api.msfin.bluedoor.sh/v1/agenda-calendar
- GET /v1/broker-research: Broker research
  Example: https://api.msfin.bluedoor.sh/v1/broker-research?slug=APPLE-INC&codezb=4849
- GET /v1/calendar-finance: Financial calendar
  Example: https://api.msfin.bluedoor.sh/v1/calendar-finance
- GET /v1/company-governance: Governance
  Example: https://api.msfin.bluedoor.sh/v1/company-governance?slug=APPLE-INC&codezb=4849
- GET /v1/company-shareholders: Shareholders
  Example: https://api.msfin.bluedoor.sh/v1/company-shareholders?slug=APPLE-INC&codezb=4849
- GET /v1/consensus: Summary
  Example: https://api.msfin.bluedoor.sh/v1/consensus?slug=APPLE-INC&codezb=4849
- GET /v1/consensus-revisions: Revisions
  Example: https://api.msfin.bluedoor.sh/v1/consensus-revisions?slug=APPLE-INC&codezb=4849
- GET /v1/finances-balance: Balance sheet
  Example: https://api.msfin.bluedoor.sh/v1/finances-balance?slug=APPLE-INC&codezb=4849
- GET /v1/finances-cashflow: Cash flow
  Example: https://api.msfin.bluedoor.sh/v1/finances-cashflow?slug=APPLE-INC&codezb=4849
- GET /v1/finances-income: Income statement
  Example: https://api.msfin.bluedoor.sh/v1/finances-income?slug=APPLE-INC&codezb=4849
- GET /v1/finances-ratios: Ratios
  Example: https://api.msfin.bluedoor.sh/v1/finances-ratios?slug=APPLE-INC&codezb=4849
- GET /v1/news-insiders: Insiders
  Example: https://api.msfin.bluedoor.sh/v1/news-insiders?slug=APPLE-INC&codezb=4849
- GET /v1/ratings: Ratings
  Example: https://api.msfin.bluedoor.sh/v1/ratings?slug=APPLE-INC&codezb=4849
- GET /v1/right-sidebar: Market sidebar
  Example: https://api.msfin.bluedoor.sh/v1/right-sidebar
- GET /v1/search: Search
  Example: https://api.msfin.bluedoor.sh/v1/search?q=AAPL
- GET /v1/sector-heatmap: Sector heatmap
  Example: https://api.msfin.bluedoor.sh/v1/sector-heatmap?codezb=4985
- GET /v1/segment-revenue: Segment revenue
  Example: https://api.msfin.bluedoor.sh/v1/segment-revenue?codezb=4849
- GET /v1/transcripts: Call transcripts
  Example: https://api.msfin.bluedoor.sh/v1/transcripts?slug=APPLE-INC&codezb=4849

Examples:

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