# Market Data (/docs/tools/market-data) All tools on this page are **public** and need **no API key**. Symbols are Delta product symbols (e.g. `BTCUSD`). Candle/history timestamps are **Unix seconds**. ## get\_ticker [#get_ticker] 24h ticker for one symbol: last price, volume, open interest, mark and spot. **Auth:** No key | Param | Type | Required | Notes | | -------- | ------ | -------- | ------------- | | `symbol` | string | yes | e.g. `BTCUSD` | ```text Show the BTCUSD ticker: last price, 24h change, volume, and funding rate. ``` ## list\_tickers [#list_tickers] Tickers across many products, with optional filters. Good for a market snapshot. **Auth:** No key | Param | Type | Required | Notes | | -------------------------- | --------- | -------- | ------------------------------------------------------------- | | `contract_types` | string\[] | no | `perpetual_futures`, `futures`, `call_options`, `put_options` | | `underlying_asset_symbols` | string\[] | no | e.g. `BTC`, `ETH`, `SOL` | ```text Snapshot the top perpetuals by 24h volume: last price, 24h change, OI, funding. ``` ## get\_product [#get_product] Full product metadata for one symbol: tick size, contract value, leverage caps. **Auth:** No key | Param | Type | Required | Notes | | -------- | ------ | -------- | ------------------------------------- | | `symbol` | string | yes | e.g. `BTCUSD` or `C-BTC-66400-010824` | ```text Show the contract spec for BTCUSD: tick size, contract value, and max leverage. ``` ## list\_products [#list_products] Tradable products with optional filters. Paginated (returns `meta.after`). **Auth:** No key | Param | Type | Required | Notes | | ---------------- | --------- | -------- | --------------------------------------------------------------------- | | `contract_types` | string\[] | no | `perpetual_futures`, `call_options`, `put_options`, `futures`, `spot` | | `states` | string\[] | no | `live`, `upcoming`, `expired`, `settled` | | `expiry` | string | no | `YYYY-MM-DD` (current/future expiries only) | | `page_size` | int | no | default 100, max 500 | | `after` | string | no | cursor from a previous response's `meta.after` | ```text List all live perpetual futures on Delta. ``` ## get\_orderbook [#get_orderbook] L2 order book snapshot for a symbol. **Auth:** No key | Param | Type | Required | Notes | | -------- | ------ | -------- | ------------------------ | | `symbol` | string | yes | e.g. `BTCUSD` | | `depth` | int | no | levels per side, max 100 | ```text Show the BTCUSD order book at 10 levels per side and where the book is heavy. ``` ## get\_recent\_trades [#get_recent_trades] Recent public trades for a symbol. **Auth:** No key | Param | Type | Required | Notes | | -------- | ------ | -------- | ------------- | | `symbol` | string | yes | e.g. `BTCUSD` | ```text Show the most recent BTCUSD trades and the buy/sell balance. ``` ## get\_candles [#get_candles] OHLC candles for a symbol over a time window. **Auth:** No key | Param | Type | Required | Notes | | ------------ | ------ | -------- | ------------------------------------------------------------------ | | `symbol` | string | yes | e.g. `BTCUSD` | | `resolution` | string | yes | `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `1d`, `1w` | | `start` | int | yes | Unix seconds, inclusive | | `end` | int | yes | Unix seconds, inclusive | ```text Pull BTCUSD 1h candles for the last 24 hours and describe the trend. ``` ## get\_mark\_price\_history [#get_mark_price_history] Historical mark-price candles: useful for P\&L curves and slippage vs fair value. **Auth:** No key | Param | Type | Required | Notes | | ------------ | ------ | -------- | --------------------------------------- | | `symbol` | string | yes | e.g. `BTCUSD` or `C-BTC-66400-010824` | | `start` | int | yes | Unix seconds, inclusive | | `end` | int | yes | Unix seconds, inclusive | | `resolution` | string | no | default `1m`; same set as `get_candles` | ```text Show BTCUSD mark price every 5m over the last 6 hours. ``` ## get\_oi\_history [#get_oi_history] Historical open-interest candles: detect positioning extremes and OI build-up. **Auth:** No key | Param | Type | Required | Notes | | ------------ | ------ | -------- | --------------------------------------- | | `symbol` | string | yes | e.g. `BTCUSD` | | `start` | int | yes | Unix seconds, inclusive | | `end` | int | yes | Unix seconds, inclusive | | `resolution` | string | no | default `1h`; same set as `get_candles` | ```text Plot BTCUSD open interest over the last 7 days and flag any sharp build-up. ``` ## get\_funding\_history [#get_funding_history] Historical funding-rate candles for a perpetual: basis analysis and realised funding. **Auth:** No key | Param | Type | Required | Notes | | ------------ | ------ | -------- | --------------------------------------- | | `symbol` | string | yes | perpetual symbol, e.g. `BTCUSD` | | `start` | int | yes | Unix seconds, inclusive | | `end` | int | yes | Unix seconds, inclusive | | `resolution` | string | no | default `1h`; same set as `get_candles` | ```text Show ETHUSD funding over the last 3 days and the cumulative funding paid by a long. ``` ## get\_options\_chain [#get_options_chain] Full call + put chain for one underlying on one expiry. **Auth:** No key | Param | Type | Required | Notes | | ------------- | ------ | -------- | ---------------------------------------------------------------------------- | | `underlying` | string | yes | e.g. `BTC`, `ETH` | | `expiry_date` | string | yes | `DD-MM-YYYY` (note: different from `list_products`, which uses `YYYY-MM-DD`) | ```text Pull the BTC options chain for the nearest expiry. Summarise IV by strike and the put/call OI skew. ``` ## get\_indices [#get_indices] Spot price indices Delta builds from multiple exchanges. These underlie its futures and options. **Auth:** No key No parameters. Returns each index's constituent exchanges + weights, `index_type` (`spot_pair` / `fixed_interest_rate` / `floating_interest_rate`), tick size, and the underlying/quoting asset. Use to audit how a product's mark or settlement price is built. ```text Show the BTC spot index composition: which exchanges and weights build it. ``` ## get\_settlement\_prices [#get_settlement_prices] Settlement prices for expired/settled derivatives: post-expiry P\&L reconciliation and backtesting. Paginated. **Auth:** No key | Param | Type | Required | Notes | | ---------------- | --------- | -------- | ---------------------------------------------- | | `contract_types` | string\[] | no | e.g. `call_options`, `put_options`, `futures` | | `page_size` | int | no | default 100, max 500 | | `after` | string | no | cursor from a previous response's `meta.after` | Each product carries `settlement_time` and `settlement_price` alongside its metadata. (Under the hood this is `list_products(states=["expired"])`.) ```text List BTC options that settled in the last week with their settlement prices. ``` ## get\_reference\_data [#get_reference_data] Merged assets + indices listing: symbol and asset metadata lookups. **Auth:** No key No parameters. For index-only queries (composition, weights), prefer `get_indices`. ```text What assets and quoting currencies does Delta support? ```