Unified REST APIAccount

Get User Funding Fee History

Retrieve user funding fee payment history. Returns user-specific funding fee payments/receipts.

Platform Support: Available on hyperliquid, aster, lighter. Not available on kuru (spot DEX - no funding fees).

Implementation Notes:

  • If neither startTime nor endTime is provided, defaults to last 7 days
  • Funding fees are settled at regular intervals (typically every 8 hours)
  • Positive fundingFee indicates fee received (you are receiving funding)
  • Negative fundingFee indicates fee paid (you are paying funding)
  • Results are sorted by fundingTime in descending order (most recent first)
GET
/getUserFunding

Authorization

ApiKeyAuth
X-API-KEY<token>

In: header

Query Parameters

symbols?string

Unified symbols filter (comma-separated). If not provided, returns funding for all symbols.

startTime?integer

Millisecond timestamp (inclusive). Default is 7 days ago.

endTime?integer

Millisecond timestamp (inclusive). Default is current time.

Response Body

application/json

curl -X GET "https://api.hypereth.io/v2/hyperliquid/getUserFunding?symbols=BTC%2CETH&startTime=1709251200000&endTime=1709856000000"
{
  "fundings": [
    {
      "symbol": "BTC",
      "fundingFee": "-1.2345",
      "fundingAsset": "USDT",
      "fundingTime": 1710000000000,
      "positionSize": "0.50"
    },
    {
      "symbol": "ETH",
      "fundingFee": "0.8765",
      "fundingAsset": "USDT",
      "fundingTime": 1710003600000,
      "positionSize": "-1.25"
    }
  ],
  "total": 2,
  "dataTime": 1710011000000,
  "dexReceivedTimestamp": 1710010900000,
  "hyperethTimestamp": 1710011000000
}

Get Position GET

Get position information. **Platform Support**: Available on hyperliquid, aster, lighter. **Not available on kuru** (spot DEX - no positions).

Update Position Leverage POST

Update leverage for a specific trading symbol. **Platform Support**: Available on hyperliquid, aster, lighter. **Not available on kuru** (spot DEX - no leverage). **Implementation Notes**: - Leverage must be adjusted before opening positions or when no position exists - Some platforms restrict leverage changes when positions are open - Maximum allowed leverage varies by symbol and account tier - Leverage reduction may be restricted in isolated margin mode with open positions **Platform-Specific Limits**: - **Hyperliquid**: Asset and notional-dependent (varies by margin tiers; e.g., BTC up to 40x, ETH up to 25x) - **Aster**: 1-125 depending on position size and notional brackets, and it is unable to adjust to isolated-margin mode under the Multi-Assets mode. - **Lighter**: 1-100 (varies by market)