dvcrn 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的目录）下执行。
前置条件
- 安装 bun（如已安装则跳过）：
command -v bun >/dev/null 2>&1 && echo "bun 已安装: $(bun --version)" || { curl -fsSL https://bun.sh/install | bash && source ~/.bashrc; } - 创建
.env文件：PRIVATE_KEY=<你的钱包私钥>
bun 具备 auto-install 能力，无需手动
bun add / bun install，依赖版本由package.json和bun.lock锁定。
安全提醒：PRIVATE_KEY 拥有钱包完全控制权，切勿泄露。确保
.env已加入.gitignore。
网站前置步骤
使用前必须在 0xProbable Markets 网站上完成：
- 注册账户 — 前往 0xProbable Markets 注册登录
- Enable Trading — 链上创建 proxy wallet (Gnosis Safe)，完成 USDT 授权
- 充值 USDT — 向 proxy wallet 充值（BSC 链 USDT）
完成后获得 PRIVATE_KEY，填入 .env 即可。
入门流程
- 填写
.env（PRIVATE_KEY） bun run scripts/check-balance.ts— 确认 USDT 余额充足bun run scripts/search.ts <关键词>— 搜索感兴趣的市场bun run scripts/get-event.ts <event_id>— 获取事件详情和 tokenId- 开始交易
命令速查
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 bitcoinbun run scripts/search.ts "US election" --limit 5bun 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 752bun 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— 提取全部 USDTbun 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 |