Early access is open. Free sample datasets are live now. Download a sample

marketdata.co

Market Data API: REST and WebSocket

One base URL, one API key, six asset classes. REST for history and snapshots, WebSocket for streams. Every response uses the same field names, so a bar is a bar whether it is AAPL, EURUSD or BTC-USDT.

The API is in early access, and the calls below show the planned shape. They are examples, not live endpoints yet.

Details

REST

Send a GET request to https://api.marketdata.co with your key in the Authorization header. You get JSON back. Large history requests page with a cursor, so a loop pulls a full date range without guessing offsets. Timestamps are ISO 8601 in UTC, daily rows use date as YYYY-MM-DD, and every record has a symbol.

Details

WebSocket

Open one connection, subscribe to symbols, and receive the same records the REST API returns, one message per update. Streams are planned for live prices, trades and bars on the plans listed below. Real-time US stock, options and futures streams depend on exchange licences, so those open later than crypto and FX.

Markets

One call per asset class

All examples. Field names come from our published schema.

Stocks: daily bars

curl -H "Authorization: Bearer $MD_KEY" \
  "https://api.marketdata.co/v1/stocks/bars?symbol=AAPL&interval=1d&start=2025-01-01&end=2025-12-31"

Options: chain snapshot with Greeks

curl -H "Authorization: Bearer $MD_KEY" \
  "https://api.marketdata.co/v1/options/chain?underlying_symbol=AAPL&expiration_date=2026-12-18"

Each contract comes back with bid, ask, mid, open_interest, implied_volatility, delta, gamma, theta and vega.

Forex: daily rates

import requests

r = requests.get(
    "https://api.marketdata.co/v1/forex/daily",
    params={"symbol": "EURUSD", "start": "2026-01-01"},
    headers={"Authorization": "Bearer YOUR_KEY"},
)
rows = r.json()["results"]

Crypto: 1-minute bars

import pandas as pd
import requests

r = requests.get(
    "https://api.marketdata.co/v1/crypto/bars",
    params={"symbol": "BTC-USDT", "exchange": "binance", "interval": "1m"},
    headers={"Authorization": "Bearer YOUR_KEY"},
)
df = pd.DataFrame(r.json()["results"]).set_index("timestamp")

Futures: continuous front month

curl -H "Authorization: Bearer $MD_KEY" \
  "https://api.marketdata.co/v1/futures/continuous?symbol=ES.C1&adjustment=back_adjusted&interval=1d"

Indices: daily levels

curl -H "Authorization: Bearer $MD_KEY" \
  "https://api.marketdata.co/v1/indices/bars?symbol=SPX&interval=1d"

Pricing

Limits by plan

Limits are still being set during early access, and the final numbers will go on Rate Limits and Plan Quotas before launch. This is what is planned so far:

Plan Price Planned access
Free $0 Reference data, about 2 years of daily stock bars, 1 year of options EOD, daily FX (1 day delay), daily crypto bars, funding rates, CFTC and economic data. Low rate limit, for example 5 calls per minute on stock daily bars and 10,000 calls a month on crypto prices.
Starter $29/mo Full daily history, delayed intraday stocks, options and FX, fundamentals, filings, 30 days of crypto trades. Higher limits.
Pro $79/mo Real-time stocks, options chains and crypto, WebSocket streams, 10 years of stock trades, intraday continuous futures.
Business $249/mo Full quote history, real-time options flow, full crypto L2 books, futures tick. Commercial internal use.
Enterprise Quote Full depth, analyst estimates, redistribution.

Details

Docs

FAQ

Frequently asked questions

Can I call the API today?

Not yet. The API is in early access and the examples on this page show the planned shape. You can download real free sample files now from sample data.

Which symbol formats does the API use?

Stocks use the plain ticker (AAPL), forex the six-letter pair (EURUSD), crypto a dash pair (BTC-USD), futures the contract code (ESZ6) with ES.C1 for continuous series, and options the OCC symbol (AAPL261218C00200000).

Is the data real-time?

Crypto and FX can be real-time from Starter or Pro. US stocks, options, futures and index levels need exchange licences, so they start delayed or end of day and move to real-time as we sign those licences.

What does the API return?

JSON with a results array of records. Field names are snake_case and written out in full, so you get open, high, low, close and volume, not single letters.

Can I use the data in a commercial app?

Commercial internal use starts at Business ($249 a month). Public display and redistribution are Enterprise terms, because most exchange licences charge separately for them.

Get started

Join early access

Tell us which endpoints you would call first. We build in that order.