Unified REST APIAccount

Update Position Leverage

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)
POST
/updateLeverage

Authorization

ApiKeyAuth
X-API-KEY<token>

In: header

Request Body

application/json

symbol*stringrequired

Unified market symbol

Example: BTC
leverage*numberrequired

Target leverage value. Valid range depends on platform and position size (typically 1-125).

Example: 10
marginType*enum<string>required

Margin type (cross or isolated)

Available options: crossisolated

Response Body

application/json

curl -X POST "https://api.hypereth.io/v2/hyperliquid/updateLeverage" \  -H "Content-Type: application/json" \  -d '{    "symbol": "BTC",    "leverage": 10,    "marginType": "cross"  }'
{
  "symbol": "BTC",
  "leverage": "10",
  "marginType": "cross",
  "maxNotional": "1000000",
  "dexReceivedTimestamp": 1710010900000,
  "hyperethTimestamp": 1710011000000
}

Get User Funding Fee History GET

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)

Submit Maker-Taker Arbitrage Strategy POST

Submit a maker-taker arbitrage strategy that places a maker order on one exchange and triggers a taker order on another exchange when conditions are met. **How it works**: 1. Places a maker (limit) order on the maker exchange with GTX (post-only) 2. When the maker order is placed, monitors for trigger conditions 3. When triggered, executes a taker order on the taker exchange 4. Optionally reconciles positions if there's a discrepancy **Use Cases**: - Cross-exchange arbitrage - Market making with hedging - Spread capture strategies **Endpoint**: `POST https://api.hypereth.io/v2/all/strategy/submit/maker-taker-arbitrage`