Get Funding Rate

Fetches the latest CeFi funding rate for a given symbol on a specified exchange. This can be queried via REST or WebSocket.

GET /1/market/cefi/funding-rate

Get funding rate

cURL

curl --request GET \
  --url https://demo-api.mobula.io/api/1/market/cefi/funding-rate

200

{
  "queryDetails": {
    "base": "<string>",
    "quote": "<string>"
  },
  "binanceFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "marketPrice": "<string>",
    "epochDurationMs": 123
  },
  "deribitFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "marketPrice": 123,
    "epochDurationMs": 123
  },
  "bybitFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "okxFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "hyperliquidFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "gateFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "kucoinFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "mexcFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "bitgetFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "krakenFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  },
  "coinbaseFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "marketPrice": 123,
    "epochDurationMs": 123
  },
  "lighterFundingRate": {
    "symbol": "<string>",
    "fundingTime": 123,
    "fundingRate": 123,
    "epochDurationMs": 123
  }
}

Query Details

Fetches the latest CeFi funding rate for a given symbol.

• If no exchange is provided, the endpoint returns the rate from all supported CeFi exchanges by default (binance, bybit, hyperliquid, deribit, okx, gate, lighter, kucoin, mexc, bitget, kraken, coinbase).
• You can specify one or more exchanges by separating them with commas.

Note on Gate.io:
Uses usdt as the settle currency. Contracts are in format SYMBOL_USDT (e.g., BTC_USDT).

Note on Lighter:
Funding rate sign convention - positive rate means longs pay shorts, negative rate means shorts pay longs. Epoch duration is 1 hour.

Note on Bitget:
quote selects the contract type - USDT → usdt-futures (ticker ETHUSDT), USDC → usdc-futures (ticker ETHPERP), USD → coin-margined coin-futures. Defaults to USDT.

Note on Hyperliquid (DEX - HIP3):
Funding rates from Hyperliquid DEX are available exclusively for HIP3 instruments.

• Symbol prefix: You can prefix the symbol with dex: (e.g., dex:BTC) or use the protocol query parameter.
• Protocol parameter: Use protocol with one of xyz, flx, vntl, hyna, km, cash to request funding for that protocol (e.g. ?symbol=BTC&protocol=xyz → xyz:BTC). If omitted, standard behaviour applies (no prefix unless symbol contains : or is a stock-like symbol like XYZ100 which defaults to xyz).
• For custom HIP3 perpetuals such as XYZ100, you can use symbol=dex:XYZ100 or symbol=XYZ100&protocol=xyz.
  This keeps the existing dex: and stock-like prefix behaviour; protocol is an alternative way to set the prefix for Hyperliquid only.

Query Parameters

Parameter	Type	Required	Description
symbol	string	Yes	The trading pair symbol (e.g., BTC)
quote	string	No	Optional quote currency (e.g., USDT)
exchange	string	No	Optional CeFi exchanges, comma-separated (binance,bybit,deribit,okx,hyperliquid,gate,lighter,kucoin,mexc,bitget,kraken,coinbase)
protocol	string	No	Optional. Hyperliquid only. One of xyz, flx, vntl, hyna, km, cash. When set, used as symbol prefix (e.g. protocol=xyz → xyz:BTC). Default is normal (no protocol prefix).

Step-by-Step Tutorial and Video Walkthrough

• Check out the guide: Here

Usage Examples

1. REST

• Query by symbol with default exchange (all supported):

curl -X GET "https://demo-api.mobula.io/api/1/market/cefi/funding-rate?symbol=BTC"

-Query by symbol with specific exchange:

curl -X GET "https://demo-api.mobula.io/api/1/market/cefi/funding-rate?symbol=BTC&exchange=deribit"

• Query by symbol with mulitple exchange:

curl -X GET "https://demo-api.mobula.io/api/1/market/cefi/funding-rate?symbol=ETH&exchange=deribit,binance"

• Query by symbol with quote and multiple exchange:

curl -X GET "https://demo-api.mobula.io/api/1/market/cefi/funding-rate?exchange=deribit,binance&symbol=ETH&quote=USDC"

• Query Hyperliquid with protocol (e.g. xyz:BTC):

curl -X GET "https://demo-api.mobula.io/api/1/market/cefi/funding-rate?symbol=BTC&exchange=hyperliquid&protocol=xyz"

2. WebSocket Access

You can also access funding rates via WSS.
View more details →

• Endpoint: wss://api.mobula.io
• Payload example:

{
  "type": "funding",
  "authorization": "api-key",
  "payload": {
    "symbol": "BTC",
    "quote" : "USDT",
    "exchange": "deribit,binance,okx,lighter",
    "subscriptionTracking": "true"
  }
}

• With Hyperliquid protocol (e.g. cash:HOOD): add "protocol": "cash" in the payload when using exchange: "hyperliquid". Supported: xyz, flx, vntl, hyna, km, cash.

Query Parameters

symbol · string · required

quote · string

exchange · string

protocol · enum<string>

Available options: xyz, flx, vntl, hyna, km, cash

Response

200 - application/json

Funding rate response

queryDetails · object · required

Show child attributes

binanceFundingRate · object

Show child attributes

deribitFundingRate · object

Show child attributes

bybitFundingRate · object

Show child attributes

okxFundingRate · object

Show child attributes

hyperliquidFundingRate · object

object

object[]

Show child attributes

gateFundingRate · object

Show child attributes

kucoinFundingRate · object

Show child attributes

mexcFundingRate · object

Show child attributes

bitgetFundingRate · object

Show child attributes

krakenFundingRate · object

Show child attributes

coinbaseFundingRate · object

Show child attributes

lighterFundingRate · object

Show child attributes