Skip to content

Funding Rate

Historical and latest funding rates for perpetual futures.

Usage

from datamaxi import Datamaxi

maxi = Datamaxi(api_key="YOUR_API_KEY")

exchanges = maxi.funding_rate.exchanges()
symbols = maxi.funding_rate.symbols(exchange="binance")

history, next_request = maxi.funding_rate.history(
    exchange="binance",
    symbol="BTC-USDT",
    page=1,
    limit=100,
    sort="desc",
)

latest = maxi.funding_rate.latest(exchange="binance", symbol="BTC-USDT")

Notes

  • Pagination returns a next_request function for the next page.
  • Set pandas=False to return the raw dict response.

Bases: API

Client to fetch funding rate data from DataMaxi+ API.

Parameters:

  • api_key (str, default: None ) –

    The DataMaxi+ API key

  • **kwargs (Any, default: {} ) –

    Keyword arguments used by datamaxi.api.API.

history 

history(
    exchange: str,
    symbol: str,
    page: int = 1,
    limit: int = 1000,
    fromDateTime: str = None,
    toDateTime: str = None,
    sort: str = DESC,
    pandas: bool = True,
) -> Union[
    Tuple[Dict, Callable], Tuple[pd.DataFrame, Callable]
]

Fetch historical funding rate data

GET /api/v1/funding-rate/history

https://docs.datamaxiplus.com/rest/cex/funding-rate/historical-funding-rate

Parameters:

  • exchange (str) –

    Exchange name

  • symbol (str) –

    Symbol name

  • page (int, default: 1 ) –

    Page number

  • limit (int, default: 1000 ) –

    Limit of data

  • fromDateTime (str, default: None ) –

    Start date and time (accepts format "2006-01-02 15:04:05" or "2006-01-02")

  • toDateTime (str, default: None ) –

    End date and time (accepts format "2006-01-02 15:04:05" or "2006-01-02")

  • sort (str, default: DESC ) –

    Sort order

  • pandas (bool, default: True ) –

    Return data as pandas DataFrame

Returns:

  • Union[Tuple[Dict, Callable], Tuple[DataFrame, Callable]] –

    Historical funding rate data in pandas DataFrame and next request function

latest 

latest(
    exchange: str = None,
    symbol: str = None,
    sort: str = None,
    limit: int = None,
    pandas: bool = True,
) -> Union[Dict, pd.DataFrame]

Fetch latest funding rate data

GET /api/v1/funding-rate/latest

https://docs.datamaxiplus.com/rest/cex/funding-rate/latest-funding-rate

Parameters:

  • exchange (str, default: None ) –

    exchange name

  • symbol (str, default: None ) –

    Symbol name

  • sort (str, default: None ) –

    Sort data by asc or desc

  • limit (int, default: None ) –

    Limit number of data to return

  • pandas (bool, default: True ) –

    Return data as pandas DataFrame

Returns:

  • Union[Dict, DataFrame] –

    Latest funding rate data in pandas DataFrame or dict response

exchanges 

exchanges() -> List[str]

Fetch supported exchanges for funding rate endpoints.

GET /api/v1/funding-rate/exchanges

https://docs.datamaxiplus.com/rest/cex/funding-rate/exchanges

Returns:

  • List[str] –

    List of supported exchanges

symbols 

symbols(exchange: str) -> List[str]

Fetch supported symbols for funding rate endpoints.

GET /api/v1/funding-rate/symbols

https://docs.datamaxiplus.com/rest/cex/funding-rate/symbols

Parameters:

  • exchange (str) –

    Exchange name

Returns:

  • List[str] –

    List of supported symbols