Skip to main content
GET
/
1
/
market
/
cefi
/
funding-rate
Get funding rate
curl --request GET \
  --url https://demo-api.mobula.io/api/1/market/cefi/funding-rate
{
  "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
  }
}

​
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).
  • You can specify one or more exchanges by separating them with commas.
Note on Hyperliquid (DEX - HIP3):
Funding rates from Hyperliquid DEX are available exclusively for HIP3 instruments.
To retrieve them, prefix the symbol with dex: (e.g., dex:BTC).
For custom HIP3 perpetuals such as XYZ100, use the following format: 
symbol=dex:XYZ100
or in the WebSocket payload: 
"symbol": "dex:XYZ100"
This dex: prefix is required to access Hyperliquid DEX (HIP3) funding data and clearly distinguishes it from standard CeFi symbols.

​
Query Parameters

ParameterTypeRequiredDescription
symbolstringYesThe trading pair symbol (e.g., BTC)
quotestringNoOptional quote currency (e.g., USDT)
exchangestringNoOptional CeFi exchanges, comma-separated (binance,bybit,deribit,okx,hyperliquid)

​
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"

  1. ​
    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",
    "subscriptionTracking": "true"
  }
}

Query Parameters

​
symbol
string
required
​
quote
string
​
exchange
string

Response

200 - application/json

Funding rate response

​
queryDetails
object
required
​
binanceFundingRate
object
​
deribitFundingRate
object
​
bybitFundingRate
object
​
okxFundingRate
object
​
hyperliquidFundingRate
object
  • object
  • object[]