跳转至

数据模型总览

CryptoService 提供了丰富的数据模型来表示市场数据和配置。

📊 模型分类

市场数据模型

Universe模型

  • Universe 模型 - 动态交易对选择和重平衡策略
  • UniverseConfig - Universe配置参数
  • UniverseSnapshot - 特定时间点的交易对快照
  • UniverseDefinition - 完整的Universe定义和历史

枚举类型

  • 枚举类型 - 频率、排序方式、K线类型等常量定义

🔧 使用示例

基础数据模型

from cryptoservice.models import Freq, SortBy
from cryptoservice.models.market_ticker import BaseMarketTicker

# 使用枚举
freq = Freq.h1  # 1小时
sort_by = SortBy.QUOTE_VOLUME  # 按成交额排序

# 处理市场数据
ticker_data = service.get_symbol_ticker("BTCUSDT")
print(f"价格: {ticker_data.last_price}")

Universe 模型使用

from cryptoservice.models import UniverseConfig, UniverseDefinition

# 创建Universe配置
config = UniverseConfig(
    start_date="2024-01-01",
    end_date="2024-12-31",
    t1_months=1,    # 基于1个月数据计算
    t2_months=1,    # 每月重新选择
    t3_months=3,    # 排除3个月内新合约
    top_k=10        # 选择前10个合约
)

# 从文件加载Universe定义
universe_def = UniverseDefinition.load_from_file("./universe.json")

# 获取特定日期的交易对
symbols = universe_def.get_symbols_for_date("2024-02-15")
print(f"交易对: {symbols}")

📚 详细文档

每个模型都有详细的API文档，包括字段说明、类型定义和使用示例。

核心模型文档

模型类别 主要类 用途
市场数据 SymbolTicker, PerpetualMarketTicker 实时行情数据处理
Universe UniverseConfig, UniverseSnapshot, UniverseDefinition 动态交易对选择策略
枚举类型 Freq, SortBy, HistoricalKlinesType 常量和配置选项

🔗 相关链接