Perp Data

Get ticker

GET/perp/tickerPublic

Get the ticker of a perpetual market: mark price, last price, executable prices by order size, 24h change and volume, the next funding and quanto adjustment rates, and the next funding time. An unknown market, or one you have no access to, fails with NOT_FOUND.

Query Parameters

instrument*string

Instrument of the market

Value in"inverse_perp""quanto_perp"
pair*string

Pair of the market

Response Body

OK

application/json
  1. response
instrument*string

Instrument of the market

Value in"inverse_perp""quanto_perp"
pair*string

Pair of the market

time*string

Timestamp when the ticker was last updated

Formatdate-time
lastPrice*number

Weighted average of the reference exchanges' perpetual last trade prices (in USD). Display only: never used to value or trigger anything

priceChange24h?
volume24h?number

24h trading volume in USD, aggregated across the reference exchanges

Range0 <= value
prices*array<>

Executable prices by order size. Market orders fill at the bucket for their size; limit, takeprofit, stoploss and liquidation levels trigger when that bucket crosses them and fill at the level

fundingRate*number

Current funding rate for the next funding period, in decimal form

fundingTime*string

Next funding settlement time

Formatdate-time
exchangesWeights*

Exchange weights used to compute the order book prices, the mark price and the last price

mark*number

Mark price: weighted average of the reference exchanges' perpetual mark prices (in USD). Values P&L, margin and funding

quantoAdjustmentRate*number

Current quanto adjustment rate for the next funding period, in decimal form (0 for a market without quanto adjustment)

import { createHttpClient } from '@ln-markets/sdk/rest/v3'

const client = createHttpClient()

const result = await client.perp.getTicker({
  instrument: 'inverse_perp',
  pair: 'btc_usd'
})
{
  "instrument": "inverse_perp",
  "pair": "btc_usd",
  "time": "2026-11-02T11:07:06.162Z",
  "lastPrice": 43275,
  "priceChange24h": {
    "ratio": 0.0256,
    "updatedAt": "2026-11-02T11:07:06.162Z"
  },
  "volume24h": 3966032827,
  "prices": [
    {
      "askPrice": 43280,
      "bidPrice": 43270,
      "minSize": 1000,
      "maxSize": 10000
    }
  ],
  "fundingRate": 0.0001,
  "fundingTime": "2026-11-02T11:07:06.162Z",
  "exchangesWeights": {
    "bybit": 0.33,
    "binance": 0.33,
    "okx": 0.34
  },
  "mark": 43250,
  "quantoAdjustmentRate": 0.0001
}

Get funding settlements GET

Get the funding settlement history of a perpetual market. Paginated, newest first. An unknown market, or one you have no access to, fails with NOT_FOUND…

Get candles GET

Get the candles (OHLC) of a perpetual market at the range resolution, 1 minute by default. Paginated, newest first. An unknown market, or one you have no…