Skip to main content
GET
/
api
/
funding-rates
Funding Rates
curl --request GET \
  --url https://api.example.com/api/funding-rates
{
  "data": [
    {
      "symbol": "BTC",
      "rawTicker": "BTCUSDT",
      "exchange": "binance",
      "rate": 0.0001,
      "fundingTime": "2024-01-15T08:00:00.000Z",
      "intervalHours": 8,
      "markPrice": 42500.5,
      "indexPrice": 42498.25
    },
    {
      "symbol": "BTC",
      "rawTicker": "BTCUSDT",
      "exchange": "bybit",
      "rate": 0.00012,
      "fundingTime": "2024-01-15T08:00:00.000Z",
      "intervalHours": 8,
      "markPrice": 42501.2,
      "indexPrice": 42499.0
    }
  ]
}

​
GET /api/funding-rates

Recupere les funding rates actuels pour un symbole, agreges depuis plusieurs exchanges.

​
Parametres

​
symbol
string
required
Symbole de l’actif (ex: BTC, ETH, SOL). Case insensitive.
​
exchange
string
Filtre par exchange : binance, bybit, okx, deribit, hyperliquid
​
quote
string
Filtre par devise de cotation (USDT, USDC, USD).

​
Reponse

​
data
FundingRate[]
Tableau des funding rates par exchange
{
  "data": [
    {
      "symbol": "BTC",
      "rawTicker": "BTCUSDT",
      "exchange": "binance",
      "rate": 0.0001,
      "fundingTime": "2024-01-15T08:00:00.000Z",
      "intervalHours": 8,
      "markPrice": 42500.5,
      "indexPrice": 42498.25
    },
    {
      "symbol": "BTC",
      "rawTicker": "BTCUSDT",
      "exchange": "bybit",
      "rate": 0.00012,
      "fundingTime": "2024-01-15T08:00:00.000Z",
      "intervalHours": 8,
      "markPrice": 42501.2,
      "indexPrice": 42499.0
    }
  ]
}

​
Exemples

curl "https://api.nefariouslabs.dev/api/funding-rates?symbol=BTC"

​
GET /api/funding-rates/history

Recupere l’historique des funding rates pour un symbole.

​
Parametres

​
symbol
string
required
Symbole de l’actif (ex: BTC, ETH, SOL). Case insensitive.
​
exchange
string
Filtre par exchange : binance, bybit, okx, deribit, hyperliquid
​
from
string
Date de debut (ISO 8601). Ex: 2024-01-01T00:00:00Z
​
to
string
Date de fin (ISO 8601). Ex: 2024-01-31T23:59:59Z
​
limit
integer
default:"100"
Nombre de resultats (max: 1000)

​
Reponse

​
data
FundingRate[]
Tableau des funding rates historiques, tries par date decroissante
{
  "data": [
    {
      "symbol": "ETH",
      "rawTicker": "ETHUSDT",
      "exchange": "binance",
      "rate": 0.00015,
      "fundingTime": "2024-01-15T16:00:00.000Z",
      "intervalHours": 8,
      "markPrice": 2450.75,
      "indexPrice": 2449.5
    },
    {
      "symbol": "ETH",
      "rawTicker": "ETHUSDT",
      "exchange": "binance",
      "rate": 0.00012,
      "fundingTime": "2024-01-15T08:00:00.000Z",
      "intervalHours": 8,
      "markPrice": 2445.25,
      "indexPrice": 2444.0
    }
  ]
}

​
Exemples

curl "https://api.nefariouslabs.dev/api/funding-rates/history?symbol=ETH&limit=50"

​
GET /api/exchanges

Liste les exchanges disponibles avec leur statut.

​
Reponse

​
data
Exchange[]
Tableau des exchanges
{
  "data": [
    {
      "id": "binance",
      "name": "Binance",
      "defaultIntervalHours": 8,
      "symbolCount": 245,
      "isActive": true
    },
    {
      "id": "bybit",
      "name": "Bybit",
      "defaultIntervalHours": 8,
      "symbolCount": 198,
      "isActive": true
    },
    {
      "id": "hyperliquid",
      "name": "Hyperliquid",
      "defaultIntervalHours": 1,
      "symbolCount": 142,
      "isActive": true
    }
  ]
}

​
Exemple

curl "https://api.nefariouslabs.dev/api/exchanges"

​
GET /health

Verifie la disponibilite du service.

​
Reponse

​
status
string
Statut du service : healthy, degraded, ou unhealthy
​
timestamp
string
Timestamp du check (ISO 8601)
​
exchanges
ExchangeHealth[]
Statut par exchange
{
  "status": "healthy",
  "timestamp": "2024-01-15T16:10:00.000Z",
  "exchanges": [
    {
      "exchange": "binance",
      "status": "healthy",
      "ageMinutes": 5
    },
    {
      "exchange": "bybit",
      "status": "healthy",
      "ageMinutes": 5
    }
  ]
}

​
Exemple

curl "https://api.nefariouslabs.dev/health"