API Documentation

Authorization: Bearer ih_your_api_key_here

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709248060

{
  "success": true,
  "data": [ ... ],
  "meta": { "timestamp": 1709248000, ... }
}

{
  "success": false,
  "error": "Human-readable error message"
}

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "exchange": "Binance",
      "rate": 0.0100,
      "rate8h": 0.0100,
      "predictedRate": 0.0085,
      "markPrice": 95000.50,
      "indexPrice": 94980.25,
      "fundingInterval": "8h",
      "nextFundingTime": 1709251200000,
      "type": "cex",
      "assetClass": "crypto"
    }
  ],
  "meta": { "timestamp": 1709248000, "exchanges": 24, "pairs": 6466 }
}

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "exchange": "Binance",
      "openInterest": 4200000000,
      "openInterestUsd": 4200000000,
      "timestamp": 1713181800000
    }
  ],
  "meta": { "timestamp": 1713181800000, "entries": 420, "exchanges": 26 }
}

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "exchange": "Binance",
      "lastPrice": 84250.50,
      "high24h": 85100.00,
      "low24h": 83200.00,
      "volume24h": 12500000000,
      "priceChange24hPct": 1.25
    }
  ]
}

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "spreadPct": 0.0312,
      "spreadUsd": 26.30,
      "highExchange": "Bitfinex",
      "highPrice": 84276.30,
      "lowExchange": "Binance",
      "lowPrice": 84250.00,
      "exchangeCount": 18
    }
  ]
}

{
  "success": true,
  "data": [
    {
      "symbol": "PONKE",
      "shortExchange": "Kraken",
      "longExchange": "Bitunix",
      "shortRate8h": 0.5032,
      "longRate8h": 0.0000,
      "grossSpread8h": 0.5032,
      "netSpread8h": 0.2832,
      "annualizedPct": 310.1,
      "dailyPnlPer10k": 8.50,
      "fees": { "roundTrip": 0.2200 },
      "oi": {
        "short": 500000,
        "long": 120000,
        "total": 620000,
        "minSide": 120000
      },
      "grade": "C",
      "stability": "volatile",
      "exchangeCount": 5,
      "allExchanges": [
        { "exchange": "Kraken", "rate8h": 0.5032, "type": "cex" }
      ]
    }
  ],
  "meta": {
    "totalPairs": 657,
    "filtered": 50,
    "grades": { "A": 0, "B": 1, "C": 120, "D": 536 }
  }
}

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "period": "1h",
    "source": "global",
    "longRatio": 52.34,
    "shortRatio": 47.66,
    "exchange": "binance",
    "history": [
      { "longRatio": 52.1, "shortRatio": 47.9, "longShortRatio": 1.088, "timestamp": 1709244000 },
      { "longRatio": 52.34, "shortRatio": 47.66, "longShortRatio": 1.098, "timestamp": 1709247600 }
    ]
  }
}

{
  "success": true,
  "data": [
    {
      "symbol": "ETH",
      "exchange": "binance",
      "side": "long",
      "quantity": 12.5,
      "price": 3245.80,
      "valueUsd": 40572.50,
      "timestamp": 1713181800000
    }
  ],
  "meta": { "timestamp": 1713181800000, "hours": 1, "entries": 1, "limit": 100 }
}

{
  "success": true,
  "data": {
    "currency": "BTC",
    "underlyingPrice": 84250,
    "maxPain": 85000,
    "putCallRatio": 0.72,
    "totalCallOI": 7200000000,
    "totalPutOI": 5300000000,
    "totalOI": 12500000000,
    "instrumentCount": 4500,
    "ivAtm": 48.5,
    "exchanges": [
      { "exchange": "Deribit", "callOI": 5100000000, "putOI": 3800000000, "totalOI": 8900000000, "share": 71.2 }
    ],
    "expirations": [
      { "date": "2026-04-25", "callOI": 450000000, "putOI": 320000000, "totalOI": 770000000, "maxPain": 84000 }
    ]
  }
}

{
  "success": true,
  "data": {
    "gainers": [
      { "symbol": "PEPE", "price": 0.0000089, "change24h": 24.5 }
    ],
    "losers": [
      { "symbol": "DOGE", "price": 0.162, "change24h": -8.2 }
    ]
  }
}

{
  "success": true,
  "data": {
    "altcoinSeasonIndex": 38,
    "btcDominance": 57.2,
    "ethDominance": 8.1,
    "totalMarketCap": 2850000000000,
    "totalMarketCapChange24h": -1.2,
    "totalVolume24h": 98000000000,
    "totalDerivativesOI": 55000000000,
    "activeCryptocurrencies": 10200
  }
}

{
  "success": true,
  "data": {
    "value": 72,
    "label": "Greed",
    "timestamp": 1709248000,
    "history": [
      { "value": 68, "label": "Greed", "timestamp": 1709161600 }
    ]
  }
}

{
  "success": true,
  "data": {
    "BTC": [
      { "day": "2026-04-13", "rate": 0.0082 },
      { "day": "2026-04-14", "rate": 0.0100 }
    ],
    "ETH": [
      { "day": "2026-04-13", "rate": 0.0045 },
      { "day": "2026-04-14", "rate": 0.0061 }
    ]
  },
  "meta": { "timestamp": 1713181800000, "symbols": 2, "days": 7 }
}

{
  "success": true,
  "data": [
    {
      "name": "Binance",
      "type": "cex",
      "fees": { "takerPct": 0.05, "makerPct": 0.02, "roundTripPct": 0.10 },
      "fundingInterval": "8h",
      "tradeUrlPattern": "https://www.binance.com/en/futures/{SYMBOL}USDT"
    }
  ],
  "meta": { "total": 33, "cex": 18, "dex": 15, "timestamp": 1713181800000 }
}

{
  "success": true,
  "status": "operational",
  "version": "v1",
  "endpoints": [
    { "path": "/api/v1/funding", "method": "GET", "description": "Real-time funding rates across 33 exchanges" }
  ],
  "tiers": {
    "free": { "rateLimit": "100 req/min", "dailyLimit": "5,000 req/day" },
    "pro": { "rateLimit": "500 req/min", "dailyLimit": "unlimited" }
  },
  "documentation": "https://info-hub.io/developers/docs",
  "timestamp": 1713181800000
}

{
  "success": false,
  "error": "Rate limit exceeded. Upgrade to Pro for higher limits."
}