aifinlab/futures-delivery-analyzer

期货交割分析器

功能

• 交割月份提醒与倒计时
• 交割规则查询（接入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)和仓单数据接口，提供交割统计和仓单双重数据源