天勤量化 Skill

该 Skill 提供对天勤量化接口的访问，支持获取实时行情、实时K线序列和历史K线数据。

前置条件

• 在天勤官网注册账号并获取用户名/密码。
• 历史K线查询需要专业版账号权限。
• 重要：账号信息必须通过环境变量配置（见下文）

安装

在 Clawdbot 中安装此 Skill 后，会自动安装依赖。

环境变量配置

本技能通过环境变量读取天勤账号，请在使用前设置：

• TQ_USERNAME：天勤用户名（注册于官网）
• TQ_PASSWORD：天勤密码

注意：账号信息不再通过调用参数传递，必须通过环境变量配置。

参数说明

| 参数名 | 类型 | 必填 | 说明 | |-------------------|---------|------|----------------------------------------------------------------------| | action | string | 是 | 操作类型：get_quote, get_kline_serial, get_kline_data | | symbol | string | 是 | 合约代码，多合约用逗号分隔，如 SHFE.rb2410,DCE.m2409 | | duration_seconds | integer | 否 | K线周期（秒），默认 60。仅用于 K线相关操作 | | data_length | integer | 否 | K线序列长度，默认 200。仅用于 get_kline_serial | | start_dt | string | 否 | 起始时间（ISO 8601），如 2024-01-01T09:00:00。仅用于 get_kline_data | | end_dt | string | 否 | 结束时间（ISO 8601）。仅用于 get_kline_data |

示例

获取螺纹钢实时行情

{
  "action": "get_quote",
  "symbol": "SHFE.rb2410"
}
返回结果：

json
{
  "result": [
    {
      "symbol": "SHFE.rb2410",
      "last_price": 3825.0,
      "ask_price1": 3826.0,
      "bid_price1": 3824.0,
      "volume": 123456,
      "open_interest": 789012,
      "datetime": "2025-04-15 14:30:00"
    }
  ]
}
获取5分钟K线序列（最近200根）
json
{
  "action": "get_kline_serial",
  "symbol": "SHFE.rb2410",
  "duration_seconds": 300,
  "data_length": 200
}
返回结果包含最新一根K线的完整信息。

获取历史1小时K线
json
{
  "action": "get_kline_data",
  "symbol": "SHFE.rb2410",
  "duration_seconds": 3600,
  "start_dt": "2024-01-01T09:00:00",
  "end_dt": "2024-01-31T15:00:00"
}
返回结果包含指定时间段内的所有K线数据（最多约5000条）。

注意事项
历史K线接口需要天勤专业版账号。

实时接口会等待第一次行情更新，可能会稍有延迟。

密码等敏感信息应通过环境变量配置，避免在代码或配置文件中明文存储。

确保在运行环境中正确设置 TQ_USERNAME 和 TQ_PASSWORD 环境变量。