convertible-bond-candlesticks

Solid

单只可转债历史 K 线 GET 接口（market.ft.tech，convertible-bond-candlesticks）。用户问某只可转债的分/日/周/月/年 K 线、开高低收、前/后复权、分钟级 K 线时使用。必填 --symbol、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。

Data & Documents 63 stars 13 forks Updated today MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%

Recency 20%

100

Frontmatter 20%

Documentation 15%

100

Issue Health 10%

License 10%

100

Description 5%

100

Skill Content

# 可转债 K 线 - 查询单只可转债 K 线（convertible-bond-candlesticks） ## 1. 接口描述 | 项目 | 说明 | |------|------| | 接口名称 | 查询单只可转债历史 K 线 | | 外部接口 | `GET /api/v1/market/data/convertible-bond-candlesticks` | | 请求方式 | GET（query 参数） | | 适用场景 | 获取指定可转债的分/日/周/月/年 K 线，含开高低收、成交量、成交额；支持前复权 / 后复权 / 不复权。仅接受可转债标的 | ## 2. 请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | symbol | string | 是 | 可转债代码（带市场后缀） | 113027.SH、123001.SZ | 也接受 `.XSHG`/`.SH`、`.XSHE`/`.SZ` 短后缀；非可转债标的当前返回系统错误 | | interval_unit | string | 是 | 周期单位 | Day | Minute/Day/Week/Month/Year | | interval_value | int | 否 | 间隔数值 | 1 | 默认 1；Minute+5 表示 5 分钟 K 线 | | adjust_kind | string | 否 | 复权类型 | Forward | None（默认）/Forward（前复权）/Backward（后复权） | | since_ts_millis | int | 否 | 开始时间戳（毫秒） | 1756700000000 | 分钟 K 线与 until 跨度 ≤3 天，其余周期不受 3 天限制 | | until_ts_millis | int | 是 | 结束时间戳（毫秒） | 1756791000000 | - | | limit | int | 否 | 返回条数上限 | 5 | 未传 since 和 limit 时默认最多返回 50 根 | ## 3. 响应说明返回裸数组，每根 K 线包含： | 字段名 | 类型 | 说明 | 单位 | |--------|------|------|------| | open | string | 开盘价 | 元 | | high | string | 最高价 | 元 | | low | string | 最低价 | 元 | | close | string | 收盘价（或最新价） | 元 | | ts_millis | int | 收盘时间戳 | 毫秒 | | ts_millis_open | int | 开盘时间戳 | 毫秒 | | turnover | string | 成交额 | 元 | | volume | int64 | 成交量 | 张 | ## 4. 调用方式 ```bash python <RUN_PY> convertible-bond-candlesticks --symbol 113027.SH --interval-unit Day --since-ts-millis 1756700000000 --until-ts-millis 1756791000000 --limit 5 python <RUN_PY> convertible-bond-...