Docs
marketdata.co API Docs and Guides
Start with Getting Started for keys and your first request, then use the reference pages for each endpoint and file schema.
Getting started
- Getting Started with the marketdata.co API
Market data API quickstart: get a key, make your first request for stock bars in curl or Python, and read the JSON or CSV response. - API Keys and Authentication
How your market data API key works: send it as a Bearer header or query parameter, keep it out of code, rotate it and fix 401 errors. - Rate Limits and Plan Quotas
API rate limits for market data on each marketdata.co plan, the headers that report them, and how to back off after a 429 response. - Error Codes and Retries
Every API error code the marketdata.co API returns, what causes it, which ones are safe to retry and a retry pattern you can copy. - API Changelog
The marketdata.co changelog: every change to the API, symbol formats, datasets and free sample files, newest first, with dates.
Guides
- Symbol Formats: Stocks, Options, FX, Crypto and Futures
Symbol formats for every asset class, including the OCC option symbol format, futures month codes, FX pairs and crypto pairs, with examples. - Timestamps, Time Zones and Trading Sessions
Market data timestamps in UTC: how bars are stamped, how daily dates work per exchange, and how sessions and daylight saving affect your data. - Pagination and Large Requests
How API pagination with a cursor works in the marketdata.co API, page size limits, and how to pull years of minute or tick data safely. - WebSocket Streaming Guide
Stream real time market data over WebSocket: connect, authenticate, subscribe to trades, quotes and bars, and reconnect cleanly. - Dataset Downloads: File Formats, CSV and Parquet
Market data Parquet download and CSV files: what is in each file, how files are split, how to check them and how to load them in Python. - Split and Dividend Adjustments
Split adjusted price calculation explained: how marketdata.co adjusts stock bars for splits and dividends, with the formulas and code.
SDKs and tools
- Python Quickstart with pandas
Stock data in Python with the marketdata.co API: fetch bars with requests, load them into pandas, page through history and resample. - JavaScript and Node.js Quickstart
Use the stock API from JavaScript: fetch bars and snapshots in Node.js with fetch, page through history and stream trades over WebSocket. - Market Data in Excel and Google Sheets
Get stock data in Google Sheets and Excel with one URL: IMPORTDATA, Power Query and CSV downloads, with refresh tips and key safety.
API reference
- API Reference: Stock Bars
Stock bars API endpoint reference: daily, weekly, monthly and 1-second to 1-hour OHLCV for US stocks and ETFs, with parameters and fields. - API Reference: Stock Trades and Quotes
Stock trades API endpoint and NBBO quotes endpoint reference: tick-level prints and top-of-book changes with nanosecond UTC timestamps. - API Reference: Snapshots and Movers
Stock snapshot endpoint reference: latest price, bid, ask and day stats for up to 250 symbols per call, plus top gainers, losers and most active. - API Reference: Tickers, Exchanges and Market Calendar
Ticker list endpoint reference: every US stock and ETF with identifiers, plus exchanges, market status and the trading holiday calendar. - API Reference: Splits and Dividends
Dividends API endpoint reference: cash and stock dividends, splits, symbol changes, mergers and delistings with ex, record and pay dates. - API Reference: Fundamentals and SEC Filings
Fundamentals API endpoint reference: income statement, balance sheet and cash flow facts from SEC filings, point in time, plus the filings index. - API Reference: Options Chain and Greeks
Options chain endpoint reference: every strike and expiry for an underlying with NBBO, volume, open interest, IV and Greeks, plus contract lists. - API Reference: Options EOD, Bars and Open Interest
Options history API reference: end-of-day option prices with Greeks, intraday option bars and daily open interest for any OCC contract. - API Reference: Forex Rates and Bars
Forex API endpoint reference: latest bid, ask and mid, currency conversion, daily rates, intraday bars and tick history for currency pairs. - API Reference: Crypto Prices, Bars and Trades
Crypto API endpoint reference: latest prices and market caps, OHLCV bars from 1 second to 1 day, and tick-level trades per exchange. - API Reference: Funding, Open Interest and Liquidations
Funding rate API endpoint reference: perpetual funding history, open interest, long/short ratios, basis and liquidations per exchange. - API Reference: Futures Bars and Continuous Contracts
Futures API endpoint reference: OHLCV bars per contract, continuous back-adjusted series with roll rules, and contract specs and expiries. - API Reference: Settlements and COT Positioning
COT API endpoint reference: weekly CFTC Commitments of Traders positioning by trader group, plus daily futures settlements, OI and limits. - API Reference: Index Levels
Index data API endpoint reference: daily and intraday levels for SPX, NDX, DJI, RUT and VIX, with parameters, fields and licensing notes. - API Reference: Economic Data and Calendars
Economic data API endpoint reference: CPI, payrolls, GDP, fed funds and Treasury yields as time series, plus the economic release calendar. - API Reference: Technical Indicators
Technical indicators endpoint reference: RSI, MACD, moving averages, Bollinger Bands and ATR calculated server-side for any symbol and interval.