get_mark_price_kline
Retrieve mark price candlestick data for Bybit derivatives trading to analyze liquidation levels and PnL calculations for perpetual contracts.
Instructions
Get mark price candlestick data for derivatives trading. Mark price is used for liquidation calculations and PnL. Available for linear and inverse perpetual contracts only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Product type: 'linear' for USDT perpetuals, 'inverse' for coin-margined futures | linear |
| symbol | Yes | Trading pair symbol. Examples: 'BTCUSDT', 'ETHUSDT' | |
| interval | No | Time interval for each candlestick. Minutes: '1', '3', '5', '15', '30', '60' (1h), '120' (2h), '240' (4h), '360' (6h), '720' (12h). Periods: 'D' (daily), 'W' (weekly), 'M' (monthly) | D |
| start | No | Start time in milliseconds timestamp (OPTIONAL). The OLDEST time point (furthest back). If not provided, returns recent data. | |
| end | No | End time in milliseconds timestamp (OPTIONAL). The NEWEST time point (most recent). If not provided, defaults to current time. | |
| limit | No | Maximum number of candlesticks to return (OPTIONAL). Range: 1-1000. |