shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程需要 API Key

Probable Skill

在BSC主网上进行0xProbable预测市场交易的技能。利用@prob/clob SDK，通过CLOB订单簿交易现实世界事件的结果份额（是/否）。

person作者: ternencescotthubclawhub
open_in_new仓库download下载资源包

0xProbable Markets CLOB Skills

基于 bun 运行时的 0xProbable CLOB 交易工具集 (BSC 链)。

环境检查（首次使用必读）

在执行任何脚本之前，请先检查 scripts/ 目录是否存在：

ls scripts/config.ts 2>/dev/null && echo "scripts 目录已就绪" || echo "scripts 目录缺失，请执行下方 clone 命令"

如果 scripts/ 目录不存在或缺失关键文件，请克隆仓库：

git clone git@github.com:user/0xprobableskills.git && cd 0xprobableskills

注意：所有命令均需在仓库根目录（包含 scripts/ 和 package.json 的目录）下执行。

前置条件

  1. 安装 bun（如已安装则跳过）： 
    command -v bun >/dev/null 2>&1 && echo "bun 已安装: $(bun --version)" || { curl -fsSL https://bun.sh/install | bash && source ~/.bashrc; }
  2. 创建 .env 文件： 
    PRIVATE_KEY=<你的钱包私钥>

bun 具备 auto-install 能力，无需手动 bun add / bun install，依赖版本由 package.json 和 bun.lock 锁定。

安全提醒：PRIVATE_KEY 拥有钱包完全控制权，切勿泄露。确保 .env 已加入 .gitignore。

网站前置步骤

使用前必须在 0xProbable Markets 网站上完成：

  1. 注册账户 — 前往 0xProbable Markets 注册登录
  2. Enable Trading — 链上创建 proxy wallet (Gnosis Safe)，完成 USDT 授权
  3. 充值 USDT — 向 proxy wallet 充值（BSC 链 USDT）

完成后获得 PRIVATE_KEY，填入 .env 即可。

入门流程

  1. 填写 .env（PRIVATE_KEY）
  2. bun run scripts/check-balance.ts — 确认 USDT 余额充足
  3. bun run scripts/search.ts <关键词> — 搜索感兴趣的市场
  4. bun run scripts/get-event.ts <event_id> — 获取事件详情和 tokenId
  5. 开始交易

命令速查

bun run scripts/check-balance.ts                                    # 检查余额 (USDT + BNB)
bun run scripts/search.ts <关键词> [--limit <n>] [--json]           # 搜索市场
bun run scripts/list-events.ts [--limit <n>] [--offset <n>] [--json]  # 浏览事件列表
bun run scripts/list-tags.ts <event_id> [--json]                    # 获取事件标签
bun run scripts/get-event.ts <event_id_or_slug> [--json]            # 获取事件详情
bun run scripts/get-market.ts <market_id> [--json]                  # 获取市场详情
bun run scripts/price-info.ts <token_id> [--json]                   # 获取价格信息
bun run scripts/price-history.ts <token_id> [--interval <interval>] # 历史价格
bun run scripts/orderbook.ts <token_id> [--json]                    # 查看订单簿
bun run scripts/buy.ts --token <ID> --price <P> --size <S>          # 限价买入
bun run scripts/sell.ts --token <ID> --price <P> --size <S>         # 限价卖出
bun run scripts/check-orders.ts [--event <EVENT_ID>]                # 查看挂单
bun run scripts/cancel-orders.ts --order <ID>                       # 取消订单
bun run scripts/positions.ts [--event <ID>] [--token <ID>] [--pnl]  # 查看持仓
bun run scripts/withdraw.ts [--amount <USDT>]                       # 从 proxy wallet 提取 USDT

脚本用法详解

1. 检查余额 — check-balance.ts

查询 EOA 和 Proxy Wallet 的 USDT 余额，以及 EOA 的 BNB 余额（Gas 费用）。

bun run scripts/check-balance.ts

输出：EOA 地址、Proxy Wallet 地址、两者的 USDT 余额、USDT 合计、BNB 余额。

注意：BSC 上 USDT 使用 18 decimals（与 ETH 主网 6 decimals 不同）。

2. 搜索市场 — search.ts

bun run scripts/search.ts <关键词> [--limit <n>] [--json]

| 参数 | 说明 | |------|------| | <关键词> | 搜索关键词（必填） | | --limit <n> | 返回数量 | | --json | 输出原始 JSON |

示例：

  • bun run scripts/search.ts bitcoin
  • bun run scripts/search.ts "US election" --limit 5
  • bun run scripts/search.ts trump --json

3. 浏览事件 — list-events.ts

bun run scripts/list-events.ts [--limit <n>] [--offset <n>] [--json]

| 参数 | 说明 | |------|------| | --limit <n> | 返回数量（默认 20） | | --offset <n> | 跳过前 n 条（分页用） | | --json | 输出原始 JSON |

示例：

  • bun run scripts/list-events.ts — 默认列出 20 条事件
  • bun run scripts/list-events.ts --limit 10 --offset 20 — 第三页

4. 获取事件标签 — list-tags.ts

bun run scripts/list-tags.ts <event_id> [--json]

| 参数 | 说明 | |------|------| | <event_id> | 事件 ID（必填） | | --json | 输出原始 JSON |

示例：

  • bun run scripts/list-tags.ts 752

5. 获取事件详情 — get-event.ts

bun run scripts/get-event.ts <event_id_or_slug> [--json]

先尝试按 ID 查询，失败则按 slug 查询。输出事件标题、ID、状态、描述、市场列表及 tokenId。

示例：

  • bun run scripts/get-event.ts 752
  • bun run scripts/get-event.ts bitcoin-price --json

6. 获取市场详情 — get-market.ts

bun run scripts/get-market.ts <market_id> [--json]

7. 获取价格 — price-info.ts

bun run scripts/price-info.ts <token_id> [--json]

8. 历史价格 — price-history.ts

bun run scripts/price-history.ts <token_id> [--interval <interval>]

| 参数 | 说明 | |------|------| | --interval | 时间窗口 |

9. 订单簿 — orderbook.ts

bun run scripts/orderbook.ts <token_id> [--json]

获取完整 bids + asks，计算 spread 和中间价。

10. 买入 — buy.ts

bun run scripts/buy.ts --token <ID> --price <P> --size <S>

| 参数 | 说明 | |------|------| | --token <ID> | Token ID（从 get-event 获取） | | --price <P> | 限价价格（0-1 之间） | | --size <S> | Share 数量 |

下单自动设置 feeRateBps=175（最低手续费），订单类型 GTC（限价单）。

11. 卖出 — sell.ts

bun run scripts/sell.ts --token <ID> --price <P> --size <S>

参数同买入。

12. 查看挂单 — check-orders.ts

bun run scripts/check-orders.ts [--event <EVENT_ID>]

13. 取消订单 — cancel-orders.ts

bun run scripts/cancel-orders.ts --order <ID>

14. 查看持仓 — positions.ts

bun run scripts/positions.ts --event <EVENT_ID> [--pnl] [--trades] [--json]

| 参数 | 说明 | |------|------| | --event <ID> | 事件 ID（必填） | | --pnl | 显示盈亏信息 | | --trades | 显示交易记录 | | --json | 输出原始 JSON |

示例：

  • bun run scripts/positions.ts --event 752 — 查看持仓
  • bun run scripts/positions.ts --event 752 --pnl — 含盈亏
  • bun run scripts/positions.ts --event 752 --trades — 含交易记录
  • bun run scripts/positions.ts --event 752 --pnl --trades --json — 全部信息 JSON

15. 提取 USDT — withdraw.ts

bun run scripts/withdraw.ts [--amount <USDT>]

| 参数 | 说明 | |------|------| | --amount <USDT> | 提取金额（可选，默认提取全部） |

从 Proxy Wallet (Gnosis Safe) 提取 USDT 到 EOA。显示提取前后余额变化。

示例：

  • bun run scripts/withdraw.ts — 提取全部 USDT
  • bun run scripts/withdraw.ts --amount 100 — 提取 100 USDT

SDK 信息

| 项目 | 值 | |------|-----| | SDK | @prob/clob v0.5.0 | | 链 | BSC 主网 (chainId: 56) | | 抵押品 | USDT (18 decimals) | | RPC | https://bsc-dataseed.bnbchain.org |

手续费

| 项目 | 说明 | |------|------| | Taker 费率 | 0.01% - 1.75% | | feeRateBps | 175（下单时设置，对应最高 1.75%） |

feeRateBps=175n 表示 175 基点 = 1.75%，这是平台允许的最低手续费设置值。实际成交费率可能更低。

订单类型

| 类型 | 全称 | 行为 | |------|------|------| | GTC | Good Till Cancelled | 限价单，挂单直到成交或手动取消 | | IOC | Immediate or Cancel | 市价单，立即尽可能成交，剩余取消 | | FOK | Fill or Kill | 市价单，必须全部成交否则整单取消 |

价格范围：0 到 1（概率），精度 0.01 递增。

错误参考

| 错误 | 说明 | 解决 | |------|------|------| | PRIVATE_KEY not set | 未配置私钥 | 在 .env 中设置 PRIVATE_KEY | | 不是 proxy wallet 的 owner | 签名地址非 Safe owner | 检查 PRIVATE_KEY 对应的地址 | | 余额不足 | USDT 余额不够下单 | 充值或从 EOA 转入 proxy wallet | | proxy wallet 不匹配 | 使用了错误的链 | 确保 chainId=56 (BSC 主网) | | Gas 不足 | BNB 余额不够支付 Gas | 向 EOA 充值 BNB |

重要地址

| 名称 | 地址 | |------|------| | USDT (BSC) | 0x55d398326f99059ff775485246999027b3197955 | | Proxy Wallet | 0xE1e2380cDe7d1822ACbD097E85f72040AB106f42 | | EOA | 0xDDDddDcF23631d075C48e4669a5c0C227d5DdddD |