可转债基础信息
POST
https://jinniu.lingxideai.com/api/cb_basic查询沪深转债资料。可按代码、上市日期、交易所筛选,三个条件都可不填。
需单独开通“可转债历史”权限,三个可转债接口共用期限。数据覆盖以各标的的实际可用记录为准。
| 参数 | 必填 | 说明 |
|---|---|---|
| X-Api-Key | 是 | 通过请求头提供 API Key,也可通过 JSON 参数 api_key 传入。 |
| ts_code | 否 | 单个带 .SH 或 .SZ 后缀的转债代码。 |
| list_date | 否 | 上市日期,YYYYMMDD 或 YYYY-MM-DD。 |
| exchange | 否 | SH 或 SZ,也接受 SSE 或 SZSE。 |
| limit | 否 | 正整数,最大 2000。 |
| fields | 否 | 逗号分隔;不填返回默认字段。支持 ts_code, bond_full_name, bond_short_name, cb_type, cb_code, stk_code, stk_short_name, maturity, par, issue_price, issue_size, remain_size, value_date, maturity_date, rate_type, coupon_rate, add_rate, pay_per_year, list_date, delist_date, exchange, conv_start_date, conv_end_date, conv_stop_date, first_conv_price, conv_price, rate_clause。 |
调用示例
curl -X POST 'https://jinniu.lingxideai.com/api/cb_basic' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d '{"fields": "ts_code,bond_short_name,stk_code,list_date", "limit": 2, "ts_code": "110092.SH"}'
返回结构示例
{"data": {"fields": ["ts_code", "bond_short_name", "stk_code", "list_date"], "items": []}, "message": "", "success": true}
returned_count 为返回行数,possibly_more 表示结果达到请求上限,不保证还有记录。 空列表仅表示本次查询没有匹配记录;权限错误或服务失败会返回对应错误状态。
SDK:client.cb_basic(...);MCP 工具:cb_basic。限额及错误处理见调用规则。