> For the complete documentation index, see [llms.txt](https://docs.synthdata.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.synthdata.co/insights.md).

# Insights

{% hint style="info" %}
Advanced analytics derived from predictions. Requires Professional or Enterprise plan.
{% endhint %}

## Parameters

All endpoints support:

* `asset` query parameter: BTC, ETH, XAU, SOL, SPY, NVDA, GOOGL, TSLA, AAPL, XRP, HYPE, WTIOIL
* two prediction horizons, controlled by the `horizon` query parameter: `1h` , `24h`,
  * default value is 24h, unless for polymarket hourly and 15 minutes insights.
* REST endpoint also support a `start_time` query parameter to fetch historical insights

## REST and Websocket API

All endpoints are available via the [REST API](/introduction.md#rest-api) (`https://api.synthdata.co`) and the [Websocket API](/introduction.md#websocket-api) (`wss://api.synthdata.co/ws`).

## Insights

### Volatility

Forecast and realized volatility metrics.

Endpoints:

* `/insights/volatility`
* `/insights/prediction-percentiles`

[View Volatility Documentation](/insights/volatility.md)

### Trading

Liquidity provision optimization and prediction market comparisons.

Endpoints:

* `/insights/lp-bounds`
* `/insights/lp-probabilities`

[View Trading Documentation](#trading)

### Polymarket

Compare Synth predictions against Polymarket prices.

Endpoints:

* `/insights/polymarket/up-down/daily`
* `/insights/polymarket/up-down/hourly`
* `/insights/polymarket/up-down/15min`
* `/insights/polymarket/range`

[View Polymarket Documentation](/insights/polymarket.md)

### Limitless

Compare Synth predictions against Limitless prices.

Endpoints:

* `/insights/limitless/daily` 
  * assets: `BTC`, `ETH`, `SOL`, `XRP`, `HYPE`, `XAU`  
* `/insights/limitless/hourly`
  * assets: `BTC`, `ETH`, `SOL`, `XAU`  
* `/insights/limitless/15min`
  * assets: `BTC`, `ETH`, `SOL` 

[View Limitless Documentation](https://docs.synthdata.co/insights/limitless)

### Options

Theoretical option pricing from Monte Carlo simulations.

Endpoints:

* `/insights/option-pricing`

[View Options Documentation](/insights/options.md)

### Risk Management

Liquidation probabilities and position risk analysis.

Endpoints:

* `/insights/liquidation`

[View Risk Management Documentation](/insights/risk-management.md)

### Historical Insights

Accessing the historical data can be usefull to backtest strategies. Specify the start\_time parameter on the REST API Insights endpoints:

```bash
curl -L 'https://api.synthdata.co/insights/limitless/hourly?asset=BTC&start_time=2026-03-28' \ 
    -H 'Authorization: Apikey YOUR_API_KEY'
```

### Quick Example

{% code title="curl" %}

```bash
curl "https://api.synthdata.co/insights/volatility?asset=BTC" \
  -H "Authorization: Apikey YOUR_API_KEY"
```

{% endcode %}