期货交割分析器
功能
- 交割月份提醒与倒计时
- 交割规则查询（接入AkShare合约详情）
- 仓单数据实时查询（上期所、郑商所）
- 交割仓库信息
- 逼仓风险评估
- 多合约交割对比
数据源
- AkShare交割数据:
futures_delivery_shfe(date) - 上期所月度交割数据futures_delivery_czce(date) - 郑商所月度交割查询 futures_delivery_dce(date) - 大商所交割统计
- AkShare仓单数据:
futures_shfe_warehouse_receipt() - 上期所仓单日报futures_warehouse_receipt_czce() - 郑商所仓单日报
- 合约详情:
futures_contract_detail() - 交易所交割规则
交割要素
| 要素 |
说明 |
| 交割月份 |
合约到期月份 |
| 最后交易日 |
合约最后交易日 |
| 最后交割日 |
交割截止日期 |
| 交割方式 |
实物交割/现金交割 |
| 仓单 |
标准仓单数量 |
| 升贴水 |
地区、品质差异调整 |
风险等级
| 等级 |
描述 |
建议 |
| normal |
正常 |
正常交易 |
| medium |
中等风险 |
密切关注 |
| high |
高风险 |
考虑移仓 |
| critical |
极高风险 |
立即平仓或移仓 |
| expired |
已过期 |
无法交易 |
使用方法
# 分析单个合约交割信息（包含仓单和交割数据）
python main.py --symbol RB2505
# 不包含仓单数据
python main.py --symbol RB2505 --no-warehouse
# 不包含交割统计数据
python main.py --symbol RB2505 --no-delivery
# 仅获取交割统计数据
python main.py --symbol RB --delivery-only
# 指定月份获取交割数据
python main.py --symbol RB --delivery-only --date 202503
# 对比多个合约交割时间
python main.py --compare RB2505,RB2510,HC2505
参数说明
| 参数 |
说明 |
示例 |
| --symbol |
合约代码/品种代码 |
RB2505, CU2506 |
| --no-warehouse |
不获取仓单数据 |
- |
| --no-delivery |
不获取交割统计数据 |
- |
| --delivery-only |
仅获取交割统计数据 |
- |
| --date |
指定年月(YYYYMM) |
202503 |
| --compare |
对比多个合约 |
RB2505,HC2505 |
输出字段
{
"delivery_info": {
"delivery_year": 2025,
"delivery_month": 5,
"estimated_delivery_date": "2025-05-15",
"days_to_delivery": 30,
"last_trading_day": "合约月份15日",
"last_delivery_day": "最后交易日后连续五个工作日",
"delivery_method": "实物交割",
"delivery_grade": "交割品级标准..."
},
"warehouse_receipt": {
"total_quantity": 15000,
"daily_change": -500,
"warehouse_count": 8,
"data_source": "futures_shfe_warehouse_receipt"
},
"delivery_stats": {
"exchange": "SHFE",
"date": "202503",
"delivery_volume": 5000,
"delivery_amount": 25000000,
"data_source": "futures_delivery_shfe"
},
"risk_analysis": {
"risk_level": "medium",
"risk_level_desc": "中等风险",
"warnings": ["临近交割月，流动性开始下降"],
"suggestions": ["关注基差变化，考虑移仓"]
}
}
更新日志
- 2025-03-25: 接入AkShare交割数据接口(futures_delivery_shfe/czce/dce)和仓单数据接口，提供交割统计和仓单双重数据源
aifinlab