> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nefariouslabs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Funding Rate

> Acces aux funding rates des contrats perpetuels en temps reel

# Funding Rate

Accedez aux funding rates des contrats perpetuels depuis les principaux exchanges, agreges et normalises pour une utilisation simple.

## A quoi ca sert ?

Les funding rates sont essentiels pour :

* **Arbitrage** : Identifier les ecarts de taux entre exchanges
* **Analyse de sentiment** : Les taux positifs indiquent un sentiment haussier, negatifs un sentiment baissier
* **Gestion de positions** : Anticiper les couts de financement sur vos positions

## Exchanges disponibles

| Exchange    | Intervalle | Quote |
| ----------- | ---------- | ----- |
| Binance     | 8h         | USDT  |
| Bybit       | 8h         | USDT  |
| OKX         | 8h         | USDT  |
| Deribit     | 8h         | USD   |
| Hyperliquid | 1h         | -     |

## Fonctionnalites

<CardGroup cols={2}>
  <Card title="Multi-Exchange" icon="layer-group">
    Donnees agregees depuis 5 exchanges majeurs en une seule requete
  </Card>

  <Card title="Historique" icon="clock-rotate-left">
    Acces a l'historique complet avec filtrage par date
  </Card>

  <Card title="Symboles normalises" icon="arrows-rotate">
    Utilisez `BTC`, `ETH`, `SOL` - nous gerons les variations par exchange
  </Card>

  <Card title="Temps reel" icon="bolt">
    Donnees mises a jour en continu
  </Card>
</CardGroup>

## Exemple rapide

Recuperer les funding rates actuels pour Bitcoin :

```bash theme={null}
curl "https://api.nefariouslabs.dev/api/funding-rates?symbol=BTC"
```

Reponse :

```json theme={null}
{
  "data": [
    {
      "symbol": "BTC",
      "exchange": "binance",
      "rate": 0.0001,
      "fundingTime": "2024-01-15T08:00:00Z",
      "markPrice": 42500.50
    },
    {
      "symbol": "BTC",
      "exchange": "bybit",
      "rate": 0.00012,
      "fundingTime": "2024-01-15T08:00:00Z",
      "markPrice": 42501.20
    }
  ]
}
```

## Endpoints disponibles

| Endpoint                         | Description                        |
| -------------------------------- | ---------------------------------- |
| `GET /api/funding-rates`         | Funding rates actuels par symbole  |
| `GET /api/funding-rates/history` | Historique des funding rates       |
| `GET /api/exchanges`             | Liste des exchanges et leur statut |
| `GET /health`                    | Statut du service                  |

<Card title="Reference API complete" icon="book" href="/api-reference/endpoints/funding-rates">
  Consultez la documentation detaillee des endpoints avec tous les parametres et exemples.
</Card>
