io.github.Br0ski777/hl-funding icon

Hyperliquid Funding Rates API

by Br0ski777

io.github.Br0ski777/hl-funding

HL perp funding rates for 229 markets. Sort, history, arb opportunities. x402.

Version 1.0.1
Developer Tools
Remote (SSE)
View source

Hyperliquid Funding Rates API · v1.0.1

by Br0ski777

46

Hyperliquid Funding Rates API

Real-time and historical funding rate data for all 229 Hyperliquid perpetual markets. Sort by rate, pull history, and find arbitrage opportunities -- all via a single x402-powered API.

What It Does / Endpoints

Endpoint Method Price Description
/api/rates POST $0.002 Current funding rates for all 229 perp markets, sorted by rate
/api/history POST $0.002 Historical funding rate data for a specific coin
/api/arb POST $0.003 Find funding rate arbitrage opportunities (extreme rates)

Example Request/Response

GET /

{
  "api": "Hyperliquid Funding Rates API",
  "status": "online",
  "protocol": "x402",
  "network": "base-mainnet"
}

POST /api/rates

Request:

{ "sort": "abs" }

Response:

{
  "totalMarkets": 229,
  "sort": "abs",
  "timestamp": "2026-04-13T12:00:00.000Z",
  "rates": [
    {
      "coin": "PEPE",
      "fundingRate": 0.0005,
      "annualizedRate": 54.75,
      "premium": 0.001,
      "openInterest": 85000000,
      "markPrice": 0.0000125
    },
    {
      "coin": "BTC",
      "fundingRate": 0.000125,
      "annualizedRate": 13.69,
      "premium": 0.0002,
      "openInterest": 1250000000,
      "markPrice": 68500.5
    }
  ]
}

POST /api/history

Request:

{ "coin": "ETH", "hours": 24 }

Response:

{
  "coin": "ETH",
  "hours": 24,
  "timestamp": "2026-04-13T12:00:00.000Z",
  "entries": [
    { "time": "2026-04-13T08:00:00.000Z", "fundingRate": 0.0001, "annualizedRate": 10.95 },
    { "time": "2026-04-13T00:00:00.000Z", "fundingRate": 0.00012, "annualizedRate": 13.14 },
    { "time": "2026-04-12T16:00:00.000Z", "fundingRate": 0.00008, "annualizedRate": 8.76 }
  ],
  "summary": {
    "count": 3,
    "avgRate": 0.0001,
    "avgAnnualized": 10.95,
    "minRate": 0.00008,
    "maxRate": 0.00012,
    "stdDev": 0.00001633
  }
}

POST /api/arb

Request:

{ "threshold": 0.0001 }

Response:

{
  "threshold": 0.0001,
  "totalOpportunities": 12,
  "longOpportunities": 5,
  "shortOpportunities": 7,
  "timestamp": "2026-04-13T12:00:00.000Z",
  "opportunities": [
    {
      "coin": "PEPE",
      "fundingRate": 0.0005,
      "annualizedRate": 54.75,
      "direction": "short opportunity",
      "openInterest": 85000000,
      "markPrice": 0.0000125,
      "premium": 0.001
    }
  ]
}

Use Cases

  • Carry Trade Analysis -- Find coins where you earn funding by taking the opposite side of crowded trades
  • Market Sentiment -- High positive funding = market is overly long; high negative = overly short
  • Delta-Neutral Strategies -- Combine spot + perp positions to harvest funding without directional risk
  • Backtesting -- Use historical funding data to validate funding-based trading strategies
  • Cross-Exchange Arb -- Compare Hyperliquid funding with CEX rates to find cross-venue opportunities

MCP Integration

Claude Desktop / Cursor

{
  "mcpServers": {
    "hl-funding": {
      "url": "https://PLACEHOLDER.up.railway.app/sse"
    }
  }
}

Payment

All endpoints are gated by x402 protocol. Agents pay automatically with USDC on Base L2 -- no API keys, no accounts, no subscriptions. Just send a request and the payment is settled in under 2 seconds.

Related APIs