Funding Rates

The funding rates API is publicly available and provides data for all perpetual future funding rates at the exchange.

Funding Rate Overview

Perpetual futures at Bitnomial use a funding rate mechanism to keep the contract price anchored to the underlying spot price. Funding rates are calculated and applied at 8-hour intervals (00:00, 08:00, and 16:00 UTC). A positive funding rate means long position holders pay short position holders, while a negative rate means shorts pay longs.

For more details on how funding rates are calculated, see Digital Asset Perpetual Pricing.

Funding Rate API Endpoints

Get All Funding Rates

Returns a paginated list of historical funding rate data for perpetual products.

Query Parameters

Important: Without begin_time, the API returns only the most recent funding rate(s). To retrieve historical funding rates, you must specify a begin_time parameter.

More details on paginated APIs can be found in Pagination.

Example Requests

Get the most recent funding rate:

GET /exchange/api/v1/prod/funding-rates/?base_symbol=PBUC

Get historical funding rates (last 30 days):

GET /exchange/api/v1/prod/funding-rates/?base_symbol=PBUC&begin_time=2025-11-16T00:00:00Z&limit=100&order=desc

Response

Returns a pagination response of the type Pagination<FundingRateData[], CursorInfo>.

export interface FundingRateData {
  product_id: number;
  price_index: number;
  mark_price: number;
  interest_rate: number;
  funding_rate: number;
  interval_start: string;
  interval_end: string;
}

Example Response

{
  "data": [
    {
      "product_id": 123,
      "price_index": 101234.56,
      "mark_price": 101250.00,
      "interest_rate": 0.0001,
      "funding_rate": 0.000125,
      "interval_start": "2025-12-12T00:00:00Z",
      "interval_end": "2025-12-12T08:00:00Z"
    }
  ],
  "pagination": {
    "cursor": "eyJsYXN0X2lkIjoxMjM0NX0="
  }
}

Response Fields

Get Estimated Funding Rate

Returns the estimated funding rate for the current (in-progress) interval, where :base_symbol is the base symbol for a given perpetual product. This estimate is continuously updated based on current market conditions and will be finalized at the end of the funding interval.

Example Request

GET /exchange/api/v1/prod/funding-rates/estimated/PBUC

Response

export interface EstimatedFundingRateData {
  funding_rate: number;
  interval_start: string;
  interval_end: string;
}

Example Response

{
  "funding_rate": 0.000089,
  "interval_start": "2025-12-12T08:00:00Z",
  "interval_end": "2025-12-12T16:00:00Z"
}

Notes

• Data Availability: For newly launched perpetual products, funding rate history will only be available from the product's launch date. The first funding rate is recorded at the end of the first complete 8-hour interval after launch.
• Interval Timing: Funding intervals are fixed at 8-hour periods aligned to UTC: 00:00-08:00, 08:00-16:00, and 16:00-00:00.
• Rate Interpretation: Funding rates are expressed as decimals. A rate of 0.0001 equals 0.01% (1 basis point). Annualized rates can be calculated as: funding_rate * 3 * 365.