POST/api/v1/requests/estimate

Estimate a request

Files, rows, and bytes for a selection, plus what the caller's plan covers. Downloads shows this before you confirm.

Public. With a key, the response includes access, quota, and fits_allowance. Estimates do not count toward the allowance.

Try it

Body

Field	Notes
`datasets`	Required. Ids from the data dictionary.
`start_date` / `end_date`	Required. `YYYY-MM-DD` UTC.
`series`	Tickers or wildcards. Empty means every series.
`categories`	Category ids. Combined with `series`.
`tickers`	Market tickers. Selects their series files. Scripts and CSV then cut rows to these markets.

200 response

{
  "dates": 1,
  "first_date": "2026-10-12",
  "last_date": "2026-10-12",
  "series": 1,
  "files": 2,
  "rows": 18000,
  "bytes": 2400000,
  "datasets": {
    "bbo_1m": { "files": 1, "rows": 6000, "bytes": 900000, "days": 1 },
    "trades": { "files": 1, "rows": 12000, "bytes": 1500000, "days": 1 }
  },
  "selection": {
    "datasets": ["bbo_1m", "trades"],
    "start_date": "2026-10-12",
    "end_date": "2026-10-12",
    "series": ["KXBTC15M"],
    "categories": [],
    "tickers": []
  },
  "access": {
    "denied": [],
    "history_days": 30,
    "history_start_date": "2026-09-14",
    "history_clamped": false,
    "history_denied": false,
    "anonymous": true
  },
  "quota": null
}