> ## 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>