# MarketBeat adapter reference

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

Primary URLs:

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

Role:

- Adapter ID: mbfin
- Upstream: marketbeat.com
- Summary: MarketBeat-backed routes for autocomplete, company pages, ratings, dividends, news, and calendars.
- Fit: Use this adapter when MarketBeat-specific company, rating, dividend, or news context is desired.
- Adapters are not standalone bluedoor products. They are source-native connectors that power larger APIs, especially Financial Data.

Coverage:

- Autocomplete
- Company pages
- Ratings and dividends
- News and calendars

Representative routes:

- GET /v1/13f-holdings: 13F holdings
  Example: https://api.mbfin.bluedoor.sh/v1/13f-holdings
- GET /v1/analyst-ratings: Analyst ratings
  Example: https://api.mbfin.bluedoor.sh/v1/analyst-ratings
- GET /v1/autocomplete: Autocomplete
  Example: https://api.mbfin.bluedoor.sh/v1/autocomplete?q=AAPL
- GET /v1/congress-trades: Congress trades
  Example: https://api.mbfin.bluedoor.sh/v1/congress-trades
- GET /v1/dividend-yields: Yields
  Example: https://api.mbfin.bluedoor.sh/v1/dividend-yields?exchange=NASDAQ&symbol=AAPL
- GET /v1/dividends: History
  Example: https://api.mbfin.bluedoor.sh/v1/dividends?exchange=NASDAQ&symbol=AAPL
- GET /v1/earnings-estimates: Estimates
  Example: https://api.mbfin.bluedoor.sh/v1/earnings-estimates?exchange=NASDAQ&symbol=MSFT
- GET /v1/earnings-revenue: Revenue
  Example: https://api.mbfin.bluedoor.sh/v1/earnings-revenue?exchange=NASDAQ&symbol=AAPL
- GET /v1/fda-calendar: FDA calendar
  Example: https://api.mbfin.bluedoor.sh/v1/fda-calendar
- GET /v1/insider-trades: Insider trades
  Example: https://api.mbfin.bluedoor.sh/v1/insider-trades?exchange=NYSE&symbol=JPM
- GET /v1/marketbeat-trending: Trending stocks
  Example: https://api.mbfin.bluedoor.sh/v1/marketbeat-trending?exchange=NASDAQ&symbol=AAPL
- GET /v1/media-mentions: Media mentions
  Example: https://api.mbfin.bluedoor.sh/v1/media-mentions?exchange=NASDAQ&symbol=AAPL
- GET /v1/news-sentiment: Sentiment
  Example: https://api.mbfin.bluedoor.sh/v1/news-sentiment?exchange=NASDAQ&symbol=AAPL
- GET /v1/reddit-trending: Reddit trending
  Example: https://api.mbfin.bluedoor.sh/v1/reddit-trending?exchange=NASDAQ&symbol=AAPL
- GET /v1/sec-filings: SEC filings
  Example: https://api.mbfin.bluedoor.sh/v1/sec-filings?exchange=NASDAQ&symbol=AAPL
- GET /v1/stock-buybacks: Stock buybacks
  Example: https://api.mbfin.bluedoor.sh/v1/stock-buybacks

Examples:

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