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]

示例：

• 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]

示例：

• 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]

示例：

• 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>]

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>

下单自动设置 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]

示例：

• 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>]

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

示例：

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

SDK 信息

手续费

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

订单类型

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

错误参考

重要地址