Parameters
- typestringREQUIRED
Request type identifier specifying 'fundingHistory' as the info endpoint method to retrieve historical funding rate data for a perpetual market
- coinstringREQUIRED
Perpetual trading pair symbol to retrieve funding rate history for, using standard ticker format (e.g., 'BTC', 'ETH', 'SOL')
- startTimeintegerREQUIRED
The query start time as Unix timestamp in milliseconds. Only returns funding rates at or after this time
- endTimeinteger
The query end time as Unix timestamp in milliseconds. When specified, only returns funding rates at or before this time. Leave unset to include all rates up to the present
Returns
- arrayarray
Array of historical funding rate objects
- timeinteger
Unix timestamp in milliseconds when this funding rate was applied to positions. Funding payments typically occur every 8 hours on perpetual markets. Use for time-series analysis of funding rate trends
- coinstring
Perpetual trading pair symbol matching the requested coin parameter (e.g., 'BTC', 'ETH', 'SOL'). Confirms which market this funding rate applies to
- fundingRatestring
Historical funding rate applied at this timestamp, expressed as a decimal rate per funding period (e.g., '0.0001' for 0.01%). Positive rates mean longs paid shorts, negative rates mean shorts paid longs. Returned as string to preserve decimal precision
- premiumstring
Premium component of the funding rate, representing the perpetual price premium/discount relative to the spot index. Used in calculating the total funding rate along with interest rate components. Returned as string for decimal precision