US stocks data API

美股行情 API，从K线到逐笔

覆盖美股股票与 ETF：历史K线、快照、参考数据与公司行为；高级版提供实时行情、WebSocket 推送、逐笔成交/报价与财务数据。兼容 Polygon SDK。

查看套餐接口文档 →
入门版 ¥39 起高级版实时行情免费体验 2 小时
stocks.py
from polygon import RESTClient

client = RESTClient(api_key="mh_live_••••",
                    base="https://marilux.dev")

for bar in client.list_aggs("NVDA", 5, "minute",
                           "2025-06-02", "2025-06-02"):
    print(bar.timestamp, bar.close, bar.volume)
● OperationalCache · HIT   4ms
Coverage

入门版与高级版

两档共用同一套接口路径；调用套餐外的接口会收到 404，查询超出历史范围会收到 403。

S

入门版 Starter

行情延迟约 15 分钟，历史K线回溯 5 年。包含K线（分钟/小时/日）、全市场日线、单日开高低收、快照与涨跌榜、股票/ETF 参考数据、拆股分红、IPO 日历、市场状态与休市日。

A

高级版 Advanced

实时行情，历史K线回溯 20 年以上。在入门版基础上增加逐笔成交、逐笔报价（NBBO）、利润表/资产负债表/现金流量表与财务比率、卖空持仓与卖空成交量、流通股数据，以及 WebSocket 实时推送。

F

Flat Files

按交易日打包的全市场日K、分钟K（gzip CSV），入门版可下最近 5 年，高级版 20 年以上，按每日文件数计额度。

Use cases

常见用法

完整参数与返回示例见 API 文档。

量化回测

用 /v2/aggs/grouped/locale/us/market/stocks/{date} 或 Flat Files 一次拿全市场日线，配合拆股、分红数据做复权。

行情看板与提醒

快照与涨跌榜接口轮询刷新；高级版用 WebSocket 订阅 T.AAPL / Q.AAPL 接收逐笔推送。

基本面研究

高级版提供利润表、资产负债表、现金流量表、财务比率、卖空与流通股数据，按 ticker 和财年筛选。