Tide Chart: Equity Forecast Comparison Dashboard

[e35ventura]

Tide Chart: Equity Forecast Comparison Dashboard

Category: Best Equities Application
Difficulty: Intermediate
Synth Endpoints Used: get_prediction_percentiles(), get_volatility()

---

What It Is

A comparison dashboard that overlays Synth's probabilistic price forecasts for 5 correlated equities (SPY, NVDA, TSLA, AAPL, GOOGL) on a single view.

Equities tend to move together, but the magnitude and skew of those moves vary. This tool uses SPY as the anchor to expose which individual stocks are showing relative strength, relative weakness, or asymmetric risk or reward compared to the broader market.

Core Features

1. The Comparison View

Overlay the 24-hour probability cones (5th to 95th percentiles) for all 5 equities, normalized by percentage change. This instantly reveals:

• Directional alignment: Are all names forecasting the same trend, or is it a mixed day?
• Relative magnitude: Which stock has the widest expected range?
• Asymmetric Skew: Comparing upside vs downside tails. This applies on an individual basis (does the stock have more room to run up than down?) and a relative basis (if SPY is skewed -1% downside but AAPL is skewed +2% upside, AAPL is showing massive relative strength despite the market pulling back).

2. The Rank Table

A summary view sorting all 5 equities by key metrics derived from the forecast:

• Median Expected Move
• Forecasted Volatility
• Directional Skew (upside vs. downside tails)
• Relative to SPY

No trading advice — just a clear, comparative view of what Synth is forecasting for the index vs. individual components.

---

Submission Requirements

• Demo video — Screen recording showing the dashboard in action
• 1-page technical explanation — Include as tools/tide-chart/README.md. Should cover what the tool does, how it works, and how it uses Synth data
• Tests in tools/tide-chart/tests/

Getting Started

This repo includes a wrapper client so you can build without a Synth API key:

from synth_client import SynthClient

client = SynthClient()  # auto-loads mock data when no API key is set

# Example: Get probability distribution
forecast = client.get_prediction_percentiles("SPY", horizon="24h")

# Example: Get volatility forecast
vol = client.get_volatility("NVDA", horizon="24h")

Note: Equities only support the 24h horizon. The 1h horizon is available for crypto (BTC, ETH, SOL) and XAU only. Supported equities are SPY, NVDA, TSLA, AAPL, and GOOGL.

1. Fork the repo and clone it
2. Copy the template: cp -r tools/_template tools/tide-chart
3. pip install -r requirements.txt
4. Build your tool using the SynthClient
5. Open a PR when ready