Skip to main content
已暴露为 MCP 工具：equity_historical_prices —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   每次 1 credit

​
它为 Agent 做什么

equity_historical_prices 返回单个美股标的（NYSE / NASDAQ）的历史 OHLCV 日线，附 adjusted_close、dividend、stock_split。它是 agent 拿历史价格做收益率、回撤、回测的 历史价格 primitive —— 不是用来取最新报价的工具。 同一个接口支持两种查询模式：传 limit 取最近 N 根已收盘日线，或者传 start_date + end_date 取一个明确窗口。只返回已收盘的交易日，当日未收盘的 bar 永远不在结果里。

​
返回值

​
data
EquityHistoricalResult
required
​
meta.count
number
本次返回的 bar 数。
​
meta.creditsUsed
number
本次调用消耗的 credit（固定 1）。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · equity_historical_prices
{
  "data": {
    "ticker": "AAPL",
    "interval": "1d",
    "prices": [
      {
        "open": 178.50,
        "high": 182.30,
        "low": 177.80,
        "close": 181.20,
        "volume": 52340000,
        "adjusted_close": 181.20,
        "dividend": 0.24,
        "stock_split": 0,
        "time": "2025-03-28"
      },
      {
        "open": 181.00,
        "high": 183.50,
        "low": 180.20,
        "close": 182.90,
        "volume": 48120000,
        "adjusted_close": 182.90,
        "dividend": 0,
        "stock_split": 0,
        "time": "2025-03-31"
      }
    ]
  },
  "meta": { "count": 2, "creditsUsed": 1, "remainingCredits": 99 }
}

​
说明

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

​
直接调用

// Recent 模式 —— 最近 30 个交易日
{
  "method": "tools/call",
  "params": {
    "name": "equity_historical_prices",
    "arguments": { "ticker": "AAPL", "limit": 30 }
  }
}

// Range 模式 —— 明确日期窗口
{
  "method": "tools/call",
  "params": {
    "name": "equity_historical_prices",
    "arguments": {
      "ticker": "MSFT",
      "start_date": "2025-04-01",
      "end_date": "2025-04-30"
    }
  }
}

​
完整参数参考

​
ticker
string
required
美股 ticker（如 AAPL、MSFT、BRK.B、^GSPC（S&P 500 指数））。
只传 limit（或省略走默认值）。返回最近 N 根已收盘日线。
​
limit
integer
default:30
最近多少个交易日。默认 30，最大 200。

​
相关接口

加密货币历史 K 线

同样的 Recent / Range 双模式，作用在加密货币交易对（含小时级）。

MCP Server 接入

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