Error Codes

These error codes are returned by the API when a request fails to pass validation or is blocked due to account, market, or business rule constraints. Use these codes to understand and debug rejection reasons.

Authentication Errors

Error Code Reference

All API responses follow a standard JSON error format for non-2xx status codes:

{ "code": 10010008, "message": "Signature verification failed" }

Code	Message	Description	Solution
10010008	Signature verification failed	Signature does not match	Check signature generation logic, ensure parameters are consistent; for non-Maker API endpoints, verify the Maker Address position is empty in the signature string
10010009	API key not found	API key does not exist	Verify API key is correct
10010010	API key expired	API key has expired	Contact administrator to renew API key
10010011	Timestamp expired	Request timestamp outside allowed range	Ensure system time is synchronized, regenerate timestamp
10010012	Missing required header	Missing authentication header	Ensure all required headers are included; Maker API endpoints must include X-Maker-Addr
10010013	Invalid maker address	Maker address is invalid or not authorized	Verify the X-Maker-Addr header is correct and authorized
10010014	Permission denied	Insufficient permissions	Maker API endpoints missing X-Maker-Addr header, or API Key lacks access to this resource

Market Data Errors

Error Code Reference

All API responses follow a standard JSON error format for non-2xx status codes:

{
	"code": 13010000,
	"message": "Method Not Allowed"
}

Code	HTTP Status	Message	Description
13010000	405	Method Not Allowed	The HTTP method used in the request is not allowed, or used wrong ContentType
13010001	400	Invalid argument(s)	One or more arguments provided in the request are invalid or missing.
13010011	404	Resource not found	TThe requested resource does not exist, or the request path is incorrect.
13010012	500	Internal server error	An unexpected error occurred on the server while processing the request.
13010013	500	Internal server error, wrong http status	An unexpected error occurred while processing the request on the server, resulting in an abnormal HTTP status being returned.
13010015	401	The client's IP address is not in the whitelist	The IP whitelist has been enabled, and the IP address currently being called is not in the whitelist.
1310017	429	Too many requests	Requests are too frequent or exceed the allocated entitlement quota.

Risk Errors

Error Code Reference

All API responses follow a standard JSON error format for non-2xx status codes:

{
	"code": 19010012,
	"message": "Internal server error",
	"detail": ""
}

Code	Message	Description
19010012	Internal server error	Generic request or business parameter error.
19010018	Unsupported media type	Failed to parse amount, address, token, etc.

Instant Swap API Errors (On-Chain)

Error	Description
InvalidSignature()	Signature invalid, or signer not authorized.
QuoteExpired()	Quote has expired.
QuoteAlreadyUsed()	Quote already used (replay protection).
UnauthorizedCaller()	Calling contract not on the whitelist.
AssetTokenNotWhitelisted()	Asset token not whitelisted.
StockTokenNotRegistered()	StockToken not registered in the manager.
ChainIdMismatch()	Chain ID mismatch.
ZeroAddress()	Address is zero.
InvalidQuantity()	Quantity is zero.