Introduction

@voiz/markets-sdk is the TypeScript SDK for Voiz markets on EVM. List markets, seed pools, trade, add liquidity, and read positions — with viem under the hood.

Install

npm install @voiz/markets-sdk viem

pnpm add @voiz/markets-sdk viem

yarn add @voiz/markets-sdk viem

React apps also need the React peer (optional for vanilla viem):

npm install react

Import paths:

@voiz/markets-sdk — VoizMarketsClient, helpers (quoteSeed, normalizeOddsBps, getAddresses), types, erc20Abi
@voiz/markets-sdk/react — VoizProvider, useVoiz

Mental model

Access everything through a client, then drill down:

client.market(address)  // status, seed, resolve, LP across outcomes
client.pool(token)      // quoteTrade, swap
client.user(address)    // trades, sharePositions, LP

Writes use an injected sendCalls (or a walletClient fallback). Call market.seed, pool.swap, and similar — the client submits for you.

Next steps

Key concepts

Client → Market → Pool → User, quotes vs writes, indexer vs RPC.

Quickstart: React / Next.js

Wrap your app with VoizProvider, then use useVoiz().client.

Quickstart: vanilla viem

Construct VoizMarketsClient without React.

Create a market

Step-by-step flows after you are set up.

Get started

Guides

API reference

Install

Mental model

Next steps

Key concepts

Quickstart: React / Next.js

Quickstart: vanilla viem

Create a market

​Install

​Mental model

​Next steps

Key concepts

Quickstart: React / Next.js

Quickstart: vanilla viem

Create a market

Install

Mental model

Next steps