Assets

Fetch tradeable assets, prices, OHLCV candles, and orderbooks

Fetch asset details, prices, OHLCV chart data, and orderbook snapshots.

The examples on this page use Hyperliquid (provider: 'hyperliquid'). Replace the provider value with any supported DEX from getProviders().

getAssets

Returns the token/asset registry for a specified DEX — the base entities referenced by markets (as base/quote legs) and by account balances. Static market metadata (leverage, margin) lives on Market via getMarkets; live data (mark price, funding) lives on MarketPrice via getPrices.

import { getAssets } from '@lifi/perps-sdk';

const { assets } = await getAssets(client, { provider: 'hyperliquid' });

for (const asset of assets) {
  console.log(asset.id, asset.displaySymbol);
}
// BTC BTC
// ETH ETH

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	Provider identifier
options	SDKRequestOptions	No	Request options

Returns

AssetsResponse — { assets: Asset[] }:

Each Asset:

Field	Type	Description
providerId	string	Provider that minted this asset
id	string	Provider’s own asset id (Lighter’s numeric asset_id stringified; Hyperliquid coin symbol)
displaySymbol	string	UI-friendly base symbol (e.g., "BTC", "PURR")
logoURI	string	URL to asset logo
displayName	string?	Full asset name (e.g., "Bitcoin")

API Reference: GET /assets

---

getMarkets

Returns all tradeable markets for a specified DEX as static instrument metadata — ids, base/quote assets, decimals, leverage, and margin. Live data (mark price, funding, open interest, volume) comes from getPrices.

import { getMarkets } from '@lifi/perps-sdk';

const { markets } = await getMarkets(client, { provider: 'hyperliquid' });

for (const market of markets) {
  console.log(market.baseAsset.displaySymbol, market.maxLeverage);
}
// BTC 50
// ETH 50

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	Provider identifier
params.marketIds	string[]	No	Filter to specific markets by the canonical Market.id (not display symbols)
options	SDKRequestOptions	No	Request options

Returns

MarketsResponse — { markets: Market[] }. A Market is either a PerpsMarket or a SpotMarket; both extend BaseMarket:

Field	Type	Description
providerId	string	Provider that owns this market
id	string	Provider’s canonical, stringified market id that uniquely identifies the trading instrument; referenced elsewhere as marketId
categoryId	string	References a ProviderCategory by id
baseAsset	Asset	Base leg
quoteAsset	Asset	Quote leg
szDecimals	number	Size decimal places

PerpsMarket adds:

Field	Type	Description
maxLeverage	number	Maximum allowed leverage
onlyIsolated	boolean	Whether only isolated margin is supported

Live per-market data (mark price, previous-day price, 24h volume, open interest, funding) comes from getPrices.

API Reference: GET /markets

---

getMarket

Returns a single market by its canonical marketId.

import { getMarket } from '@lifi/perps-sdk';

const btc = await getMarket(client, { provider: 'hyperliquid', marketId: 'BTC' });
console.log(btc.baseAsset.displaySymbol, btc.maxLeverage);
// BTC 50

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	Provider identifier
params.marketId	string	Yes	The canonical Market.id (not the display symbol)
options	SDKRequestOptions	No	Request options

Returns

Market — single market object (same shape as above).

API Reference: GET /markets

---

getPrices

Returns live per-market data for all markets: the mid price, markPrice, prevDayPrice, and volume24h for every market, plus openInterest and funding for perps. Intended for frequent polling; pair it with the static metadata from getMarkets.

import { getPrices } from '@lifi/perps-sdk';

const { prices } = await getPrices(client, { provider: 'hyperliquid' });
for (const p of prices) {
  console.log(p.marketId, p.price, p.markPrice);
}
// 0 95000.50 95000.50
// 1 3200.25 3200.25

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	Provider identifier
params.marketIds	string[]	No	Filter to specific markets by the canonical Market.id (not display symbols)
options	SDKRequestOptions	No	Request options

Returns

PricesResponse — { prices: MarketPrice[] }:

Each MarketPrice:

Field	Type	Description
marketId	string	The canonical Market.id
price	string	Current mid price
markPrice	string	Current mark price
prevDayPrice	string?	Previous day’s price
volume24h	string?	24-hour trading volume in USD
openInterest	string?	Total open interest in USD (perps markets only)
funding	FundingInfo?	Current funding rate and next funding time (perps markets only)

API Reference: GET /prices

---

getOhlcv

Returns OHLCV candle data for charts.

import { getOhlcv } from '@lifi/perps-sdk';

const { candles } = await getOhlcv(client, {
  provider: 'hyperliquid',
  marketId: 'BTC',
  interval: '1h',
  limit: 100,
});

for (const candle of candles) {
  console.log(candle.t, candle.o, candle.h, candle.l, candle.c, candle.v);
}

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	Provider identifier
params.marketId	string	Yes	The canonical Market.id
params.interval	string	Yes	Candle interval: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M
params.startTime	number	No	Start timestamp in milliseconds
params.endTime	number	No	End timestamp in milliseconds
params.limit	number	No	Max candles to return (default 100, max 1000)
options	SDKRequestOptions	No	Request options

Returns

OhlcvResponse:

Field	Type	Description
provider	string	Provider identifier
marketId	string	The canonical Market.id
interval	string	Candle interval
candles	Candle[]	Array of candle data

Each Candle:

Field	Type	Description
t	number	Timestamp in milliseconds
o	string	Open price
h	string	High price
l	string	Low price
c	string	Close price
v	string	Volume

API Reference: GET /ohlcv

---

getOrderbook

Returns current orderbook snapshot with bids and asks.

import { getOrderbook } from '@lifi/perps-sdk';

const book = await getOrderbook(client, {
  provider: 'hyperliquid',
  marketId: 'BTC',
  depth: 20,
});

console.log('Best bid:', book.bids[0].price, book.bids[0].size);
console.log('Best ask:', book.asks[0].price, book.asks[0].size);

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	Provider identifier
params.marketId	string	Yes	The canonical Market.id
params.depth	number	No	Number of price levels (default 20, max 100)
options	SDKRequestOptions	No	Request options

Returns

OrderbookResponse:

Field	Type	Description
provider	string	Provider identifier
marketId	string	The canonical Market.id
bids	OrderbookLevel[]	Bid price levels (descending)
asks	OrderbookLevel[]	Ask price levels (ascending)
timestamp	number	Snapshot timestamp in milliseconds

Each OrderbookLevel:

Field	Type	Description
price	string	Price level
size	string	Size at this price level

API Reference: GET /orderbook