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

Trust tier 3
  • community
Source check pending

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

单只可转债历史日/周/月/年 K 线(convertible_bond_candlesticks,GET /api/v1/market/data/convertible-bond-candlesticks)。用户问某只可转债的日/周/月/年 K 线、开高低收、前/后复权时使用。必填 --symbol、--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

SKILL.md

可转债历史K线 - 查询单只可转债日/周/月/年 K 线(convertible_bond_candlesticks)

1. 接口描述

项目说明
接口名称可转债历史K线(convertible_bond_candlesticks)
外部接口GET /api/v1/market/data/convertible-bond-candlesticks
请求方式GET(query 参数)
适用场景获取单只可转债的历史日、周、月、年 K 线(开高低收、成交量、成交额),支持前复权/后复权/不复权
数据范围以各标的实际历史行情覆盖为准,不保证从发行日起逐日有记录;不含当日盘中实时行情
单次限量无分页;所有周期单次时间跨度不超过 12 个自然月

2. 请求参数

参数名类型是否必填描述取值示例备注
symbolstring是可转债代码(带市场后缀)113042.SH也接受 .XSHG/.SH、.XSHE/.SZ
interval_unitstring是周期单位dayday/week/month/year(大小写不敏感);不支持 minute
adjust_kindstring否复权类型forwardnone(默认,不复权)/forward(前复权)/backward(后复权)
since_ts_millisint是开始时间戳(毫秒)1786291200000不得晚于 until_ts_millis,不能用 until + limit 替代
until_ts_millisint是结束时间戳(毫秒)1786377599999与起始时间相差不超过 12 个自然月
limitint否返回条数上限1省略时返回窗口内全部记录;设置后保留最新若干根

3. 响应说明

外层固定为 code(成功 200)/ message(成功 success)/ data。data 为 K 线数组,无数据时为 [];每根 K 线字段:

字段名类型说明单位
open / high / low / closestring开/高/低/收盘价;进行中的 K 线 close 为最新价元
ts_millisintK 线结束时间戳毫秒
ts_millis_openintK 线开始时间戳毫秒
turnoverstring成交额元
volumeint成交量-

注:价格与成交额在 JSON 中为字符串(避免精度丢失),不是 number;ts_millis 为数字。

4. 调用方式

bash
python <RUN_PY> convertible-bond-candlesticks --symbol 113042.SH --interval-unit day --since-ts-millis 1786291200000 --until-ts-millis 1786377599999 --limit 1
python <RUN_PY> convertible-bond-candlesticks --symbol 113042.SH --interval-unit week --adjust-kind forward --since-ts-millis 1783000000000 --until-ts-millis 1786377599999

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

5. 注意事项

  • symbol、interval_unit、since_ts_millis、until_ts_millis 必填;缺 since 会返回 缺少必填参数:since_ts_millis。
  • 仅接受可转债标的;传入股票等其它类别返回 symbols [...] are not convertible bonds。
  • 分钟 K 线不在本接口:本接口传 interval_unit=minute 会返回 400 并指向 convertible-bond-minute-candlesticks,请改用 convertible-bond-minutes 子 skill。
  • 周、月、年 K 按请求范围内的历史日 K 聚合;窗口未覆盖完整周期时,该周期不是完整周期数据。
  • 结果按时间升序返回;设置 limit 时保留最新若干根。
  • 单次时间跨度上限 12 个自然月,更长区间需分段调用。
  • 复权参数是当前接口的兼容参数,不表示每只可转债都存在复权事件。

Security

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

Quality evaluation

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

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/badge)](https://verified-skill.com/skills/ftshare-lab/ftshare-skill/convertible-bond-candlesticks)

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