Get Funding Rate Data

OpenAPI JSON Spec Feature Overview Get funding rate data for a specific trading pair with required time range filtering.

Main Use Cases

• Perpetual Futures Trading: Monitor funding rates for perpetual futures contracts
• Trading Strategy: Use funding rates as a market sentiment indicator
• Risk Management: Monitor funding costs for positions
• Technical Analysis: Analyze funding rate trends over time

Query Parameters & Logic

Required Parameters:

• symbol: Trading pair symbol (e.g., BTCUSDT)
• exchange: Exchange name (currently only supports binance)
• start_time: Start timestamp (Unix seconds) - required
• end_time: End timestamp (Unix seconds) - required, must be after start_time
• limit: Maximum number of results to return (1-1000, required)

Validation Rules:

• Symbol is required and must be a valid trading pair
• Exchange must be binance
• start_time must be before end_time
• Limit range: 1-1000, required

Response Data Structure

• data ([]FundingRateData): Array of funding rate data points
• count (int32): Actual number of data points returned
• latest_time (string): Timestamp of the most recent data point (Unix seconds as string)

FundingRateData fields:

• symbol (string): Trading pair symbol (e.g., “BTCUSDT”)
• funding_rate (string): Funding rate in string format
• timestamp (string): Unix timestamp in seconds as string (e.g., “1763978100”)

Usage Examples

1. Get funding rate data for specific time range: ?symbol=BTCUSDT&exchange=binance&start_time=1761502255&end_time=1764094255&limit=100
2. Get maximum data points: ?symbol=ETHUSDT&exchange=binance&start_time=1761502255&end_time=1764094255&limit=1000

Important Notes

• All parameters are required
• Results are ordered by timestamp in ascending order
• Funding rate represents the periodic payment between long and short positions
• Funding rates are settled by the exchange at fixed intervals (every 8 hours for Binance)
• No interval parameter needed as settlement times are predetermined by the exchange