AlphaFuturesPro/docs/开发文档/最后交易日获取接口.md

# 最后交易日获取接口

## 1. 功能概述

本接口用于获取期货合约的最后一个交易日，支持通过TQSDK实时获取或使用模拟数据作为fallback。

## 2. 实现方案

### 2.1 核心代码位置

- **TQSDK适配器**：`backend/service_implementation/qihuo_analyzer/data/api_adapters/tqsdk_adapter.py`
  - 实现了`get_last_trading_day(symbol)`方法，使用TQSDK获取最后一个交易日

- **数据获取器**：`backend/service_implementation/qihuo_analyzer/data/data_fetcher.py`
  - 实现了`get_last_trading_day(symbol)`方法，作为适配器方法的包装

- **API服务**：`backend/service_implementation/service/app.py`
  - 添加了`/api/last-trading-day`接口，提供HTTP访问方式

### 2.2 技术实现

#### TQSDK适配器实现

```python
def get_last_trading_day(self, symbol: str) -> Optional[str]:
    """获取最后一个交易日
    
    Args:
        symbol: 合约代码，如 'CU2603'
        
    Returns:
        str: 最后一个交易日，格式为 'YYYY-MM-DD'
    """
    try:
        if TQSDK_AVAILABLE and self.api:
            # 转换合约代码为TQSDK格式
            tq_symbol = self._convert_symbol(symbol)
            
            # 获取日线数据
            klines = self.api.get_kline_serial(tq_symbol, 86400, data_length=30)  # 86400秒 = 1天
            
            # 等待数据准备就绪
            # 处理数据...
            
            # 转换为DataFrame并提取最后交易日
            if not df.empty:
                last_trading_day = df['datetime'].iloc[-1].strftime('%Y-%m-%d')
                return last_trading_day
        else:
            # 返回模拟数据
            import datetime
            last_trading_day = (datetime.datetime.now() - datetime.timedelta(days=1)).strftime('%Y-%m-%d')
            return last_trading_day
    except Exception as e:
        # 异常处理，返回模拟数据
        import datetime
        last_trading_day = (datetime.datetime.now() - datetime.timedelta(days=1)).strftime('%Y-%m-%d')
        return last_trading_day
```

#### API接口实现

```python
# 最后交易日获取接口
@app.route('/api/last-trading-day', methods=['GET'])
def get_last_trading_day():
    try:
        symbol = request.args.get('symbol', 'CU2603')  # 默认使用CU2603合约
        last_trading_day = data_fetcher.get_last_trading_day(symbol)
        
        return jsonify({'status': 'success', 'data': {
            'symbol': symbol,
            'last_trading_day': last_trading_day
        }})
    except Exception as e:
        return jsonify({'status': 'error', 'message': str(e)}), 500
```

## 3. 使用方法

### 3.1 API接口调用

**请求URL**：`http://localhost:5000/api/last-trading-day`

**请求方法**：GET

**参数说明**：
- `symbol`（可选）：合约代码，如 'CU2603'，默认值为 'CU2603'

**返回格式**：

```json
{
  "status": "success",
  "data": {
    "symbol": "CU2603",
    "last_trading_day": "2026-02-23"
  }
}
```

**示例请求**：
```
GET http://localhost:5000/api/last-trading-day
```

**示例响应**：
```json
{
  "status": "success",
  "data": {
    "symbol": "AU2603",
    "last_trading_day": "2026-02-23"
  }
}
```

### 3.2 代码调用

```python
from qihuo_analyzer.data.data_fetcher import DataFetcher

data_fetcher = DataFetcher()
data_fetcher.connect()
last_trading_day = data_fetcher.get_last_trading_day('CU2603')
print(f"最后一个交易日: {last_trading_day}")  # 输出：最后一个交易日: 2026-02-23
```

## 4. 技术特点

1. **实时数据**：通过TQSDK获取实时的最后交易日数据
2. **容错机制**：当TQSDK不可用时，自动使用模拟数据
3. **异常处理**：实现了多层异常捕获，确保接口稳定性
4. **灵活调用**：支持通过API接口或直接代码调用
5. **默认值**：当未指定合约代码时，默认使用CU2603合约

## 5. 注意事项

1. **网络连接**：使用TQSDK获取数据需要稳定的网络连接
2. **合约代码格式**：请使用正确的合约代码格式，如 'CU2603'
3. **数据延迟**：由于需要从TQSDK获取数据，可能会有一定的网络延迟
4. **模拟数据**：当TQSDK不可用时，会返回前一天的日期作为模拟数据

## 6. 故障排查

### 6.1 常见问题

| 问题 | 可能原因 | 解决方案 |
|------|---------|--------|
| 返回模拟数据 | TQSDK连接失败或网络问题 | 检查网络连接，确保TQSDK账号配置正确 |
| 接口返回错误 | 合约代码格式错误 | 使用正确的合约代码格式，如 'CU2603' |
| 数据延迟 | 网络延迟或TQSDK服务器响应慢 | 耐心等待，或使用模拟数据 |

### 6.2 日志查看

- **Python服务日志**：在启动Python服务的终端中查看
- **API日志**：通过访问API端点，查看返回结果和错误信息

## 7. 总结

本接口提供了一种便捷的方式来获取期货合约的最后一个交易日，支持实时数据和模拟数据两种模式。通过简单的API调用或代码调用，用户可以轻松获取所需的最后交易日信息，为交易策略和风险管理提供支持。