基于 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。

前置条件

• 安装 bun:

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

• 创建 .env 文件:

   PRIVATE_KEY=0x_your_eoa_private_key
   MULTI_SIG_ADDRESS=0x_your_opinion_builtin_wallet_address
   API_KEY=your_opinion_api_key
   

网站前置步骤

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

入门流程

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

数据来源说明

• 数据查询 (市场/价格/订单簿/持仓等): 使用 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  [--limit ]                                    # 搜索市场
bun run scripts/markets.ts [--limit ] [--offset ] [--json]                     # 浏览市场/事件列表
bun run scripts/market-detail.ts  [--json]                                 # 市场详情
bun run scripts/price.ts  [ ...] [--json]                         # 查询价格
bun run scripts/orderbook.ts  [--json]                                      # 查看订单簿
bun run scripts/positions.ts 
 [--limit ] [--json]                        # 查看持仓
bun run scripts/trades.ts  [--limit ] [--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  --token  --price 
 --amount  [--type market|limit]
bun run scripts/sell.ts --market  --token  --price 
 --shares  [--type market|limit]
bun run scripts/orders.ts [--market ] [--status open] [--json]                   # 查看订单
bun run scripts/cancel.ts --order                                           # 取消单个订单
bun run scripts/cancel.ts --all [--market ]                                # 取消全部订单

脚本用法详解

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

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

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 方向。