ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Composio Marketstack 工具包 API 覆盖度解析:EOD、实时报价与日内数据的能力边界与请求渠道

2026/9/10 23:49:12 拓冰建站 浏览量
Composio Marketstack 工具包 API 覆盖度解析:EOD、实时报价与日内数据的能力边界与请求渠道 Composio Marketstack 工具包 API 覆盖度解析EOD、实时报价与日内数据的能力边界与请求渠道【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio导读本文围绕 Composio 中 Marketstack 工具包的API Coverage接口覆盖度展开基于官方 APILayer v2 OpenAPI 规范与当前仓库中的工具清单数据逐项梳理已暴露的 19 个 Marketstack actions、v2 规范中尚未覆盖的日内数据端点、支持的采样间隔以及哪些能力如涨跌幅榜、板块表现不应向用户承诺。读完本文你将能准确判断哪些行情数据可以直接通过 Composio 调用哪些需要走请求渠道申请以及如何避免把“工具包未覆盖”误判为“提供商不支持”。Marketstack 工具包在 Composio 中的定位Marketstack 是股票行情数据 API 提供商其官方描述为提供覆盖全球 72 证券交易所、125,000 标的的实时、日内与历史行情数据。在 Composio 工具目录中它被归类为developer tools采用API_KEY认证方式认证字段名为marketstack_api_key见 docs/public/data/toolkits.json 中的authConfigDetails。连接账户时只需提供generic_key一个必填字段其展示名为API Access Key官方字段描述明确了使用前提登录 Marketstack 控制台复制 API Key免费套餐仅支持 HTTP付费套餐才支持 HTTPS。这意味着在通过 Composio 为 Marketstack 创建 connected account 时免费用户的请求将走 HTTP这一点在面向生产环境的 Agent 中需要特别留意。当前已暴露的 19 个工具 actions根据 docs/public/data/toolkits.json版本20260702_00Marketstack 工具包当前包含 19 个 actions、0 个 triggers。它们可以按数据维度划分为以下几类类别Actions收盘EOD数据MARKETSTACK_GET_EOD、MARKETSTACK_GET_TICKER_EOD、MARKETSTACK_GET_TICKER_EOD_LATEST实时报价MARKETSTACK_GET_STOCK_PRICE日内Intraday数据MARKETSTACK_GET_INTRADAY、MARKETSTACK_GET_INTRADAY_LATEST、MARKETSTACK_GET_INTRADAY_DATE、MARKETSTACK_GET_TICKER_INTRADAY、MARKETSTACK_GET_TICKER_INTRADAY_LATEST、MARKETSTACK_GET_EXCHANGE_INTRADAY、MARKETSTACK_GET_EXCHANGE_INTRADAY_LATEST、MARKETSTACK_GET_EXCHANGE_INTRADAY_DATE标的与交易所信息MARKETSTACK_GET_TICKER_INFO、MARKETSTACK_GET_EXCHANGE、MARKETSTACK_LIST_TICKERS、MARKETSTACK_LIST_EXCHANGES事件类数据MARKETSTACK_GET_SPLITS拆股、MARKETSTACK_GET_DIVIDENDS分红基础参考数据MARKETSTACK_LIST_CURRENCIES货币列表这与知识库文章 docs/kb/articles/toolkits-marketstack.md 中当前 Composio 工具包覆盖范围包括 EOD、ticker EOD、ticker EOD latest、ticker info/listing、exchange info/listing、splits、dividends 和 currencies的描述相互印证同时补充了具体的 action 命名与数量。官方 v2 OpenAPI 规范中的接口覆盖缺口知识库文章基于Marketstack 官方 APILayer v2 OpenAPI 规范核对日期为 2026-06-21指出规范中存在一类实时与日内行情端点当时尚未被 Composio Marketstack 工具包的 actions 暴露端点说明/stockprice实时最新股价报价/intraday多标的日内数据/intraday/latest多标的最新日内数据点/intraday/{date}多标的指定日期日内数据/tickers/{symbol}/intraday单标的日内序列/tickers/{symbol}/intraday/latest单标的最新日内 bar/exchanges/{mic}/intraday按交易所 MIC 的日内数据/exchanges/{mic}/intraday/latest按 MIC 的最新日内数据/exchanges/{mic}/intraday/{date}按 MIC 的指定日期日内数据支持的日内采样间隔规范中支持的 intraday 间隔interval为1min1 分钟5min5 分钟10min10 分钟15min15 分钟30min30 分钟1hour1 小时这六个间隔在 Composio 的日内工具描述中也保持一致例如MARKETSTACK_GET_INTRADAY的描述明确写有1min/5min/10min/15min/30min/1hour可用于构建日内如 1DK 线。TOPS 数据源与 IEX 授权细节知识库文章同时记录了 v2 规范中关于数据源的两点细节TOPS feed 部分字段可为 null在没有IEX 授权entitlement的情况下TOPS 数据流中的某些字段通常是实时报价类字段可能返回 null衍生日内数据无需额外协议derived intraday 数据不需要额外签署IEX market data agreement即可获取。这两点对 Agent 调用结果的可靠性判断有实际意义即使拿到日内数据也应对 bid/ask 等实时字段做空值容错处理。能力边界不要承诺规范中不存在的端点知识库文章给出了明确的反向约束——不要基于当前 v2 文档向用户承诺以下能力gainers涨幅榜losers跌幅榜most-active最活跃movers异动股sector-performance板块表现这些端点不在官方 OpenAPI 规范中截至 2026-06-21因此既不能被 Marketstack 工具包调用也不能被当作提供商支持但工具包未封装的能力来处理。Agent 在回答用户帮我查涨幅榜之类的需求时应当如实说明该数据在当前 v2 规范中不可用而不是含糊承诺。状态演进从未暴露到已纳入工具目录值得注意的是知识库文章记录的是 2026-06-24来源文件 docs/kb/source/toolkits/marketstack/public.md 的时间戳前后、基于 2026-06-21 OpenAPI 规范核对的状态而仓库中的工具目录数据 docs/public/data/toolkits.json 对应的工具包版本为20260702_002026-07-02。从该版本数据看上一节列出的/stockprice、/intraday系列、/tickers/{symbol}/intraday系列以及/exchanges/{mic}/intraday系列端点均已对应到具体的MARKETSTACK_GET_*actions见上文表格。也就是说知识库文章描述的是历史核对时刻的覆盖缺口而 20260702_00 版本的工具目录已经补齐了这些日内与实时报价能力。阅读本文时应以具体工具包版本的目录数据为准这正体现了以版本为锚点判断能力的重要性——Composio 工具包会随官方 OpenAPI 规范的演进持续同步覆盖度是一个动态状态而非一成不变的事实。请求渠道未覆盖能力应走 Composio 请求入口对于仍未被暴露的能力文章写作时点的 live quotes 与 1D 图表或未来规范新增的端点知识库文章给出了明确的处理原则不要把Composio 工具包未覆盖误报为Marketstack 提供商限制而应将该能力需求通过Composio 请求入口request portal提交。这与通用的问题分类逻辑一致工具包覆盖度属于平台侧的封装范围提供商是否支持取决于其 API 规范本身。在撰写支持文档、Agent 提示词或 FAQ 时使用该端点当前未作为 Composio Marketstack 工具包 action 暴露可在请求入口申请这类表述比提供商不支持更准确也避免误导用户放弃该能力。相关仓库文件速查docs/kb/articles/toolkits-marketstack.md —— 本主题的知识库文章正文主体docs/kb/source/toolkits/marketstack/public.md —— 知识库来源文件含 frontmatter 元数据与时间戳docs/content/kb/guide/toolkits-marketstack.mdx —— 面向文档站渲染的版本含lastVerifiedAt、reviewAfter等 freshness 元数据docs/public/data/toolkits.json —— 工具目录数据Marketstack 的 19 个 actions、认证配置与版本号docs/public/data/toolkits-list.json —— 工具包列表索引docs/kb/manifest.json —— 知识库文章清单含文章与来源的映射关系小结Marketstack 工具包在 Composio 中的覆盖度可以概括为三层结论已覆盖EOD、ticker EOD 及其 latest、ticker/exchange 信息与列表、splits、dividends、currencies以及新版本目录中已加入的实时报价与日内系列需按版本核对日内与实时报价端点是否可用取决于工具包版本如20260702_00已包含不能以旧版本或旧知识库核对结果一概而论不可承诺gainers、losers、most-active、movers、sector-performance 不在 v2 规范中任何情况下都不应承诺支持。对于仍未覆盖的能力正确的做法是引导用户通过 Composio 请求入口提交而不是将其归咎于 Marketstack 提供商——这既是事实准确性的要求也是保持 Agent 回答可靠性的关键。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考