0xProbable Markets CLOB Skills

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

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

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

CODEBLOCK0

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

CODEBLOCK1

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

前置条件

1. 1. 安装 bun（如已安装则跳过）：

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

1. 2. 创建 .env 文件：

CODEBLOCK3

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

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

网站前置步骤

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

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

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

入门流程

1. 1. 填写 .env（PRIVATE_KEY）
2. INLINECODE13 — 确认 USDT 余额充足
3. INLINECODE14 — 搜索感兴趣的市场
4. INLINECODE15 — 获取事件详情和 tokenId
5. 开始交易

命令速查

CODEBLOCK4

脚本用法详解

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

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

CODEBLOCK5

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

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

2. 搜索市场 — search.ts

CODEBLOCK6

参数	说明
INLINECODE18	搜索关键词（必填）
INLINECODE19

返回数量 |
| --json | 输出原始 JSON |

示例：

• - INLINECODE21
• INLINECODE22
• INLINECODE23

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

CODEBLOCK7

参数	说明
INLINECODE25	返回数量（默认 20）
INLINECODE26

跳过前 n 条（分页用） |
| --json | 输出原始 JSON |

示例：

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

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

CODEBLOCK8

参数	说明
INLINECODE31	事件 ID（必填）
INLINECODE32

输出原始 JSON |

示例：

• - INLINECODE33

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

CODEBLOCK9

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

示例：

• - INLINECODE35
• INLINECODE36

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

CODEBLOCK10

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

CODEBLOCK11

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

CODEBLOCK12

参数	说明
INLINECODE40	时间窗口

9. 订单簿 — orderbook.ts

CODEBLOCK13

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

10. 买入 — buy.ts

CODEBLOCK14

参数	说明
INLINECODE43	Token ID（从 get-event 获取）
INLINECODE44

限价价格（0-1 之间） |
| --size <S> | Share 数量 |

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

11. 卖出 — sell.ts

CODEBLOCK15

参数同买入。

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

CODEBLOCK16

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

CODEBLOCK17

14. 查看持仓 — positions.ts

CODEBLOCK18

参数	说明
INLINECODE51	事件 ID（必填）
INLINECODE52

显示盈亏信息 |
| --trades | 显示交易记录 |
| --json | 输出原始 JSON |

示例：

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

15. 提取 USDT — withdraw.ts

CODEBLOCK19

参数	说明
INLINECODE60	提取金额（可选，默认提取全部）

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

示例：

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

SDK 信息

项目	值
SDK	INLINECODE63 v0.5.0
链

BSC 主网 (chainId: 56) | | 抵押品 | USDT (18 decimals) | | RPC | https://bsc-dataseed.bnbchain.org |

手续费

项目	说明
Taker 费率	0.01% - 1.75%
feeRateBps

175（下单时设置，对应最高 1.75%） |

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

订单类型

类型	全称	行为
GTC	Good Till Cancelled	限价单，挂单直到成交或手动取消
IOC

Immediate or Cancel | 市价单，立即尽可能成交，剩余取消 | | FOK | Fill or Kill | 市价单，必须全部成交否则整单取消 |

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

错误参考

错误	说明	解决
INLINECODE66	未配置私钥	在 .env 中设置 PRIVATEKEY
INLINECODE68

签名地址非 Safe owner | 检查 PRIVATEKEY 对应的地址 | | 余额不足 | USDT 余额不够下单 | 充值或从 EOA 转入 proxy wallet | | proxy wallet 不匹配 | 使用了错误的链 | 确保 chainId=56 (BSC 主网) | | Gas 不足 | BNB 余额不够支付 Gas | 向 EOA 充值 BNB |

重要地址

名称	地址
USDT (BSC)	INLINECODE69
Proxy Wallet

0xE1e2380cDe7d1822ACbD097E85f72040AB106f42 | | EOA | 0xDDDddDcF23631d075C48e4669a5c0C227d5DdddD |