错误处理
HTTP 与业务错误
- 部分接口失败时仍可能返回 HTTP 200。
- 集成侧必须检查响应
code。
交易服务错误码
交易服务错误可能使用字符串 code。
示例：
{
"code": "INVALID_INPUT",
"message": "token addresses cannot be empty"
}
输入校验：
| code | 说明 |
|---|---|
INVALID_INPUT |
字段缺失/格式错误 |
INVALID_TOKEN |
token 地址非法/不支持 |
INVALID_AMOUNT |
金额非法（非正数/非整数 wei/格式错误） |
INVALID_PAIR |
交易对不支持/不存在 |
INVALID_DEADLINE |
deadline/expiry 参数非法 |
业务类：
| code | 说明 |
|---|---|
QUOTE_EXPIRED |
报价过期 |
INSUFFICIENT_LIQUIDITY |
流动性不足 |
NO_QUOTES |
无可用报价 |
SLIPPAGE_EXCEEDED |
滑点校验失败 |
系统类：
| code | 说明 |
|---|---|
INTERNAL_ERROR |
内部错误 |
DATABASE_ERROR |
数据库错误 |
REDIS_ERROR |
Redis 错误 |
KAFKA_ERROR |
Kafka 错误 |
SIGNING_ERROR |
签名相关错误 |
TIMEOUT_ERROR |
超时 |
行情服务错误码
| code | 说明 |
|---|---|
10000 |
成功 |
10095 |
参数错误 |
20003 |
内部错误 |
20004 |
未找到（如 pair not found） |