API Changelog
Details
Docs navigation
- Getting started: Quickstart, Authentication, Rate limits, Errors and retries
- Guides: Symbol formats, Timestamps and time zones, Pagination, Split and dividend adjustments, WebSocket streaming, Dataset downloads, Excel and Google Sheets, Changelog (you are here)
- API reference: Stock bars, Stock trades and quotes, Snapshots and movers, Tickers, exchanges, calendar, Splits and dividends, Fundamentals and SEC filings, Options chain and Greeks, Options EOD, bars, OI, Forex, Crypto, Crypto derivatives, Futures bars and continuous, Settlements and COT, Indices, Economic data, Technical indicators
- SDKs: Python, JavaScript
Every change to the marketdata.co API, our file formats and the free sample library is logged here, newest first. If you build on our data, watch this page: anything that could break your code will appear here before it ships. We are in early access, so for now most entries are about samples and the planned v1 design rather than live endpoints.
Details
Log
2026-11-19: Free sample library published
- 19 free datasets, 8,544 rows in total, now downloadable from /sample-data.
- Each download is a ZIP with the same rows as CSV and JSON plus a
README.txtthat states the source, licence and credit line. - Every ZIP has a published SHA-256 checksum.
- Coverage: crypto bars, trades, funding rates, open interest and order book depth (Binance); ECB euro reference rates; CFTC Traders in Financial Futures; US Treasury nominal and real yield curves; US economic indicators and oil and gas spot prices via FRED; SEC EDGAR financials for eight large US companies.
- All files use the house schema:
snake_casenames, ISO 8601 UTC timestamps,YYYY-MM-DDdates, numbers as numbers.
2026-11-19: Planned v1 API documented
- Docs for the v1 REST API, WebSocket streaming and dataset files published at /docs.
- Base URL set as
https://api.marketdata.co/v1. - Proposed symbol formats:
AAPL,BTC-USD,EURUSD,ESZ6,ES.C1, OCC option symbols such asAAPL261218C00200000, andESZ6-C6000for options on futures. See symbol formats. - Error format and codes fixed for v1. See errors.
- None of the API endpoints are live yet. Join early access to get a key when they open.
Coming next
These are planned, not promised dates:
- Early-access API keys for the first group of sign-ups.
- First live endpoints: reference data, daily bars and the economic data series.
- An official Python client. Until then, the Python quickstart uses
requestsand pandas.
API
How we version the API
The version is in the path: /v1/. Within a version we only make additive changes.
Changes we can make inside v1 without notice:
- New endpoints.
- New optional parameters.
- New fields in a response. Write your parsers to ignore fields they don't know.
- New values in an enum such as
action_typeorsession. - More symbols, venues or history.
Changes that need a new version or advance notice here:
- Removing or renaming a field or parameter.
- A change to a field's type, units or meaning.
- Different default behaviour, for example switching bars from adjusted to raw by default.
- Removing an endpoint.
When a breaking change is needed, the old version keeps running alongside the new one, and the date it will be switched off is posted on this page first.
Details
Data corrections
Market data gets corrected: exchanges bust trades, companies restate earnings, agencies revise economic numbers. We log corrections to historical data here when they affect more than a single record, with the dataset, date range and what changed. Single-record fixes show up in the record itself, through fields such as updated_at on corporate actions and is_restated on fundamentals.
Watch out
Notes and gotchas
- Dates on this page are in UTC.
- An entry here does not mean a dataset is live. Each entry says whether it is planned, in early access or available.
- The free sample files are a snapshot. They are refreshed from time to time; the checksum changes when the content does.
- Sample licences differ by source. The Binance files carry a note to check Binance terms before commercial display.
Keep reading
Next steps
Details
Was this page useful?
[Yes] [No]
Want an endpoint or dataset added to the plan? Tell us on the custom data form.