К основному содержанию
скилл CX Codex

deepbook-predict — скилл для Claude Code: рынки Sui

Скилл для Claude Code объясняет интеграцию DeepBook Predict с рынками прогнозов на Sui. Помогает создавать и закрывать позиции, разбирать расчёт и работу пула ликвидности.

Apache-2.0 181 установок ★ 25 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code
Открыть на GitHub

Что делает deepbook-predict

Скилл описывает интеграцию DeepBook Predict в TypeScript: создание и погашение позиций, состояния рынка и расчёты после экспирации. Каждая позиция задаёт диапазон цены; направленная позиция задаёт диапазон выше или ниже страйка. Для вызовов используются @mysten/deepbook-v3 и @mysten/deepbook-v3/predict.

При создании позиции нужно сохранить вместе marketId и orderId: идентификатор ордера уникален только внутри рынка, а частичное закрытие выдаёт новый. Количество задаётся целыми лотами по 0.01 USDC и означает максимальную выплату. Истёкший, но ещё не рассчитанный рынок остаётся в списке и отклоняет котировку. Скилл также описывает PoolVault и доли PLP; тип залоговой монеты берётся из getConfig(network).quoteCoinType.

Какие задачи решает

  • создать позицию с диапазоном страйка
  • сохранить идентификатор ордера вместе с рынком
  • определить, рассчитан ли рынок после экспирации
  • разобрать депозиты и вывод средств из PoolVault

Примеры запросов агенту

  • Покажи, как создать позицию DeepBook Predict в TypeScript.
  • Объясни, как хранить marketId и orderId после частичного закрытия.
  • Как проверить расчёт рынка и вывести доли PLP?

Как установить deepbook-predict

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/deepbook-predict/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о deepbook-predict

Как установить deepbook-predict в Claude Code?

Выполни npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code. Файл скилла находится по пути ~/.claude/skills/deepbook-predict/SKILL.md.

Что делает deepbook-predict?

Помогает разрабатывать интеграцию DeepBook Predict на Sui: создавать позиции, читать состояния рынков, разбирать расчёт и работу пула PoolVault с долями PLP.

Чем deepbook-predict отличается от deepbook-sdk?

deepbook-predict посвящён рынкам прогнозов. Для спотовой торговли предназначен deepbook-sdk.

Исходный текст

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

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
matchwire.win — Mapped Prediction Markets (Kalshi, Polymarket, Predict.fun) MatchWire-Win matchwire.win — Mapped Prediction Markets (Kalshi, Polymarket, Predict.fun) — MCP-сервер Claude Code. Сводит матч с Kalshi, Polymarket US/International и Predict.fun в строку с id. CX Codex +1 autopilot-predict ruvnet Скилл autopilot-predict для Claude Code выбирает следующую задачу по состоянию работы и накопленным паттернам. В каждой итерации определяет, что делать дальше. CX Codex +1 744установок anycap-worldcup-predict anycap-ai Скилл anycap-worldcup-predict собирает досье на игроков и сборные через AnyCap, а затем делает шуточный прогноз на матч чемпионата мира с указанием уверенности. CX Codex +1 642установок easy-predict rizzi-williams MCP-сервер easy-predict прогнозирует следующее значение числового ряда и ищет аномалии. Подходит для задач, где агенту нужен расчёт по данным. CX Codex +1 140установок hard-predict-future davepoon Скилл hard-predict-future для Claude Code и Cursor анализирует будущее по сигналам, историческим аналогиям и сценариям. Разбирает прогнозы о рынках, технологиях и геополитике. CX Codex +1 ★ 3 785звёзд репо soft-predict-future davepoon Скилл soft-predict-future разбирает вопросы о будущем через веб-поиск и структурированный анализ сигналов. Подходит для прогнозов, сценариев и оценки того, куда движется технология или рынок. CX Codex +1 ★ 3 785звёзд репо

Из того же набора30

Весь набор →
deepbook-overview Скилл deepbook-overview для Claude Code объясняет устройство DeepBook V3 на Sui и варианты интеграции. Запускается на вопросах о CLOB, пулах, токене DEEP и адресах mainnet. CX Codex +1 183установок deepbook-sdk Скилл deepbook-sdk для Claude Code помогает подключить TypeScript-приложение к пулам DeepBook V3. Включается при разработке торговых приложений, ботов и скриптов на @mysten/deepbook-v3. CX Codex +1 183установок deepbook-margin Скилл deepbook-margin для Claude Code объясняет маржинальную торговлю в DeepBook на Sui. Подключается к задачам с заёмными позициями, залогом, рисками и ликвидацией. CX Codex +1 181установок deepbook-move Скилл deepbook-move для Claude Code помогает писать и отлаживать Move-контракты с DeepBook V3. Он подключается к вопросам о пулах, ордерах, обменах, флеш-займах и правах BalanceManager. CX Codex +1 181установок sui-ts-sdk-backend Скилл sui-ts-sdk-backend для Claude Code помогает писать серверный код и агентов, которые работают с Sui через TypeScript SDK. Подключается для настройки клиента, подписания транзакций и запуска их сериями. CX Codex +1 167установок zklogin Объясняет устройство zkLogin и помогает интегрировать вход через OAuth в приложения на Sui. Подключается к вопросам о провайдерах OpenID, адресах, сроке сессии и безопасности. CX Codex +1 164установок kiosk Помогает писать, проверять и отлаживать Move-код с Sui Kiosk. Он подключается к задачам с торговлей активами, NFT и расширениями Kiosk. CX Codex +1 162установок onchain-randomness Скилл onchain-randomness для Claude Code настраивает работу с генератором случайных чисел в смарт-контрактах Sui Move. Защищает функции от атак композиции и утечек состояния. CX Codex +1 162установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой