Funding Stream

This endpoint is only available to Growth and Enterprise plans.

Endpoint Details

URL: wss://api.mobula.io
Event Type: funding

Subscription Format

Subscribe to funding rates for specific trading pairs:

{
  "type": "funding",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "symbol": "BTC",
    "quote": "USDT",
    "interval": 10,
      "exchange": "binance,bybit,hyperliquid,lighter",
      "subscriptionId": "funding-feed-1",
      "subscriptionTracking": true
  }
}

Parameters

symbol (required): Trading symbol (e.g., "BTC", "ETH").
quote (optional): Quote asset (e.g., "USDT", "USD"). Defaults depend on exchange pairs
exchange (optional): Comma-separated list of exchanges - binance, bybit, deribit, okx, hyperliquid, gate, lighter, kucoin, mexc, bitget, kraken, coinbase
protocol (optional): Hyperliquid only. One of xyz, flx, vntl, hyna, km, cash. When set, used as symbol prefix (e.g. protocol: "cash" with symbol: "HOOD" → cash:HOOD). Alternative to putting the prefix in the symbol (e.g. symbol: "cash:HOOD").
interval (optional): Refresh interval in seconds for updates
subscriptionId (optional): Unique identifier for your WebSocket connection. Auto-generated if not provided
subscriptionTracking (optional, default: false): Include subscription details in response logs for debugging

Supported Exchanges: Binance, Bybit, Deribit, OKX, Hyperliquid, Gate.io, Lighter, KuCoin, MEXC, Bitget, Kraken, Coinbase

Hyperliquid DEX (HIP3) Usage

Funding rates from Hyperliquid are available only for HIP3 perpetuals:

Symbol prefix: Use a colon in the symbol (e.g., "cash:HOOD", "dex:BTC", "xyz:XYZ100"), or
protocol parameter: Set protocol to one of xyz, flx, vntl, hyna, km, cash with the base symbol (e.g. symbol: "HOOD", protocol: "cash" → same as cash:HOOD).
Include exchange: "hyperliquid" in the payload.

Example (symbol prefix):

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

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

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

{
  "type": "funding",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "symbol": "dex:XYZ100",
    "exchange": "hyperliquid",
    "subscriptionTracking": true
  }
}

Example (protocol parameter):

{
  "type": "funding",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "symbol": "HOOD",
    "exchange": "hyperliquid",
    "protocol": "cash",
    "subscriptionTracking": true
  }
}

Response Format

Each funding rate update includes data from all requested exchanges:

{
  "queryDetails": {
    "base": "BTC",
    "quote": "USDT"
  },
  "subscriptionId": "funding-feed-1",
  "timestamp": 1756194263149,
  "sequence": 1,
  "binanceFundingRate": {
    "symbol": "BTCUSDT",
    "fundingTime": 1756166400000,
    "fundingRate": 0.00004522,
    "marketPrice": "110064.58160507",
    "epochDurationMs": 28800000,
    "fundingRateCap": 0.3,
    "fundingRateFloor": -0.3
  },
  "bybitFundingRate": {
    "symbol": "BTCUSDT",
    "fundingTime": 1756166400000,
    "fundingRate": 0.0001,
    "epochDurationMs": 28800000
  },
  "hyperliquidFundingRate": {
    "symbol": "BTC",
    "fundingTime": 1756188000000,
    "fundingRate": 0.0000125,
    "marketPrice": 110301,
    "epochDurationMs": 3600000
  },
  "okxFundingRate": {
    "symbol": "BTC-USDT-SWAP",
    "fundingTime": 1756195200000,
    "fundingRate": 0.0001,
    "epochDurationMs": 28800000
  },
  "gateFundingRate": {
    "symbol": "BTC_USDT",
    "fundingTime": 1756166400000,
    "fundingRate": 0.0001,
    "epochDurationMs": 28800000
  },
  "lighterFundingRate": {
    "symbol": "BTC",
    "fundingTime": 1756188000000,
    "fundingRate": 0.000096,
    "epochDurationMs": 3600000
  }
}

Implementation Example

const socket = new WebSocket("wss://api.mobula.io");

socket.addEventListener("open", () => {
  socket.send(JSON.stringify({
    type: "funding",
    authorization: "YOUR_API_KEY",
    payload: {
      symbol: "BTC",
      quote: "USDT",
      interval: 10,
      exchange: "binance,bybit,hyperliquid,lighter",
      subscriptionTracking: true
    }
  }));
});

socket.addEventListener("message", (event) => {
  const data = JSON.parse(event.data);
  
  // Process funding rate updates
  if (data.binanceFundingRate) {
    console.log(`Binance Funding Rate: ${data.binanceFundingRate.fundingRate}`);
  }
  
  if (data.hyperliquidFundingRate) {
    console.log(`Hyperliquid Funding Rate: ${data.hyperliquidFundingRate.fundingRate}`);
  }
  
  if (data.lighterFundingRate) {
    console.log(`Lighter Funding Rate: ${data.lighterFundingRate.fundingRate}`);
  }
});

socket.addEventListener("error", (error) => {
  console.error("WebSocket error:", error);
});

socket.addEventListener("close", () => {
  console.log("WebSocket connection closed");
});

You can use the Network tab in your browser to see the WebSocket requests and responses in real-time.

Connection Keepalive (Ping/Pong)

To maintain active WebSocket connections and prevent timeouts, you can use the ping/pong mechanism: Send ping:

{"event":"ping"}

Receive pong: The server will respond with a pong message to confirm the connection is active.

Use ping messages periodically (every 30-60 seconds) to keep long-lived connections alive.

Unsubscribing from the Stream

Unsubscribe from All Streams

To terminate all active subscriptions on the current WebSocket connection:

{
  "type": "unsubscribe",
  "authorization": "YOUR_API_KEY",
  "payload": {}
}

Unsubscribe from Specific Subscription

To unsubscribe from a specific subscription using its ID:

{
  "type": "unsubscribe",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "subscriptionId": "your-subscription-id"
  }
}

Unsubscribe from All Funding Streams

To unsubscribe from all funding streams while keeping other stream types active:

{
  "type": "unsubscribe",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "type": "funding"
  }
}

If you didn’t provide a subscriptionId when subscribing, one is auto-generated. To retrieve it, set "subscriptionTracking": true in the subscription payload.

Introduction

Market & Token Data

Trades & OHLCV

Pulse Streams

Filter Tokens

Multi-Events & Raw Data

Data Models

Holders & Positions

Perps Streams

Webhooks

Misc

Endpoint Details

Subscription Format

Parameters

Hyperliquid DEX (HIP3) Usage

Response Format

Implementation Example

Connection Keepalive (Ping/Pong)

Unsubscribing from the Stream

Unsubscribe from All Streams

Unsubscribe from Specific Subscription

Unsubscribe from All Funding Streams

Support

Support

Support

Need help?

​Endpoint Details

​Subscription Format

​Parameters

​Hyperliquid DEX (HIP3) Usage

​Response Format

​Implementation Example

​Connection Keepalive (Ping/Pong)

​Unsubscribing from the Stream

​Unsubscribe from All Streams

​Unsubscribe from Specific Subscription

​Unsubscribe from All Funding Streams

​Support

Support

Support

Need help?

Endpoint Details

Subscription Format

Parameters

Hyperliquid DEX (HIP3) Usage

Response Format

Implementation Example

Connection Keepalive (Ping/Pong)

Unsubscribing from the Stream

Unsubscribe from All Streams

Unsubscribe from Specific Subscription

Unsubscribe from All Funding Streams

Support