100 lines
3.5 KiB
Markdown
100 lines
3.5 KiB
Markdown
# 🎯 RapidAPI Yahoo Finance 永动机指南
|
||
|
||
## 概述
|
||
|
||
炼妖壶项目集成了**6个不同的Yahoo Finance API**，实现"永动机"策略，通过智能轮换避免速率限制，确保数据获取的连续性和可靠性。
|
||
|
||
## 🔧 API配置矩阵
|
||
|
||
| API名称 | 主机 | 特色 | 主要用途 | 使用率 |
|
||
|---------|------|------|----------|--------|
|
||
| Yahoo Finance 经典版 | yahoo-finance15.p.rapidapi.com | 全面基础功能 | 日常报价、榜单、新闻 | 低 |
|
||
| YH Finance 完整版 | yh-finance.p.rapidapi.com | 结构化深度数据 | 公司分析、市场研究 | 中 |
|
||
| Yahoo Finance 搜索版 | yahoo-finance-api1.p.rapidapi.com | 搜索和趋势 | 股票发现、热点追踪 | 低 |
|
||
| Yahoo Finance 实时版 | yahoo-finance-low-latency.p.rapidapi.com | 低延迟实时 | 高频交易、实时监控 | 高 |
|
||
| YH Finance 增强版 | yh-finance-complete.p.rapidapi.com | 历史深度数据 | 回测分析、历史研究 | 中 |
|
||
| Yahoo Finance 基础版 | yahoo-finance127.p.rapidapi.com | 简洁高效 | 价格监控、统计数据 | 高 |
|
||
|
||
## 🎮 智能轮换策略
|
||
|
||
### 数据类型映射
|
||
```python
|
||
DATA_TYPE_API_MAPPING = {
|
||
'real_time_quotes': ['yahoo-finance-low-latency', 'yahoo-finance127'],
|
||
'historical_data': ['yh-finance-complete', 'yahoo-finance15'],
|
||
'market_lists': ['yahoo-finance15'],
|
||
'company_profile': ['yh-finance', 'yahoo-finance15'],
|
||
'search_trending': ['yahoo-finance-api1'],
|
||
'news': ['yahoo-finance15']
|
||
}
|
||
```
|
||
|
||
### 故障转移机制
|
||
1. **主API达到限制** → 自动切换到备用API
|
||
2. **API响应异常** → 降级到基础版本
|
||
3. **数据质量检查** → 多源验证确保准确性
|
||
|
||
## 🚀 使用示例
|
||
|
||
### 基础调用
|
||
```python
|
||
from rapidapi_perpetual_machine import RapidAPIPerpetualMachine
|
||
|
||
machine = RapidAPIPerpetualMachine()
|
||
|
||
# 智能获取股票报价（自动选择最佳API）
|
||
quote = await machine.get_smart_quote('AAPL')
|
||
|
||
# 获取实时数据（优先使用低延迟API）
|
||
realtime = await machine.get_realtime_data('TSLA')
|
||
|
||
# 获取历史数据（使用历史数据专用API）
|
||
history = await machine.get_historical_data('NVDA', period='1y')
|
||
```
|
||
|
||
### 高级功能
|
||
```python
|
||
# 批量数据获取（自动分配到不同API）
|
||
symbols = ['AAPL', 'GOOGL', 'MSFT', 'TSLA']
|
||
batch_data = await machine.get_batch_quotes(symbols)
|
||
|
||
# 实时监控（使用多API轮换）
|
||
async for update in machine.stream_market_data(symbols):
|
||
print(f"实时更新: {update}")
|
||
```
|
||
|
||
## 📊 性能监控
|
||
|
||
### API使用统计
|
||
- **实时版**: 高频使用，适合交易时段
|
||
- **基础版**: 稳定可靠，适合持续监控
|
||
- **完整版**: 深度分析，适合研究报告
|
||
- **搜索版**: 发现功能，适合策略开发
|
||
|
||
### 成本效益分析
|
||
```python
|
||
# 查看API使用统计
|
||
stats = machine.get_usage_stats()
|
||
print(f"今日API调用分布: {stats}")
|
||
|
||
# 优化建议
|
||
recommendations = machine.get_optimization_recommendations()
|
||
```
|
||
|
||
## 🎯 最佳实践
|
||
|
||
1. **数据类型优先级**: 根据数据需求选择最适合的API
|
||
2. **时间窗口管理**: 交易时段使用实时API，非交易时段使用基础API
|
||
3. **缓存策略**: 相同数据在短时间内避免重复请求
|
||
4. **错误处理**: 多层故障转移，确保服务连续性
|
||
|
||
## 🔮 未来扩展
|
||
|
||
- **AI驱动的API选择**: 基于历史性能自动优化API选择
|
||
- **成本预测模型**: 预测API使用成本，优化预算分配
|
||
- **质量评分系统**: 对不同API的数据质量进行评分和排序
|
||
|
||
---
|
||
|
||
*这就是炼妖壶的"永动机"秘密 - 通过多API协同，实现真正的不间断金融数据服务！* 🚀
|