整天的历史日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 天延迟(当天数据在次日可下载)。