# Get Market

> Query market details and orderbook depth.

## Get Market

```typescript
import { BuilderClient } from '@opinion-labs/opinion-clob-sdk';

const builder = new BuilderClient({
  host: 'https://openapi.opinion.trade/openapi',
  builderApiKey: 'YOUR_BUILDER_KEY',
  chainId: 56,
});

const market = await builder.getMarket(123);

console.log(market.marketId);      // Market ID
console.log(market.conditionId);   // Condition ID (used for split/merge/redeem)
console.log(market.quoteToken);    // Quote token address
console.log(market.chainId);       // Chain ID
console.log(market.status);        // Market status
```

### Parameters

| Parameter  | Type    | Required | Description                                  |
| ---------- | ------- | -------- | -------------------------------------------- |
| `marketId` | number  | Yes      | Market ID (positive integer)                 |
| `useCache` | boolean | No       | Use cached data if available (default: true) |

### Response

Returns a `MarketData` object:

```typescript
interface MarketData {
  marketId: number;
  chainId: string;
  quoteToken: string;
  conditionId: string;
  status: number;
  [key: string]: unknown;  // Additional fields from API
}
```

## Get Orderbook

```typescript
const orderbook = await builder.getOrderbook('token_id_here');
```

### Parameters

| Parameter | Type   | Required | Description      |
| --------- | ------ | -------- | ---------------- |
| `tokenId` | string | Yes      | Outcome token ID |

### Response

Returns the raw API response containing bid/ask depth.

## Notes

* Market data is cached for 5 minutes by default (configurable via `marketCacheTtl`).
* Pass `false` to bypass the cache: `await builder.getMarket(123, false)`.
* The `conditionId` from `getMarket()` is required for split, merge, and redeem operations.
* The `quoteToken` address identifies which currency this market uses.