Lukka Market Data - Derivatives API
The Market Data - Derivatives API from Lukka — 8 operation(s) for market data - derivatives.
OpenAPI Specification
openapi: 3.2.0
info:
title: Lukka Pricing & Market Data Market Data - Derivatives API
version: 1.0.0
description: 'Institutional crypto pricing, valuation and market data: Lukka Prime fair-market-value prices, reference rates, index prices, MVWAP, OHLCV candles, market capitalisation, order-book liquidity and snapshots, spot and derivative trades, staking rates, funding rates and prediction-market history.'
contact:
name: Lukka Support
url: https://lukka.tech/support/
x-origin:
- format: postman
version: 2.1.0
url: https://apidocs.lukka.tech/
servers:
- url: https://data-pricing-api.lukka.tech
description: Lukka production (data-pricing-api.lukka.tech)
security:
- bearerAuth: []
tags:
- name: Market Data - Derivatives
paths:
/v2/market-data/sources/{sourceId}/candles/pairs/{pairCode}:
get:
operationId: getCandlesByExchangeSourceDerivative
summary: Get Candles by Exchange Source (Derivative)
tags:
- Market Data - Derivatives
description: "Description: Get the price history for a single pair.\n\n If the response exceeds the maximum number of transactions that can be returned in a single payload then a next_url variable will be returned at the end of the response. The next_url is used to paginate the response and can be called to request the next batch of transactions prior to what was returned. next_url will continue to be included in the response until all of the requested transactions have been returned."
parameters:
- name: sourceId
in: path
required: true
schema:
type: string
description: sourceId path parameter
- name: pairCode
in: path
required: true
schema:
type: string
description: pairCode path parameter
- name: from
in: query
required: false
schema:
type: string
example: '2026-04-20T00:00:00Z'
- name: to
in: query
required: false
schema:
type: string
example: '2026-04-20T02:00:00Z'
responses:
'200':
description: Get Candles by Exchange Source (Derivative)
content:
application/json:
example:
sourceId: 4005
pairCode: BTCUSDT.BINA
dataType: candles
firstDate: '2026-04-20T00:00:00Z'
lastDate: '2026-04-20T02:00:00Z'
count: 3
units: native
instrumentType: DERIVATIVE
data:
- tradeCount: 112847
volume: '5823.14200000'
openPrice: '73819.50'
highPrice: '74392.10'
lowPrice: '73738.00'
closePrice: '74298.70'
ts: '2026-04-20T00:00:00Z'
- tradeCount: 98321
volume: '5214.88100000'
openPrice: '74298.70'
highPrice: '74786.20'
lowPrice: '74241.30'
closePrice: '74618.90'
ts: '2026-04-20T01:00:00Z'
- tradeCount: 71204
volume: '3891.55600000'
openPrice: '74618.90'
highPrice: '74658.80'
lowPrice: '74329.40'
closePrice: '74437.20'
ts: '2026-04-20T02:00:00Z'
/v1/pricing/latest-markets/DERIVATIVE:
get:
operationId: getLatestMarketsDERIVATIVE
summary: Get Latest Markets (DERIVATIVE)
tags:
- Market Data - Derivatives
description: 'Description: This endpoint returns the derivative markets for a specified exchange over the previous 24 hours. In addition to sourceIds , supports underlyingAssetCode , quoteAssetCode , and lukkaInstrumentClassification filters.'
parameters:
- name: sourceIds
in: query
required: false
schema:
type: string
example: '4005'
- name: limit
in: query
required: false
schema:
type: string
example: '5'
responses:
'200':
description: Get Latest Markets (DERIVATIVE)
content:
application/json:
example:
dataType: markets
count: 5
data:
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BTCUSDT.BINA
derivativeLid: L-BINA-PERP-XBT-USDT
underlyingAssetCode: XBT
quoteAssetCode: USDT
latestPrice: '79171.1'
latestPriceUsd: '79183.767376'
volume24h: '206633.6350000002'
volumeUsd24h: '15961556224.894135'
tradeCount24h: '2052278.0'
latestPriceTs: '2026-04-22T15:37:59.999Z'
indexPrice: '79182.38065217'
markPrice: '79155.25726087'
lukkaInstrumentClassification: Perpetual
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: ETHUSDT.BINA
derivativeLid: L-BINA-PERP-ETH-USDT
underlyingAssetCode: ETH
quoteAssetCode: USDT
latestPrice: '2408.21'
latestPriceUsd: '2408.5953136'
volume24h: '5383001.592999991'
volumeUsd24h: '12705354718.211126'
tradeCount24h: '1788587.0'
latestPriceTs: '2026-04-22T15:37:59.974Z'
indexPrice: '2405.73395349'
markPrice: '2404.78166667'
lukkaInstrumentClassification: Perpetual
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BTCUSDC.BINA
derivativeLid: L-BINA-PERP-XBT-USDC
underlyingAssetCode: XBT
quoteAssetCode: USDC
latestPrice: '79192.5'
latestPriceUsd: '79176.66466706658'
volume24h: '53998.27399999996'
volumeUsd24h: '4169951644.851292'
tradeCount24h: '726327.0'
latestPriceTs: '2026-04-22T15:37:59.910Z'
indexPrice: '79216.87357103'
markPrice: '79176.90245761'
lukkaInstrumentClassification: Perpetual
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: ETHUSDC.BINA
derivativeLid: L-BINA-PERP-ETH-USDC
underlyingAssetCode: ETH
quoteAssetCode: USDC
latestPrice: '2409.13'
latestPriceUsd: '2408.648270345931'
volume24h: '1422655.1400000006'
volumeUsd24h: '3356264678.6877127'
tradeCount24h: '933714.0'
latestPriceTs: '2026-04-22T15:37:59.906Z'
indexPrice: '2406.64401433'
markPrice: '2405.82802805'
lukkaInstrumentClassification: Perpetual
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: SOLUSDT.BINA
derivativeLid: L-BINA-PERP-SOLN-USDT
underlyingAssetCode: SOLN
quoteAssetCode: USDT
latestPrice: '88.35'
latestPriceUsd: '88.364136'
volume24h: '23872224.92000002'
volumeUsd24h: '2079477069.5996287'
tradeCount24h: '309414.0'
latestPriceTs: '2026-04-22T15:37:59.834Z'
indexPrice: '88.34553881'
markPrice: '88.30572792'
lukkaInstrumentClassification: Perpetual
nextPageUrl: https://data-pricing-api.lukka.tech/v1/pricing/latest-markets/DERIVATIVE?sourceIds=4005&limit=5&offset=5
/v1/pricing/latest-markets/GREEKS:
get:
operationId: getLatestMarketsGREEKS
summary: Get Latest Markets (GREEKS)
tags:
- Market Data - Derivatives
description: 'Description: This endpoint returns the options markets for a specified exchange over the previous 24 hours, with Greeks values (delta, gamma, theta, vega, rho) included for each instrument.'
parameters:
- name: sourceIds
in: query
required: false
schema:
type: string
example: '4005'
- name: limit
in: query
required: false
schema:
type: string
example: '5'
responses:
'200':
description: Get Latest Markets (GREEKS)
content:
application/json:
example:
dataType: greeks
count: 5
data:
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BNB-260422-615-C.BINA
underlyingAssetCode: BNB
quoteAssetCode: USDT
lukkaInstrumentClassification: Option
optionType: C
strikePrice: '615.0'
expiryTime: '2026-04-22T08:00:00Z'
latestPrice: '19.9'
latestPriceUsd: '19.903383'
latestSize: '0.07'
latestSizeUsd: '1.39323681'
aggressor: B
spotPrice: '632.5375131'
forwardPrice: '632.543157850426'
impliedForwardRate: '0.0106319098872809'
riskFreeRate: '0.0366698585651162'
timeToExpiry: '0.0008393541333942'
impliedVolatility: '1.1602341906270601'
delta: '0.8032983099606948'
gamma: '0.0130342444697076'
theta: '-2.945658751348726'
vega: '0.0507875286097051'
rho: '-0.0001670598678959'
modelType: BLACK76
latestPriceTs: '2026-04-22T00:38:31.926Z'
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BNB-260422-620-C.BINA
underlyingAssetCode: BNB
quoteAssetCode: USDT
lukkaInstrumentClassification: Option
optionType: C
strikePrice: '620.0'
expiryTime: '2026-04-22T08:00:00Z'
latestPrice: '12.1'
latestPriceUsd: '12.101331'
latestSize: '0.32'
latestSizeUsd: '3.87242592'
aggressor: B
spotPrice: '632.1'
forwardPrice: '632.1097851397548'
impliedForwardRate: '0.0084829561121654'
riskFreeRate: '0.0368693920310197'
timeToExpiry: '0.0018248646601769'
impliedVolatility: '0.0000000000454747'
delta: '0.9999327206127999'
gamma: '0.0'
theta: '0.0008147115151455'
vega: '0.0'
rho: '-0.0002209723215561'
modelType: BLACK76
latestPriceTs: '2026-04-21T16:00:11.583Z'
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BNB-260422-625-C.BINA
underlyingAssetCode: BNB
quoteAssetCode: USDT
lukkaInstrumentClassification: Option
optionType: C
strikePrice: '625.0'
expiryTime: '2026-04-22T08:00:00Z'
latestPrice: '15.0'
latestPriceUsd: '15.0015'
latestSize: '0.6'
latestSizeUsd: '9.0009'
aggressor: B
spotPrice: '640.69'
forwardPrice: '640.6931831860604'
impliedForwardRate: '0.009005500274662'
riskFreeRate: '0.0366698585651162'
timeToExpiry: '0.0005517027593987'
impliedVolatility: '0.0000000000454747'
delta: '0.9999797693424853'
gamma: '0.0'
theta: '0.0003174802028807'
vega: '0.0'
rho: '-0.0000865779731102'
modelType: BLACK76
latestPriceTs: '2026-04-22T03:09:49.509Z'
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BNB-260422-630-P.BINA
underlyingAssetCode: BNB
quoteAssetCode: USDT
lukkaInstrumentClassification: Option
optionType: P
strikePrice: '630.0'
expiryTime: '2026-04-22T08:00:00Z'
latestPrice: '3.6'
latestPriceUsd: '3.60036'
latestSize: '1.0'
latestSizeUsd: '3.60036'
aggressor: B
spotPrice: '631.153109'
forwardPrice: '631.1657726710662'
impliedForwardRate: '0.0108101749959782'
riskFreeRate: '0.0368693920310197'
timeToExpiry: '0.0018560420627678'
impliedVolatility: '0.3836117645172842'
delta: '-0.4521606373839011'
gamma: '0.0379679877243074'
theta: '-2.065353092440549'
vega: '0.107692185706962'
rho: '-0.0000668241960111'
modelType: BLACK76
latestPriceTs: '2026-04-21T15:43:47.695Z'
- sourceId: 4005
entityCode: BINA
entityName: Binance
derivativeCode: BNB-260422-635-C.BINA
underlyingAssetCode: BNB
quoteAssetCode: USDT
lukkaInstrumentClassification: Option
optionType: C
strikePrice: '635.0'
expiryTime: '2026-04-22T08:00:00Z'
latestPrice: '9.3'
latestPriceUsd: '9.299907'
latestSize: '0.48'
latestSizeUsd: '4.46395536'
aggressor: B
spotPrice: '644.8'
forwardPrice: '644.8008305409462'
impliedForwardRate: '0.0053085595378116'
riskFreeRate: '0.0366698585651162'
timeToExpiry: '0.0002426381283748'
impliedVolatility: '0.0000000000454747'
delta: '0.9999911025337327'
gamma: '0.0'
theta: '0.0000872021711877'
vega: '0.0'
rho: '-0.0000237803402031'
modelType: BLACK76
latestPriceTs: '2026-04-22T05:52:22.851Z'
nextPageUrl: https://data-pricing-api.lukka.tech/v1/pricing/latest-markets/GREEKS?sourceIds=4005&limit=5&offset=5
/v1/market-data/derivative/sources/{sourceId}/trades:
get:
operationId: getLatestDerivativeTrades
summary: Get Latest Derivative Trades
tags:
- Market Data - Derivatives
description: "Description: Get the Latest Trades for derivative instruments from a specific Source ID.\n\n If the response exceeds the maximum number of records that can be returned in a single payload, then a nextPageUrl field will be returned at the end of the response. The nextPageUrl is used to paginate the response and can be called to request the next batch of records prior to what was returned.\n\n lookback is specified in minutes (not milliseconds)."
parameters:
- name: sourceId
in: path
required: true
schema:
type: string
description: sourceId path parameter
- name: lookback
in: query
required: false
schema:
type: string
example: '60'
responses:
'200':
description: Get Latest Derivative Trades
/v1/market-data/derivative/sources/{sourceId}/trades/historical:
get:
operationId: getHistoricalDerivativeTrades
summary: Get Historical Derivative Trades
tags:
- Market Data - Derivatives
description: 'Description: Get the trade history for a specific derivative instrument from a specified Source ID. Must supply either entityDerivativeCode (exchange-native code) or lukkaDerivativeCode (Lukka canonical code).'
parameters:
- name: sourceId
in: path
required: true
schema:
type: string
description: sourceId path parameter
- name: from
in: query
required: false
schema:
type: string
example: '2026-04-20T12:00:00Z'
- name: to
in: query
required: false
schema:
type: string
example: '2026-04-20T12:01:00Z'
- name: entityDerivativeCode
in: query
required: false
schema:
type: string
example: BTCUSDT
responses:
'200':
description: Get Historical Derivative Trades
/v1/pricing/sources/{sourceId}/markprices:
get:
operationId: getLatestMarkPrices
summary: Get Latest Mark Prices
tags:
- Market Data - Derivatives
description: 'Description: Get the latest derivative mark prices as of the given timestamp from a specified derivatives exchange Source ID (e.g. 4005 Binance futures). Optional underlyingAssetCode and lukkaDerivativeCode filters can be applied to narrow the response.'
parameters:
- name: sourceId
in: path
required: true
schema:
type: string
description: sourceId path parameter
- name: lookback
in: query
required: false
schema:
type: string
example: '60000'
responses:
'200':
description: Get Latest Mark Prices
/v1/pricing/sources/{sourceId}/{baseAssetCode}/markprices/historical:
get:
operationId: getHistoricalMarkPrices
summary: Get Historical Mark Prices
tags:
- Market Data - Derivatives
description: "Description: Get the mark price history for a specific derivative instrument from a specified Source ID.\n\n If the response exceeds the maximum number of records that can be returned in a single payload, then a nextPageUrl field will be returned at the end of the response. The nextPageUrl is used to paginate the response and can be called to request the next batch of records prior to what was returned.\n\n interval (milliseconds) allowed values: 1000, 5000, 30000, 60000, 300000, 1800000, 3600000, 86400000."
parameters:
- name: sourceId
in: path
required: true
schema:
type: string
description: sourceId path parameter
- name: baseAssetCode
in: path
required: true
schema:
type: string
description: baseAssetCode path parameter
- name: from
in: query
required: false
schema:
type: string
example: '2026-04-20T12:00:00Z'
- name: to
in: query
required: false
schema:
type: string
example: '2026-04-20T12:10:00Z'
- name: interval
in: query
required: false
schema:
type: string
example: '60000'
responses:
'200':
description: Get Historical Mark Prices
content:
application/json:
example:
data:
- ts: '2026-04-20T12:00:00Z'
derivativeCode: BTCUSDT.BINA
underlyingAssetCode: XBT
markPrice: '75160.0'
- ts: '2026-04-20T12:01:00Z'
derivativeCode: BTCUSDT.BINA
underlyingAssetCode: XBT
markPrice: '75106.0'
- ts: '2026-04-20T12:02:00Z'
derivativeCode: BTCUSDT.BINA
underlyingAssetCode: XBT
markPrice: '75069.63205072'
- ts: '2026-04-20T12:03:00Z'
derivativeCode: BTCUSDT.BINA
underlyingAssetCode: XBT
markPrice: '75075.6'
- ts: '2026-04-20T12:04:00Z'
derivativeCode: BTCUSDT.BINA
underlyingAssetCode: XBT
markPrice: '75049.6828913'
/v1/pricing/derivatives/composite-funding-rates:
get:
operationId: getCompositeFundingRatesByPairCodes
summary: Get Composite Funding Rates (by pairCodes)
tags:
- Market Data - Derivatives
description: 'Description: Get the IQR-cleansed composite funding rate across derivatives exchanges for the specified derivative pair codes. This is the pairCodes variant of the endpoint; it is mutually exclusive with the underlyingAssetCodes + counterAssetCodes variant.'
parameters:
- name: pairCodes
in: query
required: false
schema:
type: string
example: XBT-USDT
responses:
'200':
description: Get Composite Funding Rates (by pairCodes)
content:
application/json:
example:
dataType: composite-funding-rates
ts: '2026-04-22T15:39:00.000Z'
count: 1
data:
- pairCode: XBT-USDT
compositeRate: '0.0353'
minRate: '0.0308'
maxRate: '0.0398'
medianRate: '0.0353'
meanRate: '0.0353'
depth: 2
calcInputs:
- sourceId: 4005
entityCode: BINA
yearlyRate: '0.0398'
- sourceId: 4015
entityCode: BYBT
yearlyRate: '0.0308'
components:
securitySchemes:
oktaClientCredentials:
type: oauth2
description: Lukka issues JWT access tokens from its Okta authorization servers using the OAuth 2.0 client_credentials grant. Encode the Lukka-issued client id and secret as HTTP Basic credentials on the token request; the returned access_token is then sent as a Bearer token on every data API call.
flows:
clientCredentials:
tokenUrl: https://sso.lukka.tech/oauth2/aus1imo2fqcx5Ik4Q0h8/v1/token
scopes:
pricing: Access to Lukka Pricing & Valuation and Market Data endpoints
interclient_access: Cross-client access scope advertised by the Lukka Okta authorization servers
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT access token obtained from the Lukka Okta token endpoint.