Get Funding History

API Description

Retrieves historical funding rate data for perpetual contracts. This endpoint provides funding rate information including long and short funding rates at different timestamps, which is crucial for understanding the cost of holding positions in perpetual futures.

HTTP Request

GET /v4/public/mm/funding/history

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
symbol	string	Yes	Trading pair symbol (e.g., BTC/USDC)
startTime	uint64	No	Start time in Unix timestamp (seconds)
endTime	uint64	No	End time in Unix timestamp (seconds)
limit	uint32	No	Number of records to retrieve (default: 200, max: 200)

Important: Use symbol (singular) as the parameter name. startTime, endTime, and limit are optional.

Response Parameters

Parameter	Type	Description
timestamp	uint64	Funding rate timestamp (Unix timestamp in seconds)
long	string	Long position funding rate
short	string	Short position funding rate

Request Example

Python (requests)

Note: This endpoint requires API authentication. See Quick Start Guide for signature generation details.

import hmac
import hashlib
import base64
import json
import requests
from datetime import datetime, timezone
from urllib.parse import urlencode

def generate_mm_signature(secret_key, timestamp, method, request_path, body="", content_type=""):
    """Generate API signature"""
    message = timestamp + method.upper() + request_path
    if body and method.upper() in ["POST", "PUT", "PATCH"]:
        if content_type and "application/json" in content_type.lower():
            data = json.loads(body)
            body = json.dumps(data, sort_keys=True, separators=(',', ':'))
        message += body
    
    mac = hmac.new(
        secret_key.encode('utf-8'),
        message.encode('utf-8'),
        hashlib.sha256
    )
    return base64.b64encode(mac.digest()).decode('utf-8')

# Generate timestamp
timestamp = datetime.now(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00', 'Z')

# Build request path with sorted query parameters
# Note: Use 'symbol' (singular) as the parameter name
params = {
    'chainId': 143,
    'symbol': 'BTC/USDC',  # Use 'symbol' (singular)
    'startTime': 1764603778,  # Optional
    'endTime': 1765726982,    # Optional
    'limit': 200              # Optional, default is 200
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/funding/history?{query_string}"

# Generate signature
signature = generate_mm_signature(secret_key, timestamp, "GET", request_path)

# Make request
headers = {
    "X-ACCESS-KEY": api_key,
    "X-ACCESS-SIGN": signature,
    "X-ACCESS-TIMESTAMP": timestamp,
    "X-ACCESS-PASSPHRASE": passphrase,
}

url = f"https://api.monday.trade/v4/public/mm/funding/history?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": [
        {
            "timestamp": 1764603778,
            "long": "0.0001",
            "short": "-0.0001"
        },
        {
            "timestamp": 1764607378,
            "long": "0.00015",
            "short": "-0.00015"
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}

Notes

• This endpoint requires API authentication (see Quick Start Guide)

• Important: Use symbol (singular) as the parameter name

• Only chainId and symbol are required; startTime, endTime, and limit are optional

• If limit is not provided, it defaults to 200

• startTime and endTime are in Unix timestamp format (seconds, not milliseconds)

• Maximum limit is 200

• Returns funding rates at 1-hour intervals

• long: Funding rate for long positions (positive means longs pay shorts)

• short: Funding rate for short positions (negative means shorts pay longs)

• timestamp: Unix timestamp in seconds when the funding rate was applied

• Funding rates are typically applied every 8 hours (00:00, 08:00, 16:00 UTC), but this endpoint returns hourly data

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)

Common Errors

"invalid request parameters"

• Ensure you're using symbol (singular) as the parameter name

• chainId and symbol are required; other parameters are optional

• startTime and endTime must be Unix timestamps in seconds (not milliseconds) if provided