ftshare-lab/ftshare-skill/convertible-bond-candlesticks-batch

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

批量查询多只可转债历史日/周/月/年 K 线（convertible_bond_candlesticks_batch，GET /api/v2/market/data/convertible-bond-candlesticks/batch）。用户问多只可转债的日/周/月/年 K 线、批量可转债开高低收、多只转债对比 K 线时使用。必填 --symbols、--interval-unit、--since-ts-millis、--until-ts-millis；可选 --adjust-kind、--limit。分钟 K 线请改用 convertible-bond-minutes。

Install

npx vskill@latest install ftshare-lab/ftshare-skill/convertible-bond-candlesticks-batch

SKILL.md

批量可转债历史K线

1. 接口描述

项目说明
接口名称批量可转债历史K线（convertible_bond_candlesticks_batch）
外部接口GET /api/v2/market/data/convertible-bond-candlesticks/batch
请求方式GET（query 参数，symbols 使用逗号分隔）
适用场景一次批量获取 1～20 只可转债的历史日/周/月/年 K 线（开高低收、成交量、成交额），支持前复权/后复权/不复权
数据范围以各标的实际历史行情覆盖为准；不含当日盘中实时行情
单次限量每次 1～20 个标的；无分页；所有周期单次时间跨度不超过 12 个自然月

2. 请求参数

参数名类型是否必填描述取值示例备注
symbolsstring是可转债代码列表，逗号分隔传给 CLI113042.SH,123107.SZ1～20 只；也接受 .XSHG/.SH、.XSHE/.SZ；接口侧以逗号分隔发送，兼容旧的重复参数和 JSON 字符串数组格式
interval_unitstring是周期单位dayday/week/month/year（大小写不敏感）；不支持 minute
adjust_kindstring否复权类型forwardnone（默认，不复权）/forward（前复权）/backward（后复权）
since_ts_millisint是开始时间戳（毫秒）1786291200000不得晚于 until_ts_millis
until_ts_millisint是结束时间戳（毫秒）1786377599999与起始时间相差不超过 12 个自然月
limitint否每个标的返回条数上限1省略时返回窗口内全部记录

3. 响应说明

外层固定为 code（成功 200）/ message（成功 success）/ data（失败时为 null）。data 为按请求顺序排列的非分页分组数组，每项结构为 {symbol, items, total}：

字段名类型说明
symbolstring可转债代码，使用 .SH/.SZ 短后缀
itemsarray该标的的 K 线数组；无数据时为 []
totalintegeritems 的 K 线条数；无数据时为 0

items 中每根 K 线字段：

字段名类型说明单位
open / high / low / closestring开/高/低/收盘价；进行中的 K 线 close 为最新价；JSON 中为字符串以保留精度元
ts_millisintegerK 线结束时间戳毫秒
ts_millis_openintegerK 线开始时间戳毫秒
turnoverstring成交额；JSON 中为字符串以保留精度元
volumeinteger成交量-
turnover_ratenumber / null换手率；可转债批量历史 K 线当前固定为 null%

4. 调用方式

bash
python <RUN_PY> convertible-bond-candlesticks-batch --symbols 113042.SH,123107.SZ --interval-unit day --since-ts-millis 1786291200000 --until-ts-millis 1786377599999 --limit 1
python <RUN_PY> convertible-bond-candlesticks-batch --symbols 113042.XSHG,123107.XSHE --interval-unit week --adjust-kind forward --since-ts-millis 1783000000000 --until-ts-millis 1786377599999

<RUN_PY> 为主 SKILL.md 同级 run.py 的绝对路径。输出 JSON；HTTP 错误输出到 stderr 并以非零状态退出。

5. 注意事项

  • symbols、interval_unit、since_ts_millis、until_ts_millis 必填；空 symbols 或超过 20 个标的会请求失败。
  • 接口仅支持 GET；symbols 使用逗号分隔发送（symbols=113042.SH,123107.SZ），兼容旧的重复参数和 JSON 字符串数组格式。
  • 所有标的共用同一周期与复权参数，不能逐只指定。
  • 仅接受可转债标的；混入股票等其它类别时整个请求失败，不静默过滤。
  • 分钟 K 线不在本接口，请改用 convertible-bond-minutes 子 skill。
  • 单次时间跨度上限 12 个自然月；更长历史需分段调用。
  • 周、月、年 K 按请求范围内的历史日 K 聚合；窗口未覆盖完整周期时，该周期不是完整周期数据。
  • 无数据不等于请求失败，应同时检查 code 与 data。

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
65
Repository forks
14
7-day trend score
26

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ftshare-lab/ftshare-skill/convertible-bond-candlesticks-batch/badge)](https://verified-skill.com/skills/ftshare-lab/ftshare-skill/convertible-bond-candlesticks-batch)

Something wrong with this skill or its page? Tell us.