akshare-bond

# SKILL.md - akshare-bond

## 技能信息

| 属性 | 内容 |
|:---|:---|
| **名称** | akshare-bond |
| **版本** | 1.1.0 |
| **分类** | 债券数据 |
| **状态** | ✅ 已上线 |
| **维护者** | FinClaw Core Team |
| **最后更新** | 2026-03-19 |

## 功能描述

债券数据Skill，提供国债、企业债、可转债的行情数据、收益率曲线、可转债基本面分析（转股价值、溢价率）等。覆盖交易所债券市场和银行间市场数据。

## 触发意图

### 主要触发词
- "债券"、"国债"、"企业债"
- "可转债"、"转债"
- "收益率"、"到期收益率"
- "转股价值"、"溢价率"
- "债券市场"

### Few-shot 示例

| 用户输入 | 识别意图 | 调用函数 |
|:---|:---|:---|
| 国债收益率多少？ | bond_yield | bond_yield.py |
| 查询可转债 | bond_convertible | bond_convertible.py |
| 债券市场行情 | bond_quote | bond_quote.py |
| 可转债转股价值 | bond_conversion | bond_convertible.py --detail |

## 数据源配置

| 数据类型 | 主要来源 | 备用来源 | 认证要求 |
|:---|:---|:---|:---:|
| 债券行情 | AkShare-交易所 | - | 无需 |
| 可转债数据 | AkShare-东方财富 | - | 无需 |
| 收益率曲线 | AkShare-央行 | - | 无需 |

## 功能列表

### 1. 债券行情
- **功能描述**: 获取国债、企业债等债券的行情数据
- **输入参数**: 债券类型（可选）
- **输出格式**: Markdown表格
- **数据源**: AkShare-交易所
- **数据时效**: 实时
- **使用示例**:
  ```bash
  python scripts/bond_quote.py
  python scripts/bond_quote.py --type treasury  # 国债
  ```

### 2. 可转债数据
- **功能描述**: 获取可转债的行情、转股价值、溢价率等
- **输入参数**: 可转债代码（可选）
- **输出格式**: Markdown表格
- **数据源**: AkShare-东方财富
- **数据时效**: 实时
- **使用示例**:
  ```bash
  python scripts/bond_convertible.py
  python scripts/bond_convertible.py 110059  # 特定可转债
  ```

### 3. 收益率曲线
- **功能描述**: 获取国债收益率曲线数据
- **输入参数**: 期限（可选）
- **输出格式**: Markdown表格 + 曲线描述
- **数据源**: AkShare-央行
- **数据时效**: 日频
- **使用示例**:
  ```bash
  python scripts/bond_yield.py
  python scripts/bond_yield.py --term 10y  # 10年期
  ```

## 脚本清单

| 脚本名 | 功能 | 入口点 |
|:---|:---|:---:|
| bond_quote.py | 债券行情 | ✅ |
| bond_convertible.py | 可转债数据 | ✅ |
| bond_yield.py | 收益率曲线 | ✅ |

## 债券类型说明

| 类型 | 代码前缀 | 特征 |
|:---|:---|:---|
| **国债** | 019xxx | 国家信用，无违约风险 |
| **地方政府债** | 130xxx/109xxx | 地方政府发行 |
| **企业债** | 120xxx/127xxx | 企业发行，信用风险 |
| **公司债** | 122xxx/112xxx | 上市公司发行 |
| **可转债** | 110xxx/113xxx/128xxx | 可转换股票 |

## 可转债核心指标

| 指标 | 说明 | 投资意义 |
|:---|:---|:---|
| **转股价值** | (100/转股价) × 正股价 | 转换成股票的价值 |
| **转股溢价率** | (转债价-转股价值)/转股价值 | 溢价越低，股性越强 |
| **纯债价值** | 按到期收益率折现的价值 | 债底保护 |
| **到期收益率(YTM)** | 持有到期的年化收益 | 保底收益 |
| **双低值** | 转债价 + 溢价率×100 | 综合评估指标 |

### 可转债投资策略

| 策略 | 条件 | 特点 |
|:---|:---|:---|
| **双低策略** | 低价格 + 低溢价 | 攻守兼备 |
| **低溢价策略** | 溢价率 < 10% | 股性强，跟随正股 |
| **高收益策略** | YTM > 3% | 债性强，保底高 |
| **打新策略** | 申购新债 | 低风险套利 |

## 收益率曲线解读

| 曲线形态 | 含义 | 经济信号 |
|:---|:---|:---|
| **向上倾斜** | 长期利率 > 短期利率 | 正常经济，增长预期 |
| **平坦** | 长短利率接近 | 经济放缓信号 |
| **倒挂** | 短期利率 > 长期利率 | 衰退预警 |

## 数据来源标注规范

本Skill所有输出数据将按以下格式标注来源：

```markdown
---
📊 **数据来源**: AkShare-东方财富/交易所
⏱️ **数据时间**: 2026-03-19 10:30:15
📌 **债券类型**: 可转债
🔗 **原始来源**: 上海证券交易所
🔧 **分析工具**: FinClaw v1.0
```

## 依赖要求

```
akshare>=1.10.0
pandas>=1.3.0
pyyaml>=5.4.0
```

## 交易时间

| 市场 | 时间 |
|:---|:---|
| 交易所债券 | 09:30-11:30, 13:00-15:00 |
| 银行间市场 | 09:00-12:00, 13:30-16:30 |

## 更新日志

| 版本 | 日期 | 变更内容 |
|:---|:---:|:---|
| 1.1.0 | 2026-03-19 | 符合FinClaw数据规范v1.0 |
| 1.0.0 | 2026-03-13 | 初始版本 |

## 相关链接

- AkShare文档: https://www.akshare.xyz
- FinClaw数据规范: `finclaw/config/data_source_config.yaml`

---

*本Skill遵循 FinClaw 数据规范 v1.0 | 数据来源强制标注 | 禁止训练数据编造*