契约基础
全站有五种定点记法,分布在三条线上,一半是 JSON 整数、一半是字符串。照错线写的代码不会报错,只会算错。这页先给对照表,再列会静默出错的地方。
| 线 | 前缀 | 鉴权 | 价 / 量 | 方向 |
|---|---|---|---|---|
| Trading API | /api/v1 | Bearer 会话 | 价 E4 · 量 E2 · 金额 E6(整数) | YES | NO |
| PX 发现与账户 | /api/v1/px | 公开读 / Bearer 会话 | 一律 E6 十进制字符串 | A | B |
| Market Maker API | /v1/px | pxk_ API key | 一律 E6 十进制字符串 | A | B |
三个前缀只差一段,精度差一百倍,枚举记法也不同——接口页的端点条上常驻这个标记,任何时候都能确认自己在哪条线上。
| 记法 | 含义 | 例 | JSON 类型 |
|---|---|---|---|
E4 | 1e-4 USD。Trading API 的价格 | 5200 = 0.5200 USD | 整数 |
E2 | 1e-2 份。Trading API 的数量 | 1000 = 10.00 份 | 整数 |
E6 | 1e-6 USD 或 1e-6 份。Trading API 的金额、PX 两条线的一切价量金额 | 520000 = 0.520000 | Trading API 整数 · PX 两条线字符串 |
ppm | 百万分之一。手续费率 | 2000 ppm = 0.2% | 整数 |
bps | 万分之一。健康度、利率、保证金率、回报率 | 1500 bps = 15% | 字符串 |