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
Start with Getting Started, then API Keys and Authentication, Symbol Formats and WebSocket Streaming.
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.