> ## Documentation Index
> Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Market detail

> Composite single-symbol bundle: market info, orderbook, recent trades, funding history, and candles in one call.

Composite snapshot for a single symbol. The `include` field controls which of the five sub-sections are populated; all five sub-queries run in parallel, so latency ≈ slowest sub-section.

**Weight:** `2`

## Request

```json theme={null}
{
  "type": "marketDetail",
  "symbol": "PERP_BTC_USDC",
  "include": ["market_info", "orderbook", "recent_trades", "funding_history", "candles"],
  "orderbook_levels": 20,
  "recent_trades_limit": 20,
  "funding_history_limit": 8,
  "candles_interval": "1h",
  "candles_limit": 24
}
```

| Field | Type | Required | Default | Notes |
| - | - | - | - | - |
| `symbol` | string | Yes | — | Trading pair |
| `include` | string\[] | No | all 5 | Subset of `["market_info","orderbook","recent_trades","funding_history","candles"]`; empty list = all |
| `orderbook_levels` | int | No | 20 | 1..100 (clamped) |
| `recent_trades_limit` | int | No | 20 | 1..100 |
| `funding_history_limit` | int | No | 8 | 1..100 |
| `candles_interval` | string | No | `"1h"` | Same interval set as [`candles`](/build-on-omnichain/public-info-api/market/candles) |
| `candles_limit` | int | No | 24 | 1..500 |

## Response

## Notes

* Sub-sections omitted from `include` are absent from the response (key is missing, not `null`)
* See individual endpoints for field-level details: [`marketSummary`](/build-on-omnichain/public-info-api/market/market-summary), [`marketTrades`](/build-on-omnichain/public-info-api/market/market-trades), [`fundingRateHistory`](/build-on-omnichain/public-info-api/market/funding-rate-history), [`candles`](/build-on-omnichain/public-info-api/market/candles)

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "symbol": "PERP_BTC_USDC",
      "market_info": {
        /* same shape as marketSummary.markets[] row */
      },
      "orderbook": {
        "asks": [{ "price": "77339.20", "quantity": "0.45" }],
        "bids": [{ "price": "77337.50", "quantity": "0.32" }]
      },
      "recent_trades": [
        /* same shape as marketTrades rows */
      ],
      "funding_history": [
        /* same shape as fundingRateHistory rows */
      ],
      "candles": [
        /* same shape as candles rows */
      ]
    },
    "ts": 1779269143700
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.