限流与配额
API 限流
每个租户一个令牌桶：
| 方案 | 每秒请求数 | 可短暂突发 |
|---|---|---|
| 付费方案 | 100 | 200 |
| 沙箱 | 20 | 40 |
| 免费展示方案 | 5 | 10 |
- 以租户为单位计算（同一个租户的所有密钥共用），平台可对个别租户调整。
- 只计算通过签名验证的请求。
- 超过时回
429 RATE_LIMITED：请退避后重试（例如 200 ms、400 ms、800 ms…，加上随机延迟），每次重试都用新的 nonce 与时间戳。 - 减少调用次数：注单以游标批量读取（每页最多 1,000 笔），不要逐笔查询；余额以转账响应的
balance更新，不必每次再查。
其他限制
| 项目 | 限制 |
|---|---|
| 请求体 | 64 KB |
X-Timestamp 时间窗 | 与服务器时间差 ±300 秒 |
X-Nonce | 16–64 个字母或数字，10 分钟内不可重复 |
玩家账号 username | 1–32 个字符：字母或数字与 _ . @ -，不分大小写 |
转账单号 txnId | 1–64 个字符：字母或数字与 _ . : - |
| 金额 | 十进制字符串，最多 4 位小数 |
GET /bets | 每页 1–1,000 笔（默认 500） |
GET /bets/summary | 最多 1,000 位玩家 |
GET /wallet/transfer | 租户流水查询当月与前 3 个月（UTC）；带 username 时也查玩家钱包的记录 |
| 启动网址 | 60 秒内有效、只能使用一次 |
| 玩家 session | 最长 12 小时；闲置 60 分钟自动登出 |
| API 密钥 | 每个环境最多 10 把；轮替后旧密钥 24 小时内仍有效 |
| IP 白名单 | 最多 100 笔 |
| 注单可查询期间 | 付费方案约 400 天；免费展示方案 7 天（以整月为单位清除，当月与上个月一律保留） |
免费展示方案的限制
免费方案用来展示功能，不适合正式营运。以下是默认值（平台可调整，也可以对个别租户放宽）；账户在宽限期后被自动降级（DOWNGRADED）时也套用同样的限制。沙箱租户也适用这些限制，但为了对接测试放宽了人数与限流，见沙箱。
| 项目 | 默认 |
|---|---|
| 可激活桌数 | 2 |
| 同时在线玩家（整个租户） | 10 |
| 玩家账号总数 | 50（超过时创建玩家回 PLAYER_LIMIT） |
| 单注限红 | 固定使用平台的「展示」限红 |
| 每日总投注上限（UTC 日） | 约 1,000 USD 等值：USD 1,000、TWD 30,000、CNY 7,000、HKD 7,800、THB 35,000、VND 25,000,000、PHP 56,000、MYR 4,700、JPY 150,000、KRW 1,350,000、USDT 1,000；达到后当天停止收注 |
| 视频 | 同时观看 3 人；每次连续观看最长 30 分钟；视频流费从预付额度扣（含注册赠送的额度） |
| 画面 | 游戏固定显示「展示版」浮水印，不能自订品牌 |
| 不开放的功能 | Webhook、单一钱包、导出、子账号、自订品牌 |
| API 限流 | 每秒 5 次 |
| 注单保留 | 7 天 |
| 闲置 | 14 天没有登录 Console 也没有下注 → 自动暂停桌台；登录 Console 即恢复 |
| 试用期限 | 不限 |
沙箱
沙箱租户适用上面的免费展示方案限制，但以下三项至少放宽为：
| 项目 | 沙箱 |
|---|---|
| 同时在线玩家 | 50 |
| 玩家账号总数 | 500 |
| API 限流 | 每秒 20 次（可短暂突发到 40） |
视频、每日投注上限、展示限红与浮水印等其他限制与免费展示方案相同。
付费方案
- 桌数没有配额：每张激活的桌每月 100 USD，依日按比例从预付额度扣。
- 没有展示限制，可使用 Webhook 与自订品牌；API 每秒 100 次。
- 费用、充值、宽限与降级规则见计费说明。