> 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-1.md).

# Endpoints Overview

## Base URL

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

{% hint style="info" %}
All endpoints require the following header:

```
Authorization: Apikey YOUR_API_KEY
```

{% endhint %}

## Predictions

Get probabilistic price forecasts from miners.

| Endpoint                        | Description                                  |
| ------------------------------- | -------------------------------------------- |
| `GET /v2/prediction/best`       | Predictions from top-ranked miner (simplest) |
| `GET /v2/prediction/latest`     | Predictions from specific miners             |
| `GET /v2/prediction/historical` | Historical predictions                       |

## Leaderboard

Discover top-performing miners.

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

Example request:

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

## Insights

Advanced analytics derived from predictions.

| Endpoint                                  | Description                    |
| ----------------------------------------- | ------------------------------ |
| `GET /insights/volatility`                | Volatility metrics             |
| `GET /insights/volatility-percentiles`    | Price distribution percentiles |
| `GET /insights/option-pricing`            | Theoretical option prices      |
| `GET /insights/liquidation`               | Liquidation probabilities      |
| `GET /insights/lp-bounds`                 | LP range optimization          |
| `GET /insights/lp-bounds-chart`           | Price level probabilities      |
| `GET /insights/polymarket/range`          | Polymarket range comparison    |
| `GET /insights/polymarket/up-down/hourly` | Hourly up/down comparison      |
| `GET /insights/polymarket/up-down/daily`  | Daily up/down comparison       |