Skip to main content
skill CX Codex

deepbook-predict — Claude Code skill: Sui markets

This Claude Code skill covers DeepBook Predict integration for prediction markets on Sui. It explains position creation, settlement, and the liquidity pool.

Apache-2.0 181 installs ★ 25 updated 2026-11-12

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code
Open on GitHub

What deepbook-predict does

The skill explains how to integrate DeepBook Predict in TypeScript, from minting and redeeming positions to reading market states and handling settlement. Each position represents a strike range; a directional position is a range above or below the strike. The examples import @mysten/deepbook-v3 and @mysten/deepbook-v3/predict.

Store marketId alongside orderId: an order ID is unique only within its market, and a partial close produces a replacement ID. Quantity is the maximum payout and must use whole 0.01 USDC lots. Expired markets can remain unsettled in the market list, and quoting against one aborts. The skill also covers PoolVault and PLP shares; getConfig(network).quoteCoinType supplies the collateral coin type.

What it helps with

  • mint a position for a chosen strike range
  • persist an order ID with its market ID
  • check whether an expired market has settled
  • understand PoolVault deposits and withdrawals

Example prompts for the agent

  • Show me how to mint a DeepBook Predict position in TypeScript.
  • Explain how to store marketId and orderId after a partial close.
  • How do I check settlement and withdraw PLP shares?

How to install deepbook-predict

1Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code

2Manually: put the files in place

~/.claude/skills/deepbook-predict/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/deepbook-predict/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about deepbook-predict

How do I install deepbook-predict in Claude Code?

Run npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code. The skill file is at ~/.claude/skills/deepbook-predict/SKILL.md.

What does deepbook-predict do?

It guides TypeScript integration with DeepBook Predict on Sui, including positions, market states, settlement, and PoolVault liquidity with PLP shares.

How is deepbook-predict different from deepbook-sdk?

deepbook-predict covers prediction markets. Use deepbook-sdk for spot trading.

Source text

SKILL.md · Apache-2.0
---
name: deepbook-predict
description: >
  Guides DeepBook Predict integration on Sui: expiry-based prediction markets
  where every position is a strike range, minting and redeeming positions,
  market lifecycle and settlement, order ID handling, and the PoolVault/PLP
  liquidity pool. Use when the user asks about DeepBook Predict, Sui prediction
  markets, binary, directional, or range positions, strikes and expiry, quoting,
  settlement or try_settle, market states, PLP shares, the predict vault,
  quoteCoinType, or code importing `@mysten/deepbook-v3/predict`. For spot
  trading use the `deepbook-sdk` skill; for margin, `deepbook-margin`; for
  architecture, `deepbook-overview`.
---

# DeepBook Predict

Expiry-based prediction markets on Sui. Each market covers one underlying and one expiry timestamp. Predict is not a perpetual market.

If an API or parameter is not shown here or in the reference files, check docs.sui.io and the `deepbookv3` repository rather than extrapolating from other prediction protocols.

## Quick start

```ts
import { DeepBookClient } from '@mysten/deepbook-v3';
import { getConfig } from '@mysten/deepbook-v3/predict';

// Deployment IDs and coin types are per-network. Never hardcode a symbol.
const config = getConfig(network);           // 'testnet' | 'mainnet'
const collateral = config.quoteCoinType;

// `active` means live and NOT YET SETTLED — expired-but-unsettled markets are
// still returned here, and quoting against them aborts.
const markets = await client.predict.read.markets();
const tradable = markets.filter((m) => !m.is_settled);
```

## Task: explain Predict and its position types

- **Every position is a range contract.** It pays a fixed amount if the settlement price lands inside the chosen strike range, and nothing otherwise.
- **A directional ("binary") position is a one-sided range.** Side `up` pays when settlement lands above the strike; side `down` pays when it lands at or below it.
- **Quantity is the maximum payout in USDC**, not a share count, and must be a whole lot of 0.01 USDC (10,000 base units at 6 decimals).
- **Liquidity providers** supply USDC to a shared pool, receive PLP shares, and take the other side of every trade.

Payoff detail and worked examples: `positions-and-oracles.md`.

## Task: mint a position in TypeScript

Checklist:

1. `getConfig(network)` → deployment IDs and `quoteCoinType`.
2. `client.predict.read.markets()` → pick a market that is not settled.
3. Build the mint call (market, side or strike range, quantity in whole 0.01 USDC lots). Exact argument names: `workflow.md`.
4. Execute, then decode the order ID from the **transaction result** — it exists nowhere else.
5. Persist `{ marketId, orderId }` together.
6. Re-read the order ID after any partial close.

```ts
const tx = new Transaction();
client.predict.mint(tx, mintArgs); // see workflow.md for mintArgs

const result = await suiClient.signAndExecuteTransaction({
  transaction: tx,
  signer: keypair,
  options: { showEvents: true, showObjectChanges: true },
});

const { orderId } = client.predict.decode.mint(result);
await store.save({ marketId, orderId }); // both, always
```

Why both IDs: an order ID is unique only inside one market, so redeem and claim need the market ID alongside it. Closing part of a position replaces the order ID with a new one — the old ID no longer resolves.

## Task: market states and settlement

- `active` means live and not yet settled. It does **not** mean "not expired".
- An expired market that nobody has settled is still returned by `read.markets()`, and quoting against it aborts.
- Read the lifecycle state from the market — `is_settled`, or `try_settlement_price` — instead of comparing the expiry timestamp to the clock.
- A market becomes settled when someone calls `try_settle` and it succeeds. The gap between expiry and settlement has no fixed duration.
- After settlement, positions are claimed/redeemed against the settlement price: full notional if the price landed in range, zero otherwise.

```ts
const price = await client.predict.read.try_settlement_price(marketId);
if (!price) {
  // expired or not: still unsettled — do not quote, do not claim
}
```

State machine detail: `positions-and-oracles.md`.

## Task: vault and PLP liquidity

- The Predict pool, **PoolVault**, is the counterparty to every trade.
- Liquidity providers deposit the pool's collateral coin (USDC) and receive **PLP** shares — a 6-decimal coin matching USDC's decimals.
- PLP is a proportional claim on pool value, so its value tracks pool profit and loss rather than paying a fixed yield.
- Read the exact collateral coin type from `getConfig(network).quoteCoinType`; do not assume a symbol.
- Withdrawals require available liquidity after covering maximum payout obligations, and large withdrawals may be throttled.

Supply/withdraw calls: `workflow.md`.

## Task: common mistakes

| Mistake | Do instead |
|---|---|
| Assuming the collateral coin symbol | Read `getConfig(network).quoteCoinType` |
| Inferring settlement from the expiry timestamp | Read `is_settled` or `try_settlement_price` |
| Quoting an expired market from `read.markets()` | Filter out unsettled-but-expired markets; quoting them aborts |
| Hardcoding package or object IDs | Treat them as pinned to a deployment; read them for the target network |
| Storing only the order ID | Store `{ marketId, orderId }`; order IDs are market-scoped |
| Reusing an order ID after a partial close | Decode the new order ID from that transaction's result |
| Quantity that is not a whole 0.01 USDC lot | Round to whole lots; quantity is maximum payout |
| Treating positions as perpetual | Every position expires and is claimed after settlement |

## Reference files

- `positions-and-oracles.md` — payoffs, market lifecycle, settlement mechanics, vault/PLP model.
- `workflow.md` — exact call arguments for mint, redeem, claim, LP supply and withdraw.
- `contract-info.md` — per-deployment IDs, coin types, server endpoint, event types.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Similar skills

All skills for Finance and business →

From the same set30

The whole set →
deepbook-overview The deepbook-overview Claude Code skill explains DeepBook V3 on Sui and its integration options. It activates for questions about the order book, pool internals, DEEP, or mainnet IDs. CX Codex +1 183installs deepbook-sdk The deepbook-sdk Claude Code skill covers TypeScript integration with DeepBook V3 pools. It activates for trading apps, bots, and scripts built with @mysten/deepbook-v3. CX Codex +1 183installs deepbook-margin The deepbook-margin Claude Code skill explains margin trading on DeepBook on Sui. It covers borrowed positions, collateral, risk ratios, and liquidation. CX Codex +1 181installs deepbook-move The deepbook-move Claude Code skill guides Move contract work with DeepBook V3. It covers pools, orders, swaps, flash loans, and BalanceManager permissions. CX Codex +1 181installs sui-ts-sdk-backend The sui-ts-sdk-backend Claude Code skill covers backend services and agents that interact with Sui through the TypeScript SDK. It is invoked for client setup, transaction signing, package publishing, and high-throughput execution. CX Codex +1 167installs zklogin Explains zkLogin and guides its integration into Sui apps. It activates for questions about OpenID providers, address derivation, session lifetime, or security. CX Codex +1 164installs kiosk This Claude Code skill supports writing, reviewing, and debugging Move code for Sui Kiosk. It covers asset trading, NFT listings, TransferPolicy, and Kiosk extensions. CX Codex +1 162installs onchain-randomness Guides onchain randomness implementation in Sui Move. Secures functions using the 0x8 Random object against composition and PTB attacks. CX Codex +1 162installs

Project sponsors

Companies that keep this analytics open