Opinion CLOB Skills

基于 bun 运行时的 Opinion 预测市场交易工具集。

仓库源

https://github.com/Yuandiaodiaodiao/opinion-skill

如果本地没有 scripts 目录，先克隆仓库：

git clone https://github.com/Yuandiaodiaodiao/opinion-skill.git /root/opinionskills

环境检查

ls /root/opinionskills/scripts/config.ts 2>/dev/null && echo "scripts ready" || { echo "scripts missing, cloning..."; git clone https://github.com/Yuandiaodiaodiao/opinion-skill.git /root/opinionskills; }

> 所有命令均需在 /root/opinionskills/ 目录下执行。bun 可直接执行 .ts 文件，无需 bun install。

前置条件

1. 安装 bun:

```bash

command -v bun >/dev/null 2>&1 && echo "bun $(bun --version)" || { curl -fsSL https://bun.sh/install | bash && source ~/.bashrc; }

```

1. 创建 .env 文件:

```

PRIVATE_KEY=0x_your_eoa_private_key

MULTI_SIG_ADDRESS=0x_your_opinion_builtin_wallet_address

API_KEY=your_opinion_api_key

```

网站前置步骤

1. 前往 Opinion 平台注册账户
2. 平台会自动创建内置钱包 (Gnosis Safe 多签钱包, BSC 链)
3. Enable Trading (链上授权, 需要 BNB gas)
4. 充值 USDT 到内置钱包

入门流程

1. 填写 .env
2. bun run scripts/enable-trading.ts — 一次性链上授权
3. bun run scripts/balances.ts — 确认余额
4. 开始交易

数据来源说明

• 数据查询 (市场/价格/订单簿/持仓等): 使用 API http://newopinion.predictscanapi.xyz:10001
• 交易操作 (下单/取消/余额): 使用 @opinion-labs/opinion-clob-sdk
• tokenId = assetId: 两者是同一概念，可互换使用

环境变量与权限分级

数据查询脚本（search、markets、market-detail、price、orderbook、positions、trades、top-markets）不需要任何环境变量，也不需要 bun install，克隆仓库后即可直接运行。

交易操作脚本（buy、sell、cancel、orders、balances、enable-trading）必须先 bun install 安装 SDK 依赖，并配置 .env。如果用户尝试执行交易操作但未配置环境变量，脚本会报错提示缺少 PRIVATE_KEY / MULTI_SIG_ADDRESS / API_KEY。

执行交易操作前，先确认 .env 是否已配置：

test -f /root/opinionskills/.env && grep -q "PRIVATE_KEY=0x" /root/opinionskills/.env && echo "Trading credentials configured" || echo "WARNING: .env not configured — only market data queries are available. To trade, create /root/opinionskills/.env with PRIVATE_KEY, MULTI_SIG_ADDRESS, and API_KEY."

如果用户要求下单但 .env 未配置，不要执行交易脚本，而是提示用户先配置环境变量。

命令速查

# 数据查询 (API)
bun run scripts/search.ts <keyword> [--limit <n>]                                    # 搜索市场
bun run scripts/markets.ts [--limit <n>] [--offset <n>] [--json]                     # 浏览市场/事件列表
bun run scripts/market-detail.ts <marketId> [--json]                                 # 市场详情
bun run scripts/price.ts <assetId> [<assetId2> ...] [--json]                         # 查询价格
bun run scripts/orderbook.ts <assetId> [--json]                                      # 查看订单簿
bun run scripts/positions.ts <address> [--limit <n>] [--json]                        # 查看持仓
bun run scripts/trades.ts <assetId> [--limit <n>] [--filter all|taker|maker] [--json] # 成交记录
bun run scripts/top-markets.ts [--tag volume|txn] [--window 1h|4h|24h] [--json]      # 热门市场

# 交易操作 (SDK)
bun run scripts/enable-trading.ts                                                     # 启用交易 (一次性)
bun run scripts/balances.ts [--json]                                                  # 查看余额
bun run scripts/buy.ts --market <ID> --token <TOKEN_ID> --price <P> --amount <AMT> [--type market|limit]
bun run scripts/sell.ts --market <ID> --token <TOKEN_ID> --price <P> --shares <N> [--type market|limit]
bun run scripts/orders.ts [--market <ID>] [--status open] [--json]                   # 查看订单
bun run scripts/cancel.ts --order <ORDER_ID>                                          # 取消单个订单
bun run scripts/cancel.ts --all [--market <MARKET_ID>]                                # 取消全部订单

脚本用法详解

1. 搜索市场 — search.ts [--limit ]

搜索 Opinion 市场，返回匹配的市场列表及其 tokenId。

输出: 市场标题、marketId、yesTokenId、noTokenId、所属 Event。

2. 浏览市场 — markets.ts [options]

浏览所有市场和事件 (WrapEvent 统一格式)。

3. 市场详情 — market-detail.ts [--json]

获取单个市场的完整信息，包括 tokenId、状态、规则、子市场等。

4. 查询价格 — price.ts [ ...] [--json]

单个 assetId 返回 lastPrice/bestBid/bestAsk/mid (从 orderbook 计算)。

多个 assetId 使用 batchprice 接口，返回 price 和 source。

5. 查看订单簿 — orderbook.ts [--json]

获取完整 bids + asks，计算 spread 和中间价。显示前 10 档。

6. 查看持仓 — positions.ts

[--limit ] [--json]

查询指定地址的持仓。自动批量查询市场信息，显示 YES/NO 方向。