> ## Documentation Index > Fetch the complete documentation index at: https://public-perps-docs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Market Data & Providers > Public endpoints for provider discovery, market information, prices, OHLCV, and orderbooks Public endpoints for market information. No authentication required beyond the API key header. *** ## GET /providers List available perpetual provider platforms. ``` GET /v1/perps/providers ``` ### 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` ```json theme={null} { "providers": [ { "key": "hyperliquid", "name": "Hyperliquid", "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/dexes/hyperliquid.svg", "signingMethod": "eip712", "active": true, "funding": { "ratePeriodSeconds": 3600, "payoutCadenceSeconds": 3600 }, "minDepositUsd": 5, "setup": [ { "type": "approveAgent", "signers": ["USER"], "signingMethod": "eip712", "title": "Allow One-Click Trading", "description": "Authorise a session signer so LI.FI can place orders on your behalf without prompting your wallet for every trade.", "params": [] }, { "type": "setReferrer", "signers": ["SDK"], "signingMethod": "eip712", "title": "Initialize account via LI.FI", "description": "Enable the LI.FI referral code to enable 4% off your fees for your first $25M of volume on Hyperliquid.", "params": [] }, { "type": "approveBuilderFee", "signers": ["USER"], "signingMethod": "eip712", "title": "Approve Builder Fee", "description": "Authorise the per-trade builder fee that funds LI.FI infrastructure on Hyperliquid.", "params": [] } ], "options": [ { "type": "accountMode", "signers": ["USER"], "signingMethod": "eip712", "title": "Account Mode", "description": "Choose how this account interacts with Hyperliquid. Unified Account uses a single spot balance for all margin assets.", "params": [ { "name": "mode", "type": "string", "values": [ { "value": "disabled", "label": "Disabled" }, { "value": "unifiedAccount", "label": "Unified Account" }, { "value": "portfolioMargin", "label": "Portfolio Margin" } ], "default": { "value": "unifiedAccount", "label": "Unified Account" } } ] } ], "actions": [ { "type": "placeOrder", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "placeTriggerOrder", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "placeTwapOrder", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "cancelOrder", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "cancelTwapOrder", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "modifyOrder", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "updateLeverage", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "updatePositionMargin", "signers": ["SDK"], "signingMethod": "eip712" }, { "type": "withdrawal", "signers": ["USER"], "signingMethod": "eip712" }, { "type": "sendAsset", "signers": ["USER"], "signingMethod": "eip712" } ], "categories": [ { "id": "hyperliquid", "quoteAsset": { "providerId": "hyperliquid", "id": "USDC", "displaySymbol": "USDC", "logoURI": "https://assets.li.fi/tokens/usdc.png" } }, { "id": "xyz", "quoteAsset": null }, { "id": "spot", "quoteAsset": null } ], "wsUrl": "wss://api.hyperliquid.xyz/ws" } ] } ``` ### Provider Fields | Field | Type | Description | | ------------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `key` | `string` | Provider identifier (e.g. `"hyperliquid"`, `"lighter"`) | | `name` | `string` | Human-readable name | | `logoURI` | `string` | URL to provider logo | | `signingMethod` | `string` | Default signing method for the provider (e.g. `"eip712"`, `"wasmBlob"`, `"evmTx"`, `"hmac"`, `"siwe"`, `"session"`) | | `active` | `boolean` | When `false`, the provider is announced but not yet selectable in clients. Gates whether the widget surfaces the provider for trading. | | `setup` | `ProviderAction[]` | Mandatory account-setup descriptors. The user MUST satisfy every entry before trading. An empty array means the provider has no setup gates. | | `options` | `ProviderAction[]` | Optional post-setup descriptors the user MAY tune (account mode, fee tier, etc.). Never gate trading. An empty array is valid. | | `actions` | `ProviderAction[]` | Trading and transfer actions advertised by the provider. | | `categories` | `ProviderCategory[]` | Trading categories within the provider. | | `wsUrl` | `string?` | WebSocket URL for streaming. Optional — absent for providers without WebSocket support. | | `funding` | `ProviderFunding?` | Provider-wide `{ ratePeriodSeconds, payoutCadenceSeconds }` cadence metadata. Both values are seconds. | | `minDepositUsd` | `number?` | Minimum deposit amount in USD that the provider's deposit path will accept. Absent means no minimum is advertised. | | `minOrderValueUsd` | `number?` | Minimum order notional value in USD. Absent means no minimum is advertised. | | `minReduceOrderValueUsd` | `number?` | Minimum order notional value in USD for reduce-only orders, when the provider applies a lower floor than `minOrderValueUsd`. Absent means reduce-only orders use the same floor. | | `chainId` | `number?` | Settlement chain id for the provider's deposit/withdrawal path. Absent when not applicable. | | `minWithdrawalUsd` | `number?` | Minimum withdrawal amount in USD the provider will accept. Absent means no minimum is advertised. | | `depositFeeUsd` | `number?` | Flat deposit fee in USD, when the provider charges one. | | `withdrawalFeeUsd` | `number?` | Flat withdrawal fee in USD, when the provider charges one. | | `supportedIntervals` | `OhlcvInterval[]` | OHLCV candle intervals the provider supports (e.g. `1m`, `1h`, `1d`). | | `upVotes` | `number?` | Community up-vote count for the provider. | | `downVotes` | `number?` | Community down-vote count for the provider. | Each `ProviderCategory` in `categories` describes a trading category within the provider: | Field | Type | Description | | ------------- | --------------- | -------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | Category identifier (used as `categoryId` in `MarketRef` / `MarketDisplay`, e.g. `"hyperliquid"`, `"xyz"`, `"spot"`) | | `logoURI` | `string?` | Category logo URL (optional) | | `quoteAsset` | `Asset \| null` | Quote `Asset` for this category; `null` for the `spot` category, which has no single fixed quote | | `tradeNotice` | `TradeNotice?` | Optional provider advisory shown against markets in this category | The same `ProviderAction` shape backs `setup`, `options`, and `actions`. Entries in `setup` and `options` additionally carry UI metadata (`title`, `description`) and a `params` array. Each `params[]` entry describes one input the widget collects before dispatching the action — its `values` array enumerates the legal `value` strings the action accepts, which is the source of truth for things like the `mode` values on `accountMode` and the `tier` values on `accountType`. **SDK:** [`getProviders()`](/sdk/providers#getproviders) *** ## GET /markets List the tradeable markets (instruments) for a provider. Returns **static instrument metadata only** — ids, base/quote assets, decimals, leverage caps, and margin. Live per-market data (mark price, previous-day price, 24h volume, open interest, funding) is served by [`/marketsContext`](#get-marketscontext). Cached for one hour, since instrument metadata changes rarely. ``` GET /v1/perps/markets?provider=hyperliquid ``` ### Parameters | Name | In | Type | Required | Description | | ------------------- | ------ | -------- | -------- | -------------------------------------------------------------------------------------------------------------- | | `provider` | query | `string` | Yes | Provider identifier | | `marketIds` | query | `string` | No | Comma-separated list of provider market ids to filter (e.g., `BTC,ETH`). If omitted, every market is returned. | | `x-lifi-api-key` | header | `string` | Yes | API key | | `x-lifi-integrator` | header | `string` | No | Integrator identifier | ### Response `200` ```json theme={null} { "markets": [ { "providerId": "hyperliquid", "id": "BTC", "categoryId": "hyperliquid", "baseAsset": { "providerId": "hyperliquid", "id": "BTC", "displaySymbol": "BTC", "displayName": "Bitcoin", "logoURI": "https://assets.li.fi/tokens/btc.png" }, "quoteAsset": { "providerId": "hyperliquid", "id": "USDC", "displaySymbol": "USDC", "logoURI": "https://assets.li.fi/tokens/usdc.png" }, "szDecimals": 5, "priceIncrement": "0.1", "sizeIncrement": "0.00001", "isDelisted": false, "maxLeverage": 50, "onlyIsolated": false, "positionMarginAdjustment": "ADD_AND_REMOVE", "maintenanceMarginRate": 0.01 } ] } ``` Each `Market` carries static metadata only — live data lives on [`MarketContext`](#get-marketscontext): | Field | Type | Description | | -------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `providerId` | `string` | Provider that owns the market (e.g., `"hyperliquid"`) | | `id` | `string` | Provider's canonical, stringified market id that uniquely identifies the trading instrument (e.g., `"BTC"`, `"xyz:PURR"`, `"@142"`; numeric on Lighter) | | `categoryId` | `string` | References a `ProviderCategory` by id (e.g., `"hyperliquid"`, `"xyz"`, `"spot"`) | | `baseAsset` | `Asset` | Base leg of the market (see [`/assets`](#get-assets)) | | `quoteAsset` | `Asset` | Quote leg of the market | | `szDecimals` | `number` | Maximum fractional precision for sizes | | `priceDecimals` | `number?` | Maximum decimal places for prices, when published | | `priceIncrement` | `string?` | Exact price tick when decimal places alone cannot describe the grid | | `sizeIncrement` | `string?` | Exact size lot when decimal places alone cannot describe the grid | | `isDelisted` | `boolean?` | `true` when the venue has delisted the market | | `maxLeverage` | `number?` | Maximum allowed leverage (perps markets only) | | `onlyIsolated` | `boolean?` | Whether only isolated margin is supported (perps markets only) | | `positionMarginAdjustment` | `'NONE' \| 'ADD_ONLY' \| 'ADD_AND_REMOVE'` | Per-market individual margin capability (perps only) | | `maintenanceMarginRate` | `number?` | Venue maintenance-margin rate as a fraction (perps only) | **SDK:** [`getMarkets()`](/sdk/assets) *** ## GET /assets List the underlying asset registry for a provider. An asset is a transferable balance unit (Lighter's `asset_id` namespace), not a tradable market — markets reference assets as their base/quote legs. Providers whose ledger deltas already carry the asset symbol inline (Hyperliquid) return an empty array. ``` GET /v1/perps/assets?provider=lighter ``` ### Parameters | Name | In | Type | Required | Description | | ------------------- | ------ | -------- | -------- | --------------------- | | `provider` | query | `string` | Yes | Provider identifier | | `x-lifi-api-key` | header | `string` | Yes | API key | | `x-lifi-integrator` | header | `string` | No | Integrator identifier | ### Response `200` ```json theme={null} { "assets": [ { "providerId": "lighter", "id": "1", "displaySymbol": "USDC", "displayName": "USD Coin", "logoURI": "https://assets.li.fi/tokens/usdc.png", "decimals": 6, "l1Decimals": 6, "l1Address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "minWithdrawalAmount": "1.0" } ] } ``` Each `Asset`: | Field | Type | Description | | --------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `providerId` | `string` | Provider that owns the asset (e.g., `"lighter"`) | | `id` | `string` | Provider asset id. Lighter: numeric `asset_id` stringified. Hyperliquid spot: the venue token index, never the coin symbol (that lives in `displaySymbol`). | | `displaySymbol` | `string` | UI-friendly base symbol (e.g., `"USDC"`, `"BTC"`) | | `logoURI` | `string` | URL to asset logo | | `displayName` | `string?` | Full asset name (e.g., `"USD Coin"`) | | `tags` | `string[]?` | Curated search/grouping slugs | | `aliases` | `string[]?` | Other venues' display symbols for the same asset | | `decimals` | `number?` | Venue integer-wire precision | | `l1Decimals` | `number?` | L1 token contract precision | | `l1Address` | `string?` | L1 token address; zero address denotes native gas | | `minWithdrawalAmount` | `string?` | Per-withdrawal venue minimum in this asset's units | **SDK:** [`getAssets()`](/sdk/assets#getassets) *** ## GET /marketsContext Get live per-market context for all markets: `midPrice`, `markPrice`, and (where the venue publishes it) `oraclePrice`; `prevDayPrice`, `priceChange24h`, and `volume24h` for every market; `marketCap` where the venue publishes circulating supply; and `openInterest` and `funding` for perps. Intended for frequent polling; pair it with the static metadata from [`/markets`](#get-markets). Cached for one second. ``` GET /v1/perps/marketsContext?provider=hyperliquid ``` ### Parameters | Name | In | Type | Required | Description | | ------------------- | ------ | -------- | -------- | ----------------------------------------------------------------------- | | `provider` | query | `string` | Yes | Provider identifier | | `marketIds` | query | `string` | No | Comma-separated list of provider market ids 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` ```json theme={null} { "prices": [ { "marketId": "BTC", "midPrice": "95000.50", "markPrice": "95000.50", "oraclePrice": "95001.00", "prevDayPrice": "94200.00", "priceChange24h": "800.50", "volume24h": "5000000000", "marketCap": "1870000000000", "openInterest": "1250000000", "funding": { "rate": "0.0001", "nextFundingTime": 1704110400000 } } ] } ``` Each `MarketContext`: | Field | Type | Description | | ---------------- | -------------- | ------------------------------------------------------------------- | | `marketId` | `string` | Provider market id | | `midPrice` | `string` | Current mid price | | `markPrice` | `string` | Current mark price | | `oraclePrice` | `string?` | Venue oracle/index price, where the venue publishes one | | `prevDayPrice` | `string?` | Previous day's price | | `priceChange24h` | `string?` | 24-hour price change | | `volume24h` | `string?` | 24-hour trading volume in USD | | `marketCap` | `string?` | Market capitalization, where the venue publishes circulating supply | | `openInterest` | `string?` | Total open interest in USD (perps markets only) | | `funding` | `FundingInfo?` | Current funding rate and next funding time (perps markets only) | **SDK:** [`getMarketsContext()`](/sdk/assets#getmarketscontext) *** ## GET /ohlcv Get OHLCV candle data for charts. ``` GET /v1/perps/ohlcv?provider=hyperliquid&marketId=BTC&interval=1h&limit=100 ``` ### Parameters | Name | In | Type | Required | Description | | ------------------- | ------ | --------- | -------- | ------------------------------------------------------------------------------------------------------ | | `provider` | query | `string` | Yes | Provider identifier | | `marketId` | query | `string` | Yes | Provider market id | | `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` ```json theme={null} { "provider": "hyperliquid", "marketId": "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()`](/sdk/assets#getohlcv) *** ## GET /orderbook Get current orderbook snapshot. ``` GET /v1/perps/orderbook?provider=hyperliquid&marketId=BTC&depth=20 ``` ### Parameters | Name | In | Type | Required | Description | | ------------------- | ------ | --------- | -------- | ---------------------------------- | | `provider` | query | `string` | Yes | Provider identifier | | `marketId` | query | `string` | Yes | Provider market id | | `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` ```json theme={null} { "provider": "hyperliquid", "marketId": "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()`](/sdk/assets#getorderbook) *** ## GET /meta Get read-only platform metadata: the backend `version` and the list of active platform-level `notices` (advisories shown to all users, independent of any provider or market). Cached for one minute. ``` GET /v1/perps/meta ``` ### 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` ```json theme={null} { "version": "1.4.2", "notices": [ { "timestamp": 1704067200000, "title": "Scheduled maintenance", "message": "Trading will pause briefly at 02:00 UTC.", "link": "https://status.li.fi" } ] } ``` `Meta`: | Field | Type | Description | | --------- | ---------- | -------------------------------- | | `version` | `string` | Backend version | | `notices` | `Notice[]` | Active platform-level advisories | Each `Notice`: | Field | Type | Description | | ----------- | --------- | ------------------------------------------------------------- | | `timestamp` | `number` | Unix epoch milliseconds | | `title` | `string` | Notice title | | `message` | `string` | Notice body | | `link` | `string?` | URL the notice links to; rendered as a hyperlink when present | *** ## GET /meta/terms Get the current terms-of-service document and whether an address has accepted that version. When the address has not accepted, `accepted` is `false` and `acceptedAt` is omitted. ``` GET /v1/perps/meta/terms?address=0x1234567890abcdef1234567890abcdef12345678 ``` ### Parameters | Name | In | Type | Required | Description | | ------------------- | ------ | -------- | -------- | -------------------------------------- | | `address` | query | `string` | Yes | Wallet address to check acceptance for | | `x-lifi-api-key` | header | `string` | Yes | API key | | `x-lifi-integrator` | header | `string` | No | Integrator identifier | ### Response `200` ```json theme={null} { "termsVersion": "2026-01-01", "content": "By using this service you agree to ...", "accepted": true, "acceptedAt": 1704067200000 } ``` `TermsAcceptanceStatus`: | Field | Type | Description | | -------------- | --------- | ---------------------------------------------------------------------- | | `termsVersion` | `string` | Backend-owned version identifier for the current terms | | `content` | `string` | Full current terms-of-service text | | `accepted` | `boolean` | Whether the queried address has accepted `termsVersion` | | `acceptedAt` | `number?` | Unix epoch milliseconds the address accepted; absent when not accepted |