https://github.com/proselytecoding/citicup
花旗杯比赛
https://github.com/proselytecoding/citicup
Last synced: 12 months ago
JSON representation
花旗杯比赛
- Host: GitHub
- URL: https://github.com/proselytecoding/citicup
- Owner: ProselyteCoding
- Created: 2025-03-13T02:00:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-24T01:37:52.000Z (12 months ago)
- Last Synced: 2025-06-24T02:34:37.512Z (12 months ago)
- Language: Python
- Size: 1.15 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# RiskFX 项目交互文档
接口部分需要前后端结合实现，请仔细阅读并参考构建。
## 🆕 新功能：同花顺 iFind API 集成
本项目已集成同花顺 iFind API，实现了真实的外汇数据获取功能：
### 主要功能
- **实时外汇数据**: 获取 USD/CNY, EUR/USD, GBP/USD, USD/JPY 等主要货币对的实时价格
- **多种图表类型**: 支持分时线、K 线图、移动平均线(MA)、MACD 等技术指标
- **自动数据更新**: 实时数据每 30 秒更新，图表数据每分钟更新
- **智能降级**: API 调用失败时自动使用模拟数据确保系统正常运行
### 快速启动
1. 配置同花顺 API Token（编辑 `server/.env` 文件）
2. 运行 `start.bat` (Windows 批处理) 或 `start.ps1` (PowerShell)
3. 访问 http://localhost:5173 查看应用
详细配置说明请参考 [FOREX_API_README.md](./FOREX_API_README.md)
---
## 接口一：页面三上传持仓数据
前端向后端以 post 方式发送 json 格式的持仓数据表格
json 数据格式：
```json
[
{
"currency": "USD/JPY", // 货币对 string
"quantity": 10000, // 持仓量 number
"proportion": 0.5, // 持仓占比 number
"benefit": -1000, // 盈亏 number（修正冒号为英文符号）
"dailyVolatility": 0.125, // 日波动率 number
"valueAtRisk": "15000", // VaR(95%) string ！这里需要修改，不要加逗号，和$这个符号
"beta": 1.2, // Beta number
"hedgingCost": 0.0015 // 对冲成本 number
}
// ...（多个持仓对象）
]
```
## 接口二：页面三上传压力测试情景
前端向后端以 post 方式发送 json 格式的压力测试情景并获取测试分析结果
发送 json 数据格式：
```json
{
"scenario": "爆发新一轮全球经济危机" // 压力测试情景描述 string
}
```
返回 json 数据格式：
```json
{
scenario:"爆发新一轮全球经济危机" // 压力测试情景描述 string
influence: "高", // 影响程度 string 高/中/低
probability: 0.01, // 发生概率 number
suggestion: "减少EUR敞口" // 建议措施 string
}
```
## 接口三：页面三接受页面三相关信息
前端向后端以 get 方式获取页面三相关信息
后端返回 json 数据格式：
```json
{
"historicalAnalysis": null, // 历史回测分析（暂未提供）
"currentHedgingAdvice": {
"volatility": 0.125, // 波动率 number（12.5%转换为小数）
"emotion": "偏多", // 市场情绪指标 string
"suggestion": "减少EUR敞口"
},
"positionRiskAssessment": {
"risk": "高风险", // 当前风险敞口 string
"var": "$25,000", // VaR(95%)
"suggestion": "减少EUR敞口"
},
"correlationAnalysis": {
"relative": "强正相关", // 货币对相关性 string
"estimate": "中等", // 对冲效果预估 string
"suggestion": "减少EUR敞口" // 修正拼写错误
},
"costBenefitAnalysis": {
"cost": 0.0015, // 对冲成本 number（0.15%转换为小数）
"influence": "高", // 影响程度 string
"suggestion": "减少EUR敞口"
},
"recommendedPositions": [
// 货币建议持仓
{
"currency": "USD/JPY", // 货币对 string
"quantity": 10000 // 持仓量 number
}
// ...其他持仓
]
}
```
## 接口四：获取页面二相关风险信息
向后端发送 get 请求，请求页面二相关风险信息
后端发送数据格式(json)：
```json
{
"currencyExposure": [
// 高风险货币列表
{
"currency": "USD/JPY", // 货币对 string
"riskRate": "高风险", // 风险率 string
"tendency": "上" // 趋势 string
}
// ...其他货币对
],
"termRiskDistribution": [
// 账期风险分布
{
"time": 30, // 时间分区（单位：天）
"risk": 0.01
}
// ...其他时间段
],
"riskTransmissionPath": ["JPY30", "GBP40", "USD50"], // 风险传导路径
"macroRiskCoefficients": [
// 宏观风险系数(ERI)
{
"month": 1, // 月份
"all": 80, // 综合指数
"economy": 60, // 经济指数
"policy": 40, // 政策指标
"market": 20 // 市场指标
}
// ...其他月份
],
"riskSignalAnalysis": {
"current": {
"credit": 80, // 信用风险
"policy": 20, // 政策风险
"market": 10, // 市场流动性
"politician": 30, // 政治风险
"economy": 40 // 经济风险
},
"warning": {
// 预警阈值
"credit": 80,
"policy": 20,
"market": 10,
"politician": 30,
"economy": 40
}
},
"singleCurrencyAnalysis": [
// 单一货币对回测分析
{
"time": "2021-01-01",
"currency": "USD/JPY",
"upper": 1.0513, // 预测上限
"lower": 0.9487 // 预测下限
}
// ...其他货币对
]
}
```