ben
/
liurenchaxin
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
liurenchaxin/internal/technical/api_scheduling_strategy.md

6.1 KiB
Raw Blame History

🧠 Yahoo Finance API智能调度策略

核心问题：什么时候调用什么API？

基于你的6个Yahoo Finance API订阅，我们设计了一套智能调度策略，确保在正确的时间使用正确的API。

🎯 API专业化分工

1. Yahoo Finance 经典版 (yahoo-finance15.p.rapidapi.com)

🏛️ 专长：全面基础功能
📊 最佳用途：
  - 实时股票报价 (/api/yahoo/qu/quote/{symbol})
  - 涨跌幅榜单 (/api/yahoo/co/collections/day_gainers)
  - 市场新闻 (/api/yahoo/ne/news)
  - 最活跃股票 (/api/yahoo/co/collections/most_actives)

⏰ 最佳时机：
  - 交易时段 (9:30-16:00 EST) - 实时数据需求高
  - 需要综合市场概览时
  - 其他API达到限制时的备用选择

2. YH Finance 完整版 (yh-finance.p.rapidapi.com)

🔬 专长：结构化深度数据
📊 最佳用途：
  - 公司档案 (/stock/v2/get-profile)
  - 股票摘要 (/stock/v2/get-summary)
  - 批量市场报价 (/market/v2/get-quotes)

⏰ 最佳时机：
  - 需要详细公司信息时
  - 进行基本面分析时
  - 批量处理多只股票时
  - 非交易时段的深度研究

3. Yahoo Finance 搜索版 (yahoo-finance-api1.p.rapidapi.com)

🔍 专长：搜索和趋势发现
📊 最佳用途：
  - 股票搜索 (/v1/finance/search)
  - 趋势股票 (/v1/finance/trending)

⏰ 最佳时机：
  - 用户主动搜索股票时
  - 发现热门趋势时
  - 构建股票池时
  - 市场开盘前的准备阶段

4. Yahoo Finance 实时版 (yahoo-finance-low-latency.p.rapidapi.com)

⚡ 专长：低延迟实时数据
📊 最佳用途：
  - 实时报价摘要 (/v11/finance/quoteSummary/{symbol})
  - 市场筛选器 (/ws/screeners/v1/finance/screener/predefined/saved)

⏰ 最佳时机：
  - 交易时段的高频更新
  - 需要最低延迟的场景
  - 实时监控和告警
  - 日内交易决策支持

5. YH Finance 增强版 (yh-finance-complete.p.rapidapi.com)

📊 专长：历史深度数据
📊 最佳用途：
  - 股票详细信息 (/stock/get-detail)
  - 历史价格数据 (/stock/get-histories)

⏰ 最佳时机：
  - 技术分析需求
  - 回测策略时
  - 夜间数据处理
  - 生成历史报告

6. Yahoo Finance 基础版 (yahoo-finance127.p.rapidapi.com)

⚡ 专长：简洁高效
📊 最佳用途：
  - 简单价格查询 (/price/{symbol})
  - 关键统计数据 (/key-statistics/{symbol})

⏰ 最佳时机：
  - 高频简单查询
  - 系统健康检查
  - 其他API故障时的备用
  - 成本敏感的场景

🕐 时间窗口调度策略

交易时段 (9:30-16:00 EST)

🎯 优先级：实时性 > 成本
📊 主力API：
  1. Yahoo Finance 实时版 - 低延迟报价
  2. Yahoo Finance 经典版 - 综合数据
  3. Yahoo Finance 基础版 - 高频查询

🔄 轮换策略：
  - 每5分钟轮换主力API
  - 监控响应时间，超过200ms自动切换
  - 使用率超过80%时强制切换

盘前时段 (4:00-9:30 EST)

🎯 优先级：数据准备 > 实时性
📊 主力API：
  1. YH Finance 完整版 - 公司基本面
  2. Yahoo Finance 搜索版 - 趋势发现
  3. YH Finance 增强版 - 历史数据

🔄 轮换策略：
  - 批量处理优先
  - 为交易时段预热数据
  - 更新股票池和关注列表

盘后时段 (16:00-20:00 EST)

🎯 优先级：分析总结 > 实时性
📊 主力API：
  1. YH Finance 增强版 - 历史分析
  2. Yahoo Finance 经典版 - 新闻总结
  3. YH Finance 完整版 - 深度分析

🔄 轮换策略：
  - 生成日报和总结
  - 技术指标计算
  - 策略回测和优化

夜间时段 (20:00-4:00 EST)

🎯 优先级：成本效益 > 实时性
📊 主力API：
  1. Yahoo Finance 基础版 - 低成本维护
  2. YH Finance 增强版 - 历史数据处理
  3. Yahoo Finance 搜索版 - 趋势分析

🔄 轮换策略：
  - 最小化API调用
  - 数据清理和整理
  - 系统维护和备份

🎮 智能调度算法

评分机制 (总分100分)

API评分 = (
    专长匹配度 * 40% +      # 是否擅长处理该类型数据
    使用率健康度 * 25% +    # 当前使用率是否合理
    性能质量 * 20% +        # 历史成功率和响应时间
    可靠性 * 10% +          # API稳定性
    成本效益 * 5%           # 调用成本
)

故障转移策略

1. 主API失败 → 自动切换到备用API
2. 连续3次失败 → 暂时屏蔽该API (30分钟)
3. 响应时间>500ms → 降级到更快的API
4. 使用率>90% → 强制切换到其他API
5. 所有API失败 → 启用紧急模式，使用缓存数据

负载均衡

1. 轮询策略：按使用率轮换API
2. 加权策略：根据API性能分配权重
3. 随机策略：20%概率选择次优API，避免过度集中
4. 时间策略：根据时间窗口调整优先级

🚀 实际应用场景

场景1：用户查询AAPL股价

1. 检测当前时间窗口 → 交易时段
2. 数据类型 → 实时报价
3. 智能选择 → Yahoo Finance 实时版 (评分最高)
4. 执行调用 → 成功，响应时间150ms
5. 更新统计 → 使用率+1，质量评分更新

场景2：批量获取50只股票数据

1. 检测数据类型 → 批量报价
2. 智能选择 → YH Finance 完整版 (专长匹配)
3. 分批处理 → 每批10只，避免单次过载
4. 故障转移 → 如失败，自动切换到Yahoo Finance 经典版
5. 负载均衡 → 后续批次使用不同API

场景3：夜间历史数据分析

1. 检测时间窗口 → 夜间时段
2. 数据类型 → 历史数据
3. 智能选择 → YH Finance 增强版 (专长+时间匹配)
4. 成本优化 → 优先使用低成本API
5. 批量处理 → 大批量数据处理

📊 监控和优化

实时监控指标

  • API响应时间分布
  • 成功率趋势
  • 使用率分布
  • 成本统计
  • 故障转移频率

自动优化

  • 每小时重置使用计数器
  • 每日更新API性能评分
  • 每周分析调度效果
  • 每月优化调度策略

总结：通过这套智能调度策略，你的"永动机"不仅能避免API限制，还能在正确的时间使用最合适的API，实现成本最优、性能最佳的数据获取！ 🎯