Synth Data

Query volatility forecasts from Synthdata.co for crypto, commodities, and stocks. Compare assets and run Monte Carlo simulations.

Security Scan

The skill's code, instructions, and requested environment variable (SYNTHDATA_API_KEY) align with its stated purpose of querying Synthdata.co and running local Monte Carlo analyses.

Purpose & Capability

Name/description describe volatility forecasts and simulations; the skill only requires python3 and a SYNTHDATA_API_KEY which directly match that purpose. The included scripts call https://api.synthdata.co and perform local processing — proportional to the stated functionality.

Instruction Scope

SKILL.md and examples instruct only to set SYNTHDATA_API_KEY and run the CLI or example integration snippets. Runtime instructions and the script fetch from the Synthdata API and perform local calculations; there are no instructions to read unrelated system files, shell history, or other environment variables.

Install Mechanism

This is an instruction-only skill with a Python script and no install spec. It requires python3 on PATH and does not download or execute remote installers — minimal disk/write risk from the skill itself.

Credentials

Only SYNTHDATA_API_KEY is required and documented in clawhub.json and SKILL.md. That single credential is appropriate for calling the external Synthdata API; the code does not access additional secrets or unrelated env vars.

Persistence & Privilege

always is false and the skill does not request persistent or elevated system-wide privileges. Autonomous invocation (default) is allowed but not combined with broad access or unusual behaviors.

Assessment

This skill is coherent: it needs your Synthdata API key and Python 3, then calls api.synthdata.co and runs local Monte Carlo simulations. Before installing, confirm you trust the Synthdata service and that the API key you provide has only the minimal permissions you intend. If you plan to wire outputs into Slack/Telegram, note those integrations would require additional webhook tokens (not requested by this skill) and you should treat those secrets carefully. If you want to limit risk, keep autonomous invocation disabled for agents that you don't want calling external services automatically.

Synthdata Volatility Skill

Query and analyze volatility forecasts from Synthdata.co for crypto, commodities, and stock indices.

Setup

Set your API key:

export SYNTHDATA_API_KEY=your_key_here

Quick Start

# 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

Available Assets

Ticker	Name	Category
BTC	Bitcoin	Crypto
ETH	Ethereum	Crypto
SOL	Solana	Crypto
XAU	Gold	Commodity
SPYX	S&P 500	Index
NVDAX	NVIDIA	Stock
GOOGLX	Google	Stock
TSLAX	Tesla	Stock
AAPLX	Apple	Stock

Output Example

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

Volatility Levels

Level	Range	Emoji
Low	< 20%	🟢
Moderate	20-40%	🟡
Elevated	40-60%	🟠
High	60-80%	🔴
Extreme	> 80%	🔴

Use Cases

1. Market Overview

python3 scripts/synth.py --all

Get a ranked table of all assets by volatility.

2. Trading Signals

• High forecast → Current low: Expect volatility spike
• Low forecast → Current high: Volatility may decrease
• Use for position sizing and options trading

3. Monte Carlo Projections

python3 scripts/synth.py BTC --simulate --hours 24 --paths 1000

Generate probabilistic price ranges using forecast volatility (24h max - Synthdata forecast window).

4. Scheduled Reports

Create a cron job for daily Slack/Telegram forecasts (see examples/use-cases.md).

5. Risk Alerts

Monitor for assets crossing volatility thresholds and trigger notifications.

API Reference

See references/api.md for full API documentation.

Direct API Usage

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"]

Integration Ideas

• Polymarket: Use volatility forecasts to inform up/down market bets
• Options: High forecast vol = consider buying options
• Portfolio: Rebalance when aggregate volatility spikes
• Alerts: Notify when forecast differs significantly from realized