Account and reference

Your key, the plans, coverage, bulk files.

Your key and plan

GET/v1/me

GET/v1/status

Your plan, rate, burst, daily quota and what is used, the first session you may ask for, your stream limits and your platform add-ons. Read it at start-up and pace yourself from it. /v1/status is free: never counted, never rate-limited.

Fields of /me14

namestring
tierstring
accessstring[]
rate, burstnumber
statusstring \| null
grace_untilstring \| null
plan_untilstring \| null
history_fromstring \| null
exportboolean
symbolsstring
addonsstring[]
multi_indicatorboolean
noticesstring[]
limitsobject

Fields of /status11

planstring
plan_untilstring \| null
modestring
mode_labelstring
account.name, attested, status, internalstring, boolean, string \| null, boolean
usage.apiobject
usage.rateobject
usage.chatobject \| null
usage.streamobject
reachobject
productsobject

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/me"

Response

{"data": {"name": "my-trading-key","tier": "trader","access": ["site", "api"],"rate": 2.0,"burst": 10.0,"history_from": "2026-09-24","export": false,"symbols": "all","addons": [],"limits": {"rate": 2.0,"burst": 10.0,"history_from": "2026-09-24","per_day": 1000,"used_today": 0,"quota_resets_at": "2026-10-25T03:59:59Z","stream_symbols_per_connection": 25,"stream_connections": 2,"chat_per_day": 30,…},"notices": []},"meta": {"as_of": "2026-10-24T07:20:23Z"}}

Plans and prices

GET/v1/plans

Every plan on sale, in order, with its price, whether you can sign up now or join the waitlist, what it includes, Ask Marlon's questions a day and its limits. No parameters and no key needed; never counted against a key and not rate-limited by one.

Response fields23

plans[].tierstring
plans[].namestring
plans[].availabilitystring
plans[].price.monthnumberUSD
plans[].price.yearnumber \| nullUSD
plans[].price.lifetimenumber \| nullUSD
plans[].limits.rate, .burstnumberrequests per second; requests
plans[].limits.calls_per_dayinteger \| nullcalls
plans[].limits.history, .history_reachstring \| null; string
plans[].limits.symbolsstring
plans[].limits.exportboolean
plans[].products.dashboardstring \| null
plans[].products.terminalboolean \| null
plans[].products.api_mcpstring \| null
plans[].products.stream.symbols, .connectionsinteger \| nullsymbols; connections
plans[].products.compatible_apisboolean \| null
plans[].products.bulk_exportboolean
plans[].products.supportstring \| null
plans[].chat_per_dayinteger \| nullquestions
plans[].includesstring[]
currencystring
notesstring
meta.as_ofstringRFC 3339 UTC

Request

curl "https://api.datafirsttrading.com/v1/plans"

Response

{"data": {"plans": […,{"tier": "basic","name": "Basic","availability": "open","price": {"month": 49.99, "year": 449.99, "lifetime": 1499.0},"limits": {"rate": 1.0, "burst": 5.0, "calls_per_day": 250, "history": "5s", …},"products": {"dashboard": "full", "terminal": false, "api_mcp": "trial", "stream": {"symbols": 5, "connections": 1}, …},"chat_per_day": 15,"includes": ["The full dashboard", "The last 5 sessions", "API and MCP: 250 calls a day"]},{"tier": "trader","name": "Trader","availability": "waitlist","price": {"month": 99.0, "year": 899.99, "lifetime": null},…},…],"currency": "USD","notes": "…"},"meta": {"as_of": "2026-10-26T20:52:44Z"}}

What is covered

GET/v1/symbols

GET/v1/symbols/{symbol}/expirations

GET/v1/symbols/{symbol}/spot

Every symbol with listed options, each one's live expirations and its term set, and its spot price.

Parameters

symbolstringrequired
/expirations and /spot: the ticker.

Fields of /symbols2

symbolsstring[]
countinteger

Fields of /expirations2

expirationsstring[]
term_selectionstring[]

Fields of /spot1

pricenumberUSD

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/symbols/SPY/expirations"

Response

{"data": {"expirations": ["2026-10-02", "2026-10-05", …],"term_selection": ["2026-10-07", "2026-10-09", …]},"meta": {"symbol": "SPY", "as_of": "2026-10-02T13:31:59.203Z"}}

Pricing inputs

GET/v1/reference

GET/v1/symbols/{symbol}/reference

Reference data: rates, dividend yields, the contract multiplier, expiry times and sectors; and one symbol's details.

Parameters

symbolstringrequired
/v1/symbols/{symbol}/reference: the ticker.

Fields of /reference7

rates.points[][number, number][]years, fraction
The rate curve.
rates.ratenumberfraction
A single rate, given instead of points.
rates.loadedAtintegerepoch s
When the rates last updated.
dividend_yieldsobjectfraction
Dividend yield per symbol.
conventions.multiplierobjectshares
100 shares per contract; adjusted series are flagged (adjusted on the symbol's reference).
conventions.expiry_timeobject
pm or am settlement, by root.
conventions.time_to_expiry, atm_band, spot, sectors
Reference conventions for this data.

Fields of /reference7

rates.points[][number, number][]years, fraction
The rate curve.
rates.ratenumberfraction
A single rate, given instead of points.
rates.loadedAtintegerepoch s
When the rates last updated.
dividend_yieldsobjectfraction
Dividend yield per symbol.
conventions.multiplierobjectshares
100 shares per contract; adjusted series are flagged (adjusted on the symbol's reference).
conventions.expiry_timeobject
pm or am settlement, by root.
conventions.time_to_expiry, atm_band, spot, sectors
Reference conventions for this data.

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/symbols/SPX/reference"

Response

{"data": {"symbol": "SPX","roots": ["SPX", "SPXW"],"underlying": "SPX","adjusted": false,"is_index": true,"sessions": {"first": "2025-06-30", "last": "2026-10-16", "count": 285},"multiplier": 100,"multiplier_known": true,"expiry_time": "pm","dividend_yield": 0.0,"sector": "NOT_APPLICABLE","industry": "NOT_APPLICABLE","sic": null},"meta": {"symbol": "SPX", "as_of": "2026-10-10T19:20:11Z"}}

Bulk export

Quant

GET/v1/export

GET/v1/export/{date}

GET/v1/export/{date}/{dataset}

Every finished session as Parquet files: levels, the exposure grid, net flow, trades and orders. List the sessions, read one session's manifest, then download each file.

Parameters

datestringrequired
A session from /v1/export, YYYY-MM-DD.
datasetenumrequired
levels, interval_map, netflow, trades, orders.

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/export/2026-10-09" curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \-o 2026-10-09-levels.parquet \"https://api.datafirsttrading.com/v1/export/2026-10-09/levels"

Response

{"data": {"session": "2026-10-09","built_at": "2026-10-09T22:04:11Z","units": {"premium": "USD", "size": "contracts", …},"datasets": {"levels": {"file": "levels.parquet","rows": 962459,"bytes": 6860635,"sha256": "…","columns": [{"name": "ts_ms", "type": "int64"}, …],"url": "/v1/export/2026-10-09/levels"},…}},"meta": {"as_of": "2026-10-11T14:06:00Z"}}

Account and reference

Your key, the plans, coverage, bulk files.

Your key and plan

GET/v1/me

GET/v1/status

Fields of /me14

namestring
tierstring
accessstring[]
rate, burstnumber
statusstring \| null
grace_untilstring \| null
plan_untilstring \| null
history_fromstring \| null
exportboolean
symbolsstring
addonsstring[]
multi_indicatorboolean
noticesstring[]
limitsobject

Fields of /status11

planstring
plan_untilstring \| null
modestring
mode_labelstring
account.name, attested, status, internalstring, boolean, string \| null, boolean
usage.apiobject
usage.rateobject
usage.chatobject \| null
usage.streamobject
reachobject
productsobject

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/me"

Response

{"data": {"name": "my-trading-key","tier": "trader","access": ["site", "api"],"rate": 2.0,"burst": 10.0,"history_from": "2026-09-24","export": false,"symbols": "all","addons": [],"limits": {"rate": 2.0,"burst": 10.0,"history_from": "2026-09-24","per_day": 1000,"used_today": 0,"quota_resets_at": "2026-10-25T03:59:59Z","stream_symbols_per_connection": 25,"stream_connections": 2,"chat_per_day": 30,…},"notices": []},"meta": {"as_of": "2026-10-24T07:20:23Z"}}

Plans and prices

GET/v1/plans

Response fields23

plans[].tierstring
plans[].namestring
plans[].availabilitystring
plans[].price.monthnumberUSD
plans[].price.yearnumber \| nullUSD
plans[].price.lifetimenumber \| nullUSD
plans[].limits.rate, .burstnumberrequests per second; requests
plans[].limits.calls_per_dayinteger \| nullcalls
plans[].limits.history, .history_reachstring \| null; string
plans[].limits.symbolsstring
plans[].limits.exportboolean
plans[].products.dashboardstring \| null
plans[].products.terminalboolean \| null
plans[].products.api_mcpstring \| null
plans[].products.stream.symbols, .connectionsinteger \| nullsymbols; connections
plans[].products.compatible_apisboolean \| null
plans[].products.bulk_exportboolean
plans[].products.supportstring \| null
plans[].chat_per_dayinteger \| nullquestions
plans[].includesstring[]
currencystring
notesstring
meta.as_ofstringRFC 3339 UTC

Request

curl "https://api.datafirsttrading.com/v1/plans"

Response

{"data": {"plans": […,{"tier": "basic","name": "Basic","availability": "open","price": {"month": 49.99, "year": 449.99, "lifetime": 1499.0},"limits": {"rate": 1.0, "burst": 5.0, "calls_per_day": 250, "history": "5s", …},"products": {"dashboard": "full", "terminal": false, "api_mcp": "trial", "stream": {"symbols": 5, "connections": 1}, …},"chat_per_day": 15,"includes": ["The full dashboard", "The last 5 sessions", "API and MCP: 250 calls a day"]},{"tier": "trader","name": "Trader","availability": "waitlist","price": {"month": 99.0, "year": 899.99, "lifetime": null},…},…],"currency": "USD","notes": "…"},"meta": {"as_of": "2026-10-26T20:52:44Z"}}

What is covered

GET/v1/symbols

GET/v1/symbols/{symbol}/expirations

GET/v1/symbols/{symbol}/spot

Every symbol with listed options, each one's live expirations and its term set, and its spot price.

Parameters

symbolstringrequired
/expirations and /spot: the ticker.

Fields of /symbols2

symbolsstring[]
countinteger

Fields of /expirations2

expirationsstring[]
term_selectionstring[]

Fields of /spot1

pricenumberUSD

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/symbols/SPY/expirations"

Response

{"data": {"expirations": ["2026-10-02", "2026-10-05", …],"term_selection": ["2026-10-07", "2026-10-09", …]},"meta": {"symbol": "SPY", "as_of": "2026-10-02T13:31:59.203Z"}}

Pricing inputs

GET/v1/reference

GET/v1/symbols/{symbol}/reference

Reference data: rates, dividend yields, the contract multiplier, expiry times and sectors; and one symbol's details.

Parameters

symbolstringrequired
/v1/symbols/{symbol}/reference: the ticker.

Fields of /reference7

rates.points[][number, number][]years, fraction
The rate curve.
rates.ratenumberfraction
A single rate, given instead of points.
rates.loadedAtintegerepoch s
When the rates last updated.
dividend_yieldsobjectfraction
Dividend yield per symbol.
conventions.multiplierobjectshares
100 shares per contract; adjusted series are flagged (adjusted on the symbol's reference).
conventions.expiry_timeobject
pm or am settlement, by root.
conventions.time_to_expiry, atm_band, spot, sectors
Reference conventions for this data.

Fields of /reference7

rates.points[][number, number][]years, fraction
The rate curve.
rates.ratenumberfraction
A single rate, given instead of points.
rates.loadedAtintegerepoch s
When the rates last updated.
dividend_yieldsobjectfraction
Dividend yield per symbol.
conventions.multiplierobjectshares
100 shares per contract; adjusted series are flagged (adjusted on the symbol's reference).
conventions.expiry_timeobject
pm or am settlement, by root.
conventions.time_to_expiry, atm_band, spot, sectors
Reference conventions for this data.

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/symbols/SPX/reference"

Response

{"data": {"symbol": "SPX","roots": ["SPX", "SPXW"],"underlying": "SPX","adjusted": false,"is_index": true,"sessions": {"first": "2025-06-30", "last": "2026-10-16", "count": 285},"multiplier": 100,"multiplier_known": true,"expiry_time": "pm","dividend_yield": 0.0,"sector": "NOT_APPLICABLE","industry": "NOT_APPLICABLE","sic": null},"meta": {"symbol": "SPX", "as_of": "2026-10-10T19:20:11Z"}}

Bulk export

Quant

GET/v1/export

GET/v1/export/{date}

GET/v1/export/{date}/{dataset}

Every finished session as Parquet files: levels, the exposure grid, net flow, trades and orders. List the sessions, read one session's manifest, then download each file.

Parameters

datestringrequired
A session from /v1/export, YYYY-MM-DD.
datasetenumrequired
levels, interval_map, netflow, trades, orders.

Request

curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \"https://api.datafirsttrading.com/v1/export/2026-10-09" curl -H "Authorization: Bearer $DATAFIRST_API_KEY" \-o 2026-10-09-levels.parquet \"https://api.datafirsttrading.com/v1/export/2026-10-09/levels"

Response

{"data": {"session": "2026-10-09","built_at": "2026-10-09T22:04:11Z","units": {"premium": "USD", "size": "contracts", …},"datasets": {"levels": {"file": "levels.parquet","rows": 962459,"bytes": 6860635,"sha256": "…","columns": [{"name": "ts_ms", "type": "int64"}, …],"url": "/v1/export/2026-10-09/levels"},…}},"meta": {"as_of": "2026-10-11T14:06:00Z"}}