MESSAGES API
应用控制的 tool use
适合 Web 应用或分析师 Copilot。后端发送工具定义，执行 Claude 选中的函数，再返回对应结果。
Anthropic tool use金融与市场数据
如何为 Claude 接入实时股票市场数据
围绕时间戳、市场覆盖、数据时效和故障处理，为 Claude 构建可靠的实时股票数据工作流。
发布日期：2026年4月18日 · QVeris团队制作
核心模式：
Claude 发起报价请求；应用代码校验标的、查询已授权 Feed、统一响应并返回依据。Claude 解释依据，但不生成价格。
五段式实验
先跑通一条可信报价，再考虑扩展
Decision 01
先确定 Claude 的使用场景
MCP
Claude 发现 Server
适合 Claude Code 或 Desktop。Server 暴露只读工具，并把数据源凭证留在对话之外。
Anthropic MCP
浏览网页不是行情 Feed。
网页可能缓存、延迟，或仅获准展示。
Contract 02
把“实时”变成字段，而不是宣传语
instrument
代码、交易所、资产类型
price
数值与币种
as_of
数据源时间戳
feed
Provider 与授权 Feed
freshness
实时、延迟、收盘
session
盘前、常规、盘后、休市
{ "instrument": { "symbol": "AAPL", "exchange": "NASDAQ" }, "price": 0, "currency": "USD", "as_of": "provider timestamp", "provider": "configured source", "feed": "entitled feed", "freshness": "real_time | delayed", "session": "regular | closed" }
零值只是 Schema 占位符，不代表报价。
Execution 03
明确控制 Claude 的工具调用循环
描述一个只读操作
定义 get_stock_quote，要求代码、可选交易所，并说明不能交易。
在模型之外校验
处理代码歧义、限制批量大小，不让 Claude 拼接含密钥的 URL。
执行并归一化
调用快照或读取最新有效流事件，再转换为统一契约。
返回依据与错误
保留歧义、停牌、缓存过期、授权、限流和超时状态。
约束回答
要求价格、币种、交易所、时段、来源和时间；过期时说明不可用。
通过 QVeris MCP 指南连接，在工具目录检查能力，并到 Playground 测试。
Acceptance 05
验证新鲜度与诚实失败
| 测试 | 条件 | 预期行为 |
|---|---|---|
| 新鲜报价 | 标的明确、授权有效 | 展示数值、币种、交易所、来源、时段和时间 |
| 歧义 | 多个标的 | 追问，不猜测 |
| 休市 | 更早时段 | 标注最后成交或收盘 |
| 过期 | 超过阈值 | 返回过期或不可用 |
| 故障 | 超时、限流、认证 | 不退回模型记忆 |
数据源设计 06
根据问题选择行情模式
“Claude 实时股票市场数据”并不意味着每个工作流都需要持续数据流。应根据 Claude 要支持的决策选择获取方式。
| 意图 | 推荐输入 | 披露内容 |
|---|---|---|
| 当前价格 | 最新 Quote 或 Trade 快照 | 数值类型、Feed、时间、时段 |
| 价差提醒 | WebSocket 与规则引擎 | 触发条件、窗口、事件时间 |
| 日内总结 | 已校验的日内 Bars | 周期、时区、未完成状态 |
| 历史对比 | 带复权策略的历史 Bars | 范围、复权、缺失交易日 |
TRADE
最后成交
已完成成交不一定等于新订单当前可成交价格。
QUOTE
买价与卖价
Claude 应明确引用哪一侧，而不是统称为“股价”。
BAR
聚合周期
将未完成 OHLCV Bar 与完整周期比较前必须明确标注。
工具定义 07
用 Schema 阻止 Claude 猜测参数
明确何时必须调用、不能做什么，以及必须解决哪些歧义。参数校验和 Provider 访问由应用代码负责。
symbol必填；不得推断交易所exchange标的有歧义时必填modelatest_quote · latest_trade · snapshotmax_age_ms应用新鲜度阈值extended_hours明确盘前盘后范围{ "name": "get_stock_quote", "description": "Read-only current quote. Never places orders. Ask for exchange when ambiguous.", "input_schema": { "type": "object", "properties": { "symbol": { "type": "string" }, "exchange": { "type": "string" }, "mode": { "enum": ["latest_quote", "latest_trade", "snapshot"] } }, "required": ["symbol", "mode"] } }明确结果状态：
ok, ambiguous_instrument, stale, market_halt, not_entitled, rate_limited, provider_unavailable.生产控制 08
控制延迟、成本、权限与许可
只读边界
行情与交易凭证分离。交易需要独立工具、凭证、批准流程和审计。
新鲜度预算
按工作流定义可接受报价年龄，并拒绝超出阈值的数据。
带来源缓存
保存 Provider 时间、接收时间、Feed、授权和可见缓存年龄。
再分发权
核对终端展示、衍生输出、存储和多用户访问条款。
可观测性
记录脱敏参数、Feed、事件时间、缓存年龄、延迟和结果，并隐藏密钥。
抵御提示注入
新闻是数据而非指令。只接受类型明确的参数，不接受检索到的 URL 或请求头。
故障排查 09
先诊断数据链路，再修改提示词
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 未调用工具 | 描述未覆盖实时意图 | 要求当前、最新、买卖价和时段问题调用工具 |
| 价格不同 | Feed、字段、时段或时间不同 | 统一标的、Feed、数值类型和时间戳 |
| 代码无数据 | OTC 授权、失效、停牌、代码变更 | 查询元数据，不替换为相似代码 |
| HTTP 403 | 凭证、Host 或授权 | 检查认证并标注 Feed 降级 |
| 最新事件过旧 | 休市、停牌、连接失效、延迟 Feed | 检查日历、连接、Feed 类型和 Provider 时间 |
上线手册 10
用四轮验证完成上线准备
契约测试
测试有效、歧义、失效和不支持的代码；断言依据字段与时区解析。
时段测试
在盘前、常规时段、收盘后、休市日和盘前盘后测试。
故障注入
模拟超时、403、429、流中断、缓存过期、响应畸形和事件乱序。
回答审阅
验证多种表达都返回标的、数值类型、币种、交易所、时段、Provider/Feed 和时间。
生产门槛： 区分不可用与数值零，也区分延迟或局部覆盖与聚合实时数据。
参考 11
Claude 应准确使用的术语
As-of time
市场观测时间，不是回答生成时间。
Feed
传输来源和覆盖类型。
Freshness
实际年龄与声明延迟类型。
Session
盘前、常规、盘后或休市。
Quote
买价与卖价，不同于已完成成交。
Snapshot
明确获取时间下的最新字段有限视图。
FAQ
Claude 实时股票数据常见问题
Claude 自带实时价格吗？
不要把 Claude 当作获得许可的 Feed。应连接外部源并返回时间戳、Feed 和时段。
MCP 还是 Messages API？
在自有应用中用 Messages API；需要客户端发现能力时用 MCP。
发送每条 Tick？
不需要。在模型外聚合并发送有限快照。
档案链接有效不代表已获访问权限、字段可用、价格确定或当前调用成功；执行前须检查当前契约。