Skip to main content
已暴露为 MCP 工具equity_historical_prices —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   免费 · daily bars

它为 Agent 做什么

equity_historical_prices 返回单个美股标的(NYSE / NASDAQ)的历史 OHLCV 日线,附 adjusted_closedividendstock_split。它是 agent 拿历史价格做收益率、回撤、回测的 历史价格 primitive —— 不是用来取最新报价的工具。 start_date 和/或 end_date 先过滤候选窗口,再用 limittake_from 决定保留哪一端。返回顺序始终是旧到新。只返回已收盘的交易日,当日未收盘的 bar 永远不在结果里。

返回值

EquityHistoricalResult
required
number
固定 0 —— 本接口免费。
number
账户剩余 credit。
string
仅在候选窗口内的数据多于实际返回条数时出现 —— 也就是结果被 limit 截断了。这句话提示 agent 缩小窗口或把查询拆成多次:More data exists in the requested window than the items returned; narrow the window or split the query to see more.
200 OK · equity_historical_prices

说明

算收益率统一用 adjusted_close —— 它已经处理了分红和拆股。原始 close 只在画 K 线图等纯展示场景才适合。
首次查询某个 ticker + range 可能较慢。同一窗口的后续查询通常更快。
需要返回的 bar 数时直接读 data.prices.lengthmeta 只保留 credit 和可选 notice。
仅美股(NYSE / NASDAQ)。不含非美股 ADR,不含国际市场。
仅日线。分钟级(1m5m15m)不支持。需要 1h 常规交易时段 bar,请用 equity_intraday_prices
没有实时报价。当日未收盘的 bar 不在结果里。要拿”最新价”用别的工具。
覆盖范围很广,但不保证所有标的都有数据。少数流动性差的 ticker 偶尔会返回空。

直接调用

完整参数参考

string
required
美股 ticker(如 AAPLMSFTBRK.B^GSPC(S&P 500 指数))。
string
可选 inclusive 下边界,YYYY-MM-DD(如 2025-04-01)。
string
可选 inclusive 上边界,YYYY-MM-DD
integer
default:30
边界过滤后最多返回多少个交易日。默认 30,最大 200
string
default:"latest"
当过滤后候选超过 limit 时保留哪一端:latestearliest。输出仍按时间正序。
take_from=earliest 需要 start_date。如果同时传两个日期边界,start_date 不能晚于 end_date

相关接口

美股盘中行情

同一批美股的 1h 常规交易时段 bar —— 短窗口搭档。

加密货币历史 K 线

同样的有界 historical-series 形状,作用在加密货币交易对(含小时级)。

MCP Server 接入

60 秒接入 Claude / Cursor / 任意 agent harness。