Twelve Data 金融数据连接器

金融数据接入的常见痛点

在量化回测、行情监控或组合分析的工程实践中，获取可靠的金融数据往往是第一道门槛。自建爬虫需要处理反爬策略与数据质量，直接对接 API 又要管理凭据、处理限流、维护端点变更。当项目中引入多个数据源时，凭据分散在各处、调用方式不统一、错误处理各异，长期维护成本随之上升。

这个技能如何工作

@user_15292d5a/yjkj-oo-twelve-data 通过 OOMOL 平台将 Twelve Data 的金融数据能力封装为标准操作。其核心思路是：

• 凭据托管：OOMOL 在服务端注入 Twelve Data 的 API 凭据，客户端全程不接触原始 token，降低密钥泄露风险。
• 统一调用入口：技能调用 twelve_data connector，配合 oo CLI 执行。所有 action 的调用模式一致——先用 oo connector schema 获取权威的输入/输出契约，再按契约构造 --data JSON 负载执行。
• 标准化响应：每次执行返回 { "data": ..., "meta": { "executionId": "..." } }，executionId 可用于后续追踪。

技能暴露 12 个 action，覆盖以下场景：

• 行情与报价：price（最新价格）、quote（实时报价快照）、eod（日内收盘价）、time_series（历史 OHLCV 序列）
• 元数据：profile（公司档案）、exchanges（交易所列表）、stocks（股票目录）、symbol_search（标的搜索）
• 市场状态：market_state（交易所开市状态）、market_movers（涨跌榜）、earliest_timestamp（最早历史时间戳）、forex_pairs（外汇对列表）

执行流程遵循"先查契约、再构造负载"的两步模式：阅读 action 对应的参考文件了解用途，再拉取实时 schema 构造 --data，避免凭猜测传参导致的字段错配。

适用边界与注意点

• 安全分级：get / list / search 类只读操作可直接执行；create / update / send / post 类写操作会改变 Twelve Data 侧状态，必须在执行前与用户确认负载内容与预期效果；delete / remove 类破坏性操作需要明确目标与显式批准。
• 一次性设置：oo CLI 安装、OOMOL 登录、Twelve Data 连接均为一次性步骤，仅在命令因认证或连接错误失败时才需回退处理，不要在每次调用时重复执行。
• 额度限制：遇到 HTTP 402 / OOMOL_INSUFFICIENT_CREDIT 错误时，说明计费已停用，需要充值后才能继续调用，与技能本身功能无关。
• 数据覆盖范围：技能的字段结构由 Twelve Data 官方 API 决定，如遇 API 端点调整或字段变更，以实时 schema 为准。