API Reference

Market Data API

End-of-day price data, dividends, and Finviz fundamentals for S&P 500 and NASDAQ-listed stocks.

Introduction

The Market Data API tracks stocks listed in the S&P 500 or NASDAQ.

It provides end-of-day price data from 2000 onwards.

New: Use the range parameter for efficient server-side filtering. This automatically optimizes data points based on the time period you need, reducing bandwidth and improving performance.

Authorization

Authorization is done using the Authorization header with a Bearer token.

Price

Historical end-of-day price data with flexible range filtering.

GET/api/market-data/v1/historical-prices?symbol=AAPL&range=year

Params

ParamRequiredTypeDescription
symboltruestringStock symbol
rangefalsestring Predefined time ranges for efficient filtering:
  • all — Last 10 years (monthly data points)
  • 5years — Last 5 years (monthly data points)
  • year — Last 1 year (every 3rd day)
  • month — Last 1 month (daily data points)
Default: 5years
fromfalsestring Date in format: YYYY-MM-DD
Default: 1 year ago
tofalsestringDate in format: YYYY-MM-DD

Examples

Using range parameter (recommended):

GET/api/market-data/v1/historical-prices?symbol=AAPL&range=year

Using from/to parameters:

GET /api/market-data/v1/historical-prices?symbol=AAPL&from=2023-01-01&to=2024-01-01

Range Parameter Examples

Returns

Dividend

Historical dividend payments for a given stock symbol.

GET/api/market-data/v1/dividend?symbol=AAPL

Params

ParamTypeDescription
symbolstringStock symbol

Returns

Finviz

Returns scraped Finviz fundamental and technical data for one or more symbols. Includes metrics like RSI, P/E ratios, EPS, ROE, ROA, ROIC, profit margin, beta, SMA50/200, and more.

GET/api/market-data/v1/finviz?symbols=AAPL,AMD,NVDA

Params

ParamRequiredTypeDescription
symbolstruestring Comma-separated stock symbols (e.g. AAPL,AMD,NVDA)

Returns

All values are returned as strings. Fields include: symbol, price, sma50, sma200, rsi, pe_trailing, pe_forward, peg, eps, market_cap, roa, roe, roic, profit_margin, beta, and updatedAt.