Market Data API

Public endpoints for market information, prices, OHLCV, and orderbooks

Public endpoints for market information. No authentication required beyond the API key header.

---

GET /dexes

List available perpetual DEX platforms.

GET /v1/perps/dexes

Parameters

Name	In	Type	Required	Description
x-lifi-api-key	header	string	Yes	API key
x-lifi-integrator	header	string	No	Integrator identifier

Response 200

{
  "dexes": [
    {
      "key": "hyperliquid",
      "name": "Hyperliquid",
      "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/dexes/hyperliquid.svg",
      "authorizations": [
        {
          "key": "ApproveAgent",
          "name": "Approve Agent",
          "params": [
            { "name": "agentAddress", "type": "string", "required": true }
          ]
        },
        {
          "key": "ApproveBuilderFee",
          "name": "Approve Builder Fee",
          "params": []
        }
      ],
      "wsUrl": "wss://api.hyperliquid.xyz/ws",
      "extraData": {}
    }
  ]
}

The wsUrl and extraData fields are optional — they may be absent for DEXes that don’t support WebSocket streaming or have no extra configuration.

SDK: getDexes()

---

GET /markets

List all perpetual markets for a DEX.

GET /v1/perps/markets?dex=hyperliquid

Parameters

Name	In	Type	Required	Description
dex	query	string	Yes	DEX identifier
x-lifi-api-key	header	string	Yes	API key
x-lifi-integrator	header	string	No	Integrator identifier

Response 200

{
  "markets": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "logoURI": "https://static.debank.com/image/token/logo_url/btc/d3c8b30d5b8f7c0e82e87e1c8f4e5c5a.png",
      "dex": "hyperliquid",
      "szDecimals": 5,
      "maxLeverage": 50,
      "onlyIsolated": false,
      "funding": {
        "rate": "0.0001",
        "nextFundingTime": 1704110400000
      },
      "openInterest": "1250000000",
      "volume24h": "5000000000",
      "assetId": 0,
      "markPrice": "95000.50"
    }
  ]
}

SDK: getMarkets()

---

GET /markets/

Get details for a single market.

GET /v1/perps/markets/BTC?dex=hyperliquid

Parameters

Name	In	Type	Required	Description
symbol	path	string	Yes	Market symbol (e.g., BTC)
dex	query	string	Yes	DEX identifier
x-lifi-api-key	header	string	Yes	API key
x-lifi-integrator	header	string	No	Integrator identifier

Response 200

Returns a single Market object (same shape as items in the /markets response).

{
  "symbol": "BTC",
  "name": "Bitcoin",
  "logoURI": "https://static.debank.com/image/token/logo_url/btc/d3c8b30d5b8f7c0e82e87e1c8f4e5c5a.png",
  "dex": "hyperliquid",
  "szDecimals": 5,
  "maxLeverage": 50,
  "onlyIsolated": false,
  "funding": {
    "rate": "0.0001",
    "nextFundingTime": 1704110400000
  },
  "openInterest": "1250000000",
  "volume24h": "5000000000",
  "assetId": 0,
  "markPrice": "95000.50"
}

Response 404

Market not found error.

SDK: getMarket()

---

GET /prices

Get current mid prices for all markets. Lightweight endpoint for frequent polling.

GET /v1/perps/prices?dex=hyperliquid

Parameters

Name	In	Type	Required	Description
dex	query	string	Yes	DEX identifier
symbols	query	string	No	Comma-separated list of symbols to filter (e.g., BTC,ETH)
x-lifi-api-key	header	string	Yes	API key
x-lifi-integrator	header	string	No	Integrator identifier

Response 200

{
  "prices": {
    "BTC": "95000.50",
    "ETH": "3200.25",
    "SOL": "185.75"
  }
}

SDK: getPrices()

---

GET /ohlcv/

Get OHLCV candle data for charts.

GET /v1/perps/ohlcv/BTC?dex=hyperliquid&interval=1h&limit=100

Parameters

Name	In	Type	Required	Description
symbol	path	string	Yes	Market symbol
dex	query	string	Yes	DEX identifier
interval	query	string	Yes	Candle interval: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M
startTime	query	integer	No	Start timestamp (ms)
endTime	query	integer	No	End timestamp (ms)
limit	query	integer	No	Max candles (default 100, max 1000)
x-lifi-api-key	header	string	Yes	API key
x-lifi-integrator	header	string	No	Integrator identifier

Response 200

{
  "dex": "hyperliquid",
  "symbol": "BTC",
  "interval": "1h",
  "candles": [
    {
      "t": 1704067200000,
      "o": "94500.00",
      "h": "95200.00",
      "l": "94300.00",
      "c": "95000.50",
      "v": "125000000"
    }
  ]
}

Response 404

Market not found error.

SDK: getOhlcv()

---

GET /orderbook/

Get current orderbook snapshot.

GET /v1/perps/orderbook/BTC?dex=hyperliquid&depth=20

Parameters

Name	In	Type	Required	Description
symbol	path	string	Yes	Market symbol
dex	query	string	Yes	DEX identifier
depth	query	integer	No	Price levels (default 20, max 100)
x-lifi-api-key	header	string	Yes	API key
x-lifi-integrator	header	string	No	Integrator identifier

Response 200

{
  "dex": "hyperliquid",
  "symbol": "BTC",
  "bids": [
    { "price": "94999.00", "size": "1.5" },
    { "price": "94998.00", "size": "2.3" }
  ],
  "asks": [
    { "price": "95001.00", "size": "0.8" },
    { "price": "95002.00", "size": "1.2" }
  ],
  "timestamp": 1704067200000
}

Response 404

Market not found error.

SDK: getOrderbook()