# Finance API — real-time quotes, charts, fundamentals, analyst ratings, screener, options, technicals & earnings/IPO/economic calendars (incl. a market-wide earnings calendar) on Yahoo Finance data + FRED macroeconomic series

> single or multi-symbol quote
> ReefAPI engine `finance` · 78 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/finance/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /finance/v1/quote — 1 credit
single or multi-symbol quote

**Parameters:**
- `symbol` (string, required) — Ticker symbol, or use `symbols` for several (e.g. 'AAPL'). crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC'.
- `symbols` (string, optional) — Multiple symbols (array or comma-separated) for a batch quote.

**Returns:** quotes[] — symbol, price, change, changePercent, currency, marketCap, volume, exchange, quoteType, marketState

### POST /finance/v1/chart — 1 credit
OHLCV chart data

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]

**Returns:** symbol, currency, range, interval, points[]{timestamp,open,high,low,close,volume}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/search — 1 credit
symbol search

**Parameters:**
- `query` (string, required) — Free-text search query (company name or symbol).
- `quotesCount` (integer, optional, default 10) — How many symbol matches to return.

**Returns:** query, quotes[]{symbol,name,exchange,quoteType,score}

**Example request body:**
```json
{
  "query": "apple"
}
```

### POST /finance/v1/fundamentals — 1 credit
quoteSummary modules

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `modules` (string, optional) — Comma-separated Yahoo quoteSummary modules (e.g. 'price,financialData,earnings'). Omit for a broad default module set.

**Returns:** symbol, modules{<module>:{...}} (Yahoo quoteSummary)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/analyst — 1 credit
recommendations, upgrades/downgrades, price targets

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{recommendationTrend,upgradeDowngradeHistory,financialData}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/holders — 1 credit
insider/institution/fund ownership and holder activity

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{insider/institution/fund ownership + holder activity}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/news — 1 credit
Yahoo Finance news search

**Parameters:**
- `query` (string, required) — Search keyword OR a ticker symbol to pull news for (either works).
- `symbol` (string, optional) — Ticker symbol to fetch news for (alternative to query).
- `count` (integer, optional, default 10) — Maximum number of results to return.

**Returns:** query, news[]{uuid,title,publisher,link,providerPublishTime,type,thumbnail}

### POST /finance/v1/options — 1 credit
option chain

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `date` (integer, optional) — Optional option-chain expiration as a Unix timestamp; omit for the nearest expiry.

**Returns:** symbol, expirationDates[], strikes[], calls[], puts[] (option contracts)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/calendar — 1 credit
earnings/calendar quoteSummary modules

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{calendarEvents,earnings}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/events — 1 credit
dividends and splits from chart events

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, dividends[], splits[], capitalGains[]

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/screener_predefined — 1 credit
Yahoo saved screeners

**Parameters:**
- `scrIds` (enum, optional, default "day_gainers") — A Yahoo predefined screener id. Common ones shown; any valid Yahoo saved-screener id is accepted. [one of: most_actives, day_gainers, day_losers, growth_technology_stocks, most_shorted_stocks, undervalued_growth_stocks, aggressive_small_caps, small_cap_gainers]
- `count` (integer, optional, default 25) — Number of screener rows to return.
- `start` (integer, optional, default 0) — Result offset for pagination.

**Returns:** scrIds, quotes[] (the saved-screener result rows)

### POST /finance/v1/screener — 2 credits
Yahoo custom screener POST

**Parameters:**
- `criteria` (object, optional) — Yahoo custom-screener query object ({operator, operands:[...]}); omit for an unfiltered screen.
- `size` (integer, optional, default 25) — Number of screener results.
- `offset` (integer, optional, default 0) — Result offset for screener pagination.
- `sortField` (string, optional, default "intradaymarketcap") — Screener field to sort by (e.g. intradaymarketcap, percentchange, dayvolume).
- `sortType` (enum, optional, default "DESC") — Sort direction for the screener. [one of: DESC, ASC]
- `quoteType` (enum, optional, default "EQUITY") — Instrument type the screener targets. [one of: EQUITY, ETF, MUTUALFUND, INDEX, CURRENCY, CRYPTOCURRENCY, FUTURE]

**Returns:** quotes[] (custom-screener matches), request{size,offset}

### POST /finance/v1/market_summary — 1 credit
market summary indices

**Parameters:**
- `region` (string, optional, default "US") — Yahoo market region code (e.g. US, GB, DE, FR, IN, JP).
- `lang` (string, optional, default "en-US") — Yahoo response language tag (e.g. en-US).

**Returns:** items[] — market summary indices for the region

### POST /finance/v1/trending — 1 credit
trending symbols

**Parameters:**
- `region` (string, optional, default "US") — Yahoo market region code (e.g. US, GB, DE, FR, IN, JP).
- `count` (integer, optional, default 10) — Maximum number of results to return.

**Returns:** region, quotes[] — trending symbols

### POST /finance/v1/lookup — 1 credit
Yahoo symbol universe lookup

**Parameters:**
- `query` (string, required) — Free-text search query (company name or symbol).
- `count` (integer, optional, default 20) — Maximum number of results to return.
- `type` (enum, optional) — Restrict the symbol lookup to one quote type. Omit for all types. [one of: equity, etf, mutualfund, index, currency, cryptocurrency, future]

**Returns:** query, type, documents[] — matching symbols

**Example request body:**
```json
{
  "query": "apple"
}
```

### POST /finance/v1/technicals — 1 credit
local technical indicators from chart OHLCV

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1y") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]
- `periods` (string, optional, default "20,50") — Comma-separated SMA/EMA lookback periods to compute (e.g. '20,50'). RSI(14)/MACD/Bollinger/ATR/ADX are always included.

**Returns:** symbol, points[], indicators{sma/ema/rsi14/macd/bollinger20/atr14/adx14/...}

**Example request body:**
```json
{
  "symbol": "AAPL",
  "range": "6mo",
  "interval": "1d"
}
```

### POST /finance/v1/economic — 1 credit
FRED economic series via official API

**Parameters:**
- `series` (string, required) — FRED economic series id (e.g. GDP, UNRATE, CPIAUCSL).
- `fred_api_key` (string, required) — Your own FRED API key (St. Louis Fed) — required; this surface is key-gated and not proxied by the gateway.
- `limit` (integer, optional, default 100) — Max FRED observations to return.
- `sort_order` (enum, optional, default "desc") — Order of the returned FRED observations. [one of: desc, asc]

**Returns:** series, observations[]{date,value} (FRED)

### POST /finance/v1/v1/market/tickers — 2 credits
public NASDAQ/NYSE/AMEX ticker universe

**Parameters:**
- `limit` (integer, optional, default 0) — Max tickers to return (0/omit = full universe).

**Returns:** tickers[]{symbol,name,exchange,etf,source} — NASDAQ/NYSE/AMEX universe

**Example request body:**
```json
{
  "limit": 10
}
```

### POST /finance/v1/v1/search — 1 credit
RapidAPI-compatible alias for search

**Parameters:**
- `query` (string, required) — Free-text search query (company name or symbol).
- `quotesCount` (integer, optional, default 10) — How many symbol matches to return.

**Returns:** query, quotes[]{symbol,name,exchange,quoteType,score}

**Example request body:**
```json
{
  "query": "apple"
}
```

### POST /finance/v1/v1/market/quotes — 1 credit
RapidAPI-compatible alias for quote

**Parameters:**
- `symbol` (string, required) — Ticker symbol, or use `symbols` for several (e.g. 'AAPL'). crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC'.
- `symbols` (string, optional) — Multiple symbols (array or comma-separated) for a batch quote.

**Returns:** quotes[] — symbol, price, change, changePercent, currency, marketCap, volume, exchange, quoteType, marketState

**Example request body:**
```json
{
  "symbols": [
    "AAPL",
    "MSFT"
  ]
}
```

### POST /finance/v1/v1/stock/history — 1 credit
RapidAPI-compatible alias for chart

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]

**Returns:** symbol, currency, range, interval, points[]{timestamp,open,high,low,close,volume}

**Example request body:**
```json
{
  "symbol": "AAPL",
  "range": "1mo",
  "interval": "1d"
}
```

### POST /finance/v1/v2/stock/history — 1 credit
RapidAPI-compatible alias for chart

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]

**Returns:** symbol, currency, range, interval, points[]{timestamp,open,high,low,close,volume}

**Example request body:**
```json
{
  "symbol": "AAPL",
  "range": "1mo",
  "interval": "1d"
}
```

### POST /finance/v1/v1/market/screener — 1 credit
RapidAPI-compatible alias for screener

**Parameters:**
- `scrIds` (enum, optional, default "day_gainers") — A Yahoo predefined screener id. Common ones shown; any valid Yahoo saved-screener id is accepted. [one of: most_actives, day_gainers, day_losers, growth_technology_stocks, most_shorted_stocks, undervalued_growth_stocks, aggressive_small_caps, small_cap_gainers]
- `criteria` (object, optional) — Yahoo custom-screener query object ({operator, operands:[...]}); omit for an unfiltered screen.
- `size` (integer, optional, default 25) — Number of screener results.
- `offset` (integer, optional, default 0) — Result offset for screener pagination.
- `sortField` (string, optional, default "intradaymarketcap") — Screener field to sort by (e.g. intradaymarketcap, percentchange, dayvolume).
- `sortType` (enum, optional, default "DESC") — Sort direction for the screener. [one of: DESC, ASC]
- `quoteType` (enum, optional, default "EQUITY") — Instrument type the screener targets. [one of: EQUITY, ETF, MUTUALFUND, INDEX, CURRENCY, CRYPTOCURRENCY, FUTURE]

**Returns:** quotes[] — predefined (scrIds) or custom (criteria) screener results

**Example request body:**
```json
{
  "scrIds": "most_actives",
  "count": 5
}
```

### POST /finance/v1/v1/stock/modules — 1 credit
RapidAPI-compatible alias for quoteSummary modules

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `modules` (string, optional) — Comma-separated Yahoo quoteSummary modules (e.g. 'price,financialData,earnings'). Omit for a broad default module set.

**Returns:** symbol, modules{<module>:{...}} (Yahoo quoteSummary)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/market/news — 1 credit
RapidAPI-compatible alias for news

**Parameters:**
- `query` (string, required) — Search keyword OR a ticker symbol to pull news for (either works).
- `symbol` (string, optional) — Ticker symbol to fetch news for (alternative to query).
- `count` (integer, optional, default 10) — Maximum number of results to return.

**Returns:** query, news[]{uuid,title,publisher,link,providerPublishTime,type,thumbnail}

**Example request body:**
```json
{
  "symbol": "AAPL",
  "count": 5
}
```

### POST /finance/v1/v2/market/news — 1 credit
RapidAPI-compatible alias for news

**Parameters:**
- `query` (string, required) — Search keyword OR a ticker symbol to pull news for (either works).
- `symbol` (string, optional) — Ticker symbol to fetch news for (alternative to query).
- `count` (integer, optional, default 10) — Maximum number of results to return.

**Returns:** query, news[]{uuid,title,publisher,link,providerPublishTime,type,thumbnail}

**Example request body:**
```json
{
  "symbol": "AAPL",
  "count": 5
}
```

### POST /finance/v1/v1/options — 1 credit
RapidAPI-compatible alias for options

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `date` (integer, optional) — Optional option-chain expiration as a Unix timestamp; omit for the nearest expiry.

**Returns:** symbol, expirationDates[], strikes[], calls[], puts[] (option contracts)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/most-active — 1 credit
options most-active contracts derived from Yahoo option chains

**Parameters:**
- `symbol` (string, optional) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `symbols` (string, optional) — One or more symbols as an array or comma-separated string (e.g. 'AAPL,MSFT' or ['AAPL','MSFT']).
- `count` (integer, optional, default 25) — Maximum number of results to return.

**Returns:** contracts[] ranked by volume, symbols[], ranking

### POST /finance/v1/v1/unusual-options-activity — 1 credit
unusual options activity derived from Yahoo option chain volume/open-interest

**Parameters:**
- `symbol` (string, optional) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `symbols` (string, optional) — One or more symbols as an array or comma-separated string (e.g. 'AAPL,MSFT' or ['AAPL','MSFT']).
- `count` (integer, optional, default 25) — Maximum number of results to return.

**Returns:** contracts[] ranked by volume/open-interest ratio (unusualScore)

### POST /finance/v1/calendar/earnings — 1 credit
symbol earnings calendar via quoteSummary

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{calendarEvents,earnings}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/calendar/earnings_market — 1 credit
market-wide upcoming earnings calendar (all symbols) via Yahoo visualization

**Parameters:**
- `start` (string, optional) — Earliest earnings date (YYYY-MM-DD) — returns earnings ON or AFTER this day. Defaults to today.
- `end` (string, optional) — Latest earnings date (YYYY-MM-DD) — trims results to ON or BEFORE this day. Optional; omit for all upcoming.
- `count` (integer, optional, default 25) — Max earnings events to return (capped at 100).
- `offset` (integer, optional, default 0) — Pagination offset across the upcoming-earnings list.
- `region` (string, optional, default "US") — Yahoo market region code (e.g. US, GB, DE, FR, IN, JP).
- `lang` (string, optional, default "en-US") — Yahoo response language tag (e.g. en-US).

**Returns:** events[]{symbol,companyName,eventStartDate,eventStartTime,ePSEstimate,reportedEPS,surprise}, calendar_type, start, end — market-wide upcoming earnings across all symbols

**Example request body:**
```json
{
  "count": 5
}
```

### POST /finance/v1/calendar/dividends — 1 credit
symbol dividends via chart events

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, dividends[]

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/calendar/economic_events — 1 credit
global economic events via Yahoo visualization calendar

**Parameters:**
- `start` (string, optional) — Window start date (YYYY-MM-DD). Defaults to today.
- `end` (string, optional) — Window end date (YYYY-MM-DD). Defaults to ~30 days out.
- `count` (integer, optional, default 25) — Max events to return (capped at 100).
- `offset` (integer, optional, default 0) — Event pagination offset.

**Returns:** events[] — global economic events, calendar_type, start, end

### POST /finance/v1/calendar/public_offerings — 1 credit
public offerings derived from Yahoo IPO calendar deal types

**Parameters:**
- `start` (string, optional) — Window start date (YYYY-MM-DD). Defaults to today.
- `end` (string, optional) — Window end date (YYYY-MM-DD). Defaults to ~30 days out.
- `count` (integer, optional, default 25) — Max events to return (capped at 100).
- `offset` (integer, optional, default 0) — Event pagination offset.

**Returns:** events[] — public offerings derived from IPO deal types

### POST /finance/v1/calendar/ipo — 1 credit
IPO calendar via Yahoo visualization calendar

**Parameters:**
- `start` (string, optional) — Window start date (YYYY-MM-DD). Defaults to today.
- `end` (string, optional) — Window end date (YYYY-MM-DD). Defaults to ~30 days out.
- `count` (integer, optional, default 25) — Max events to return (capped at 100).
- `offset` (integer, optional, default 0) — Event pagination offset.

**Returns:** events[] — IPO calendar, calendar_type, start, end

### POST /finance/v1/calendar/stock-splits — 1 credit
symbol stock splits via chart events

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, splits[]

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/calendar/count — 1 credit
count of calendar events in a window (economic/ipo)

**Parameters:**
- `calendar_type` (enum, optional) — Which calendar to count events from. [one of: economic_event, ipo_info, ipo]
- `start` (string, optional) — Window start date (YYYY-MM-DD). Defaults to today.
- `end` (string, optional) — Window end date (YYYY-MM-DD). Defaults to ~30 days out.

**Returns:** calendar_type, count, start, end

### POST /finance/v1/futures — 1 credit
futures chain: related contract months via Yahoo futuresChain

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, futures[] (related contract months), details

**Example request body:**
```json
{
  "symbol": "ES=F"
}
```

### POST /finance/v1/insights — 1 credit
trading insights: technical events, key technicals, valuation, recommendation, significant developments

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `reportsCount` (integer, optional, default 5) — How many research/insights reports to include.

**Returns:** symbol, instrumentInfo, recommendation, significantDevelopments[], events, companySnapshot

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/research — 1 credit
what analysts are saying: research-report metadata via Yahoo insights

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `reportsCount` (integer, optional, default 5) — How many research/insights reports to include.

**Returns:** symbol, reports[] (analyst research metadata)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/fund/fees — 1 credit
ETF/mutual-fund fees and expenses via Yahoo fundProfile

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, fees, feesCategory, family, categoryName, legalType, managementInfo

**Example request body:**
```json
{
  "symbol": "SPY"
}
```

### POST /finance/v1/fund/holdings — 1 credit
ETF/mutual-fund top holdings, sector weightings, asset allocation via Yahoo topHoldings

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, holdings[], sectorWeightings[], allocation{stock,bond,cash,...}

**Example request body:**
```json
{
  "symbol": "SPY"
}
```

### POST /finance/v1/recommendations — 1 credit
peer/similar symbols via Yahoo recommendationsbysymbol

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, recommendedSymbols[] (peer/similar symbols)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/news/details — 1 credit
full news article content by uuid via Yahoo caas

**Parameters:**
- `uuid` (string, required) — Yahoo news article uuid (from a news item's `uuid`).

**Returns:** uuid, title, summary, author, publishedAt, provider, url, body_html

### POST /finance/v1/screener/fields — 1 credit
queryable screener field catalog (filters) via Yahoo screeners

**Parameters:**
- `type` (enum, optional, default "equity") — Instrument whose screener field catalog to return. [one of: equity, mutualfund, etf, index, future]

**Returns:** instrument, fields[]{id,displayName,type,sortable}

**Example request body:**
```json
{
  "type": "equity"
}
```

### POST /finance/v1/market/tickers-by-type — 1 credit
symbol lookup filtered by quote type (equity/etf/mutualfund/future/index/currency)

**Parameters:**
- `query` (string, required) — Free-text search query (company name or symbol).
- `type` (enum, optional) — Restrict the symbol lookup to one quote type. Omit for all types. [one of: equity, etf, mutualfund, index, currency, cryptocurrency, future]
- `count` (integer, optional, default 20) — Maximum number of results to return.

**Returns:** query, type, documents[] — symbols filtered by quote type

**Example request body:**
```json
{
  "query": "apple"
}
```

### POST /finance/v1/v1/stock/profile — 1 credit
quoteSummary alias for assetProfile,summaryProfile

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{assetProfile,summaryProfile}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/statistics — 1 credit
quoteSummary alias for defaultKeyStatistics

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{defaultKeyStatistics}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/financial-data — 1 credit
quoteSummary alias for financialData

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{financialData}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/sec-filings — 1 credit
quoteSummary alias for secFilings,assetProfile

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{secFilings,assetProfile}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/earnings — 1 credit
quoteSummary alias for earnings,earningsTrend,earningsHistory

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{earnings,earningsTrend,earningsHistory}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/calendar-events — 1 credit
quoteSummary alias for calendarEvents

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{calendarEvents}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/insider-holders — 1 credit
quoteSummary alias for insiderHolders

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{insiderHolders}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/balance-sheet — 1 credit
quoteSummary alias for balanceSheetHistory

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{balanceSheetHistory}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v2/stock/balance-sheet — 1 credit
quoteSummary alias for balanceSheetHistory,balanceSheetHistoryQuarterly

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{balanceSheetHistory,balanceSheetHistoryQuarterly}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/institution-ownership — 1 credit
quoteSummary alias for institutionOwnership

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{institutionOwnership}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/insider-transactions — 1 credit
quoteSummary alias for insiderTransactions

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{insiderTransactions}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/index-trend — 1 credit
quoteSummary alias for indexTrend

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{indexTrend}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/income-statement — 1 credit
quoteSummary alias for incomeStatementHistory,incomeStatementHistoryQuarterly

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{incomeStatementHistory,incomeStatementHistoryQuarterly}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/cashflow-statement — 1 credit
quoteSummary alias for cashflowStatementHistory,cashflowStatementHistoryQuarterly

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{cashflowStatementHistory,cashflowStatementHistoryQuarterly}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/recommendation-trend — 1 credit
quoteSummary alias for recommendationTrend

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{recommendationTrend}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/net-share-purchase-activity — 1 credit
quoteSummary alias for netSharePurchaseActivity

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{netSharePurchaseActivity}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/stock/upgrade-downgrade-history — 1 credit
quoteSummary alias for upgradeDowngradeHistory

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{upgradeDowngradeHistory}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/insider-trades — 1 credit
quoteSummary alias for insiderTransactions,insiderHolders,netSharePurchaseActivity

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, modules{insiderTransactions,insiderHolders,netSharePurchaseActivity}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/indicators/sma — 1 credit
local SMA indicator from chart OHLCV

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]
- `period` (integer, optional, default 20) — Lookback period for the single moving-average indicator.

**Returns:** symbol, indicator (sma), key, value

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/indicators/rsi — 1 credit
local RSI indicator from chart OHLCV

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]

**Returns:** symbol, indicator (rsi), key, value

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/indicators/macd — 1 credit
local MACD indicator from chart OHLCV

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]

**Returns:** symbol, indicator (macd), key, value

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/v1/indicators/adx — 1 credit
local ADX indicator from chart OHLCV

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `range` (enum, optional, default "1mo") — History window. Common Yahoo ranges shown; other Yahoo range tokens are also accepted. Pair with interval. [one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max]
- `interval` (enum, optional, default "1d") — Candle granularity. Intraday intervals only cover short ranges (Yahoo limitation); daily+ cover long ranges. [one of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo]

**Returns:** symbol, indicator (adx), key, value

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/get-futures-chain — 1 credit
apidojo-compatible alias for futures

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, futures[] (related contract months), details

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/get-insights — 1 credit
apidojo-compatible alias for insights

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `reportsCount` (integer, optional, default 5) — How many research/insights reports to include.

**Returns:** symbol, instrumentInfo, recommendation, significantDevelopments[], events, companySnapshot

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/v3/get-insights — 1 credit
apidojo-compatible alias for insights

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `reportsCount` (integer, optional, default 5) — How many research/insights reports to include.

**Returns:** symbol, instrumentInfo, recommendation, significantDevelopments[], events, companySnapshot

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/get-what-analysts-are-saying — 1 credit
apidojo-compatible alias for research

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.
- `reportsCount` (integer, optional, default 5) — How many research/insights reports to include.

**Returns:** symbol, reports[] (analyst research metadata)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/get-fees-and-expenses — 1 credit
apidojo-compatible alias for fund/fees

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, fees, feesCategory, family, categoryName, legalType, managementInfo

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/get-top-holdings — 1 credit
apidojo-compatible alias for fund/holdings

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, holdings[], sectorWeightings[], allocation{stock,bond,cash,...}

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/stock/v2/get-recommendations — 1 credit
apidojo-compatible alias for recommendations

**Parameters:**
- `symbol` (string, required) — Ticker symbol (Yahoo format: equities 'AAPL', crypto 'BTC-USD', FX 'EURUSD=X', index '^GSPC', future 'ES=F'). Case-insensitive.

**Returns:** symbol, recommendedSymbols[] (peer/similar symbols)

**Example request body:**
```json
{
  "symbol": "AAPL"
}
```

### POST /finance/v1/news/v2/get-details — 1 credit
apidojo-compatible alias for news/details

**Parameters:**
- `uuid` (string, required) — Yahoo news article uuid (from a news item's `uuid`).

**Returns:** uuid, title, summary, author, publishedAt, provider, url, body_html

### POST /finance/v1/screeners/get-filters — 1 credit
apidojo-compatible alias for screener/fields

**Parameters:**
- `type` (enum, optional, default "equity") — Instrument whose screener field catalog to return. [one of: equity, mutualfund, etf, index, future]

**Returns:** instrument, fields[]{id,displayName,type,sortable}

### POST /finance/v1/market/get-tickers-by-quote-type — 1 credit
apidojo-compatible alias for market/tickers-by-type

**Parameters:**
- `query` (string, required) — Free-text search query (company name or symbol).
- `type` (enum, optional) — Restrict the symbol lookup to one quote type. Omit for all types. [one of: equity, etf, mutualfund, index, currency, cryptocurrency, future]
- `count` (integer, optional, default 20) — Maximum number of results to return.

**Returns:** query, type, documents[] — symbols filtered by quote type

**Example request body:**
```json
{
  "query": "apple"
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=finance
- Human docs page: https://reefapi.com/docs/finance
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt