Overview

Opinion CLOB TypeScript SDK

Welcome to the official documentation for the Opinion CLOB TypeScript SDK - a TypeScript library for interacting with Opinion Labs' prediction markets via the Central Limit Order Book (CLOB) API.

Technical Preview: TypeScript SDK Version 0.5.2 features BNB Chain support. While fully functional and tested, we recommend thorough testing before production use.

To request SDK/API access, please kindly fill out this short application form.

API Key can be used for Opinion OpenAPI, Opinion Websocket, and Opinion CLOB SDK

What is Opinion CLOB TypeScript SDK?

The Opinion CLOB TypeScript SDK provides a TypeScript interface for building applications on top of Opinion prediction market infrastructure. It enables developers to:

• Query market data - Access real-time market information, prices, and orderbooks

• Execute trades - Place market and limit orders with EIP712 signing

• Manage positions - Track balances, positions, and trading history

• Interact with smart contracts - Split, merge, and redeem tokens on BNB Chain blockchain

Key Features

Production-Ready

• Type-safe - Full TypeScript types and interfaces

• Well-tested - Test suite with 95%+ coverage

• Reliable - Built on industry-standard libraries (viem)

• Documented - Extensive documentation with examples

Performance Optimized

• Smart caching - Configurable TTL for market data and quote tokens

• Batch operations - Place or cancel multiple orders efficiently

• Gas optimization - Minimal on-chain transactions

Secure by Design

• EIP712 signing - Industry-standard typed data signatures

• Multi-sig support - Gnosis Safe integration for institutional users

• Private key safety - Keys never leave your environment

Blockchain Support

• BNB Chain Mainnet (Chain ID: 56)

Use Cases

Trading Applications

Build automated trading bots, market-making applications, or custom trading interfaces.

example.ts

import { Client, DEFAULT_API_HOST, CHAIN_ID_BNB_MAINNET, OrderSide, OrderType } from '@opinion-labs/opinion-clob-sdk';

const client = new Client({ host: DEFAULT_API_HOST, apiKey: 'your_key', ... });

// Place a limit order
const result = await client.placeOrder({
  marketId: 123,
  tokenId: 'token_yes',
  side: OrderSide.BUY,
  orderType: OrderType.LIMIT_ORDER,
  price: '0.55',
  makerAmountInQuoteToken: '100',
});

Market Analytics

Aggregate and analyze market data for research or monitoring dashboards.

analytics.ts

// Get all active markets
const markets = await client.getMarkets({ status: TopicStatusFilter.ACTIVATED, limit: 100 });

// Analyze orderbook depth
const orderbook = await client.getOrderbook('token_123');
console.log('Orderbook:', orderbook.result);

Portfolio Management

Track positions and balances across multiple markets.

portfolio.ts

// Get user positions
const positions = await client.getMyPositions({ limit: 50 });

// Get balances
const balances = await client.getMyBalances();

// Get trade history
const trades = await client.getMyTrades({ marketId: 123 });

Architecture

The Opinion CLOB TypeScript SDK is built with a modular architecture:

+---------------------------------------------+
|          Application Layer                   |
|        (Your TypeScript Code)                |
+--------------+------------------------------+
               |
+--------------v------------------------------+
|         Opinion CLOB SDK                     |
|  +--------------+   +-----------------+      |
|  | Client API   |   | Contract Caller |      |
|  | (REST)       |   | (Blockchain)    |      |
|  +------+-------+   +----------+------+      |
+---------+----------------------+-------------+
          |                      |
+---------v----------+  +-------v------------+
|  Opinion API       |  |     Blockchain     |
|  (CLOB Exchange)   |  |  (Smart Contracts) |
+--------------------+  +--------------------+

Quick Links

• Installation Guide

• Quick Start

• Core Concepts

• API Reference

• FAQ

Ready to get started? Head to the Installation Guide to begin building with Opinion CLOB TypeScript SDK!