Get Market

Query market details and orderbook depth.

Get Market

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:

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

Get Orderbook

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.