Synth Data

# Synthdata Volatility Skill

查询并分析来自 Synthdata.co 的波动率预测，涵盖加密货币、大宗商品和股票指数。

## 设置

设置您的 API 密钥： ```bash export SYNTHDATA_API_KEY=your_key_here ```

## 快速开始

```bash # Single asset python3 scripts/synth.py BTC

# Multiple assets comparison python3 scripts/synth.py BTC ETH SOL --compare

# All assets overview python3 scripts/synth.py --all

# Monte Carlo simulation (24h max) python3 scripts/synth.py BTC --simulate --hours 12 ```

## 可用资产

| Ticker | 名称 | 类别 | |--------|------|----------| | BTC | 比特币 | 加密货币 | | ETH | 以太坊 | 加密货币 | | SOL | Solana | 加密货币 | | XAU | 黄金 | 大宗商品 | | SPYX | 标普 500 | 指数 | | NVDAX | NVIDIA | 股票 | | GOOGLX | Google | 股票 | | TSLAX | 特斯拉 | 股票 | | AAPLX | 苹果 | 股票 |

## 输出示例

``` ================================================== BTC — Bitcoin ================================================== Price: $77,966 24h Change: 🔴 -0.95% Current Vol: 58.4% 🟠 [Elevated] Avg Realized: 53.3% Forecast Vol: 52.2% ```

## 波动率等级

| 等级 | 范围 | Emoji | |-------|-------|-------| | 低 | < 20% | 🟢 | | 中等 | 20-40% | 🟡 | | 上升 | 40-60% | 🟠 | | 高 | 60-80% | 🔴 | | 极高 | > 80% | 🔴 |

## 用例

### 1. 市场概览 ```bash python3 scripts/synth.py --all ``` 获取按波动率排名的所有资产表格。

### 2. 交易信号 - **高预测 → 当前低**：预计波动率飙升 - **低预测 → 当前高**：波动率可能会下降 - 用于仓位规模管理和期权交易

### 3. 蒙特卡洛预测 ```bash python3 scripts/synth.py BTC --simulate --hours 24 --paths 1000 ``` 使用预测波动率生成概率价格范围（最长 24 小时 - Synthdata 预测窗口）。

### 4. 定期报告 创建一个 cron 任务，用于每日发送 Slack/Telegram 预测（参见 examples/use-cases.md）。

### 5. 风险警报 监控跨越波动率阈值的资产并触发通知。

## API 参考

查看 `references/api.md` 获取完整的 API 文档。

## 直接 API 使用

```python import requests

resp = requests.get( "https://api.synthdata.co/insights/volatility", params={"asset": "BTC"}, headers={"Authorization": f"Apikey {API_KEY}"} ) data = resp.json()

# Key fields: price = data["current_price"] realized_vol = data["realized"]["average_volatility"] forecast_vol = data["forecast_future"]["average_volatility"] ```

## 集成思路

- **Polymarket**：使用波动率预测为看涨/看跌市场投注提供参考 - **期权**：高预测波动率 = 考虑买入期权 - **投资组合**：当整体波动率飙升时进行再平衡 - **警报**：当预测与实际波动率显著不同时进行通知