Developer docs

Flat Files 批量下载

按交易日打包的全市场日K、分钟K,适合量化回测一次性灌库。

整天的历史日K/分钟K,打包成 gzip 压缩的 CSV 文件,一次拿一整天的全市场数据,比逐个 ticker 调 REST 接口高效得多。跟 REST 接口用同一把 API Key,按套餐单独有"每日下载文件数"额度,不占用 REST 的调用额度。

GET/v1/flatfiles/us_stocks_sip/day_aggs_v1/{yyyy}/{mm}/{yyyy-mm-dd}.csv.gz

指定交易日全市场日K。

curl "https://marilux.dev/v1/flatfiles/us_stocks_sip/day_aggs_v1/2024/01/2024-01-02.csv.gz" \
  -H "Authorization: Bearer mh_live_your_key" -o 2024-01-02.csv.gz
GET/v1/flatfiles/us_stocks_sip/minute_aggs_v1/{yyyy}/{mm}/{yyyy-mm-dd}.csv.gz

指定交易日全市场分钟K,单个文件通常在 20MB 左右。

文件格式:解压后是带表头的 CSV,日K和分钟K列相同:

ticker,volume,open,close,high,low,window_start,transactions
AAPL,77874426,187.15,185.64,188.44,183.885,1704171600000000000,1008813

window_start 是该K线起始时间的纳秒时间戳(注意不是 REST 接口的毫秒),日K为美东时间 0 点。

历史范围:Starter 套餐可下载最近 5 年,Advanced 套餐可下载 20 年以上;超出范围返回 403。

每日下载额度(文件数):

  • Starter:月付/季付 20 个,半年付 50 个,年付 100 个
  • Advanced:月付/季付 40 个,半年付 100 个,年付 200 个
  • 体验套餐不含 Flat Files,请求返回 403

每成功下载一个文件计 1 次,同一个文件重复下载也会重复计数。响应头 X-Flatfiles-Used / X-Flatfiles-Limit 是当日已下载/总额度文件数,按 UTC 0 点重置;同一天的文件对所有客户都是一份缓存,重复下载不会更慢。目前只开放美股日K与分钟K,逐笔报价/成交、期权及其他资产类别暂不提供;数据发布有约 1 天延迟(当天数据在次日可下载)。