错误码说明

适用范围

指令模式、订单模式等 ToB 交易接口共用同一套 error_code。

错误处理流程

所有接口遵循同一套错误码格式，不同报错差别在于返回的 error_code 和 message 不同。
调用方可按以下顺序实现错误处理逻辑：

判断 HTTP statusCode 是否等于 200，否则直接错误提示
判断 response 中 status 是否等于 0：若为 0 则解析 data；若为 1 则说明该请求异常，执行下一步
根据 error_code 匹配下方错误码列表执行对应处理；若遇到不认识的 error_code，全部 fallback 到 80000

错误码列表

错误码	说明
80000	系统内部错误，接入方无法主动规避，需联系我方排查或重试
80001	代币余额不足
80002	交易金额低于最小限制
80003	交易金额超过最大限制
80004	订单已过期
80005	流动性不足，当前无法完成交易
80006	请求参数非法（格式错误、缺失必填字段、值超出范围等）
80007	Partner 不存在或无效
80008	反向询价计算未收敛（仅 PayFi Swap 的 minAmountOut 模式）
80009	获取代币信息失败（代币不存在或服务异常）
80010	获取代币价格或 Gas 价格失败
80011	生成交易 calldata 失败（仅 PayFi Swap）
80012	询价失败（无可用报价、所有市场均失败等）
80013	不支持的链（链配置不存在或无可用市场）
80014	订单不存在（Order 模式接口；`checkOrdersFee` 时任一 orderId 无效则整单失败）
80015	订单已提交，不可重复提交（仅 Order 模式接口）
80016	主链币余额不足以支付 Gas 费用
80017	NoGas 特性对该交易不可用
80018	手续费率非法（需为 0 或 0.001~0.02）
80019	指定 market 未对当前 Partner 开放
80020	报价价值偏差超过阈值（输出代币价值相对输入偏低过多）
80021	NoGas 未达到使用门槛
80022	风险检查未通过

异常响应示例


{
  "status": 1,
  "error_code": 80000,
  "data": null,
  "msg": "system err",
  "title": "",
  "timestamp": 1769580545990,
  "trace": "Root=1-6979a801-6ba8a7696bc0d4256c5b603c"
}