Error codes#
Return clear, stable, monitorable error codes. Business rejections may use HTTP 200 with a non-zero business code; authentication, malformed requests, and service failures should use the corresponding HTTP status.
| Code | HTTP | Meaning |
|---|---|---|
| 0 | 200 | Success; an executable quote or settlement result is returned. |
| 400 | 400 | Malformed request or missing required parameter. |
| 401 | 401 | Authentication failed; X-API-KEY is missing or invalid. |
| 404 | 404 | Unsupported pair, size, or unavailable RFQ resource. |
| 50x | 50x | Endpoint unavailable or unable to respond. Persistent failures may cause temporary suspension. |
| 82000 | 200 | Insufficient liquidity to produce an executable result. |
| 82001 | 200 | Requested size is below minTakerAmount. |
| 82002 | 200 | Order/RFQ cannot be processed because it is stale, closed, or fails internal validation. |
| 82003 | 200 | User rejected by MM risk controls or blocklist. |
| 82004 | 200 | MM broadcast submission failed before the Firm Order response; MM-broadcast mode only. |
Failure response example#
json
{
"code": "82000",
"msg": "Insufficient liquidity",
"data": {}
}
Table of contents