> 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/endpoints-overview.md).

# Endpoints Overview

## Base URL

```
https://api.synthdata.co
```

All endpoints require the following header:

```
Authorization: Apikey YOUR_API_KEY
```

**Forecast Horizons:** All insight endpoints accept an optional `horizon` query parameter: `1h` , `24h`.

## Prediction Percentiles

Get probabilistic price forecasts.

| Endpoint                               | Description                                                     |
| -------------------------------------- | --------------------------------------------------------------- |
| `GET /insights/prediction-percentiles` | Price percentiles (5th, 50th, 95th, etc.) at 5-minute intervals |

## Leaderboard

Discover top-performing miners.

| Endpoint                     | Description            |
| ---------------------------- | ---------------------- |
| `GET /v2/leaderboard/latest` | Current miner rankings |

Example request:

{% code title="curl" %}

```bash
curl "https://api.synthdata.co/v2/leaderboard/latest?asset=BTC&days=14&limit=10" \
  -H "Authorization: Apikey YOUR_API_KEY"
```

{% endcode %}

## Insights

Advanced analytics derived from predictions.

| Endpoint                                  | Description                   |
| ----------------------------------------- | ----------------------------- |
| `GET /insights/volatility`                | Volatility metrics            |
| `GET /insights/option-pricing`            | Theoretical option prices     |
| `GET /insights/liquidation`               | Liquidation probabilities     |
| `GET /insights/lp-bounds`                 | LP range optimization         |
| `GET /insights/lp-probabilities`          | Price level probabilities     |
| `GET /insights/polymarket/up-down/daily`  | Daily up/down comparison      |
| `GET /insights/polymarket/up-down/hourly` | Hourly up/down comparison     |
| `GET /insights/polymarket/up-down/15min`  | 15 minutes up/down comparison |
| `GET /insights/polymarket/range`          | Polymarket range comparison   |
| `GET /insights/limitless/daily`           | Limitless above comparison    |
| `GET /insights/limitless/hourly`          | Limitless above comparison    |
| `GET /insights/limitless/`15min           | Limitless above comparison    |

## Price Predictions

Full prediction paths for advanced use cases. Contact <support@synthdata.co> for more information.

| Endpoint                                  | Description                                 |
| ----------------------------------------- | ------------------------------------------- |
| `GET /v2/prediction/best`                 | Full prediction paths from top-ranked miner |
| `GET /v2/prediction/latest`               | Full prediction paths from specific miners  |
| `GET /v2/prediction/historical`           | Historical predictions                      |
| `GET /v2/prediction/metamodel`            | Metamodel prediction                        |
| `GET /v2/prediction/metamodel/historical` | Historical predictions of the metamodel     |