Market API

Error Codes

Copy page

Response Format

All Market API responses — including errors — return HTTP 200. The business result is indicated by the code field in the response body.

Code
{
  "code": 0,
  "msg": "success",
  "data": { ... },
  "timestamp": 1718000000000
}

A non-zero code always indicates an error. Check the msg field for a human-readable description.

---

Success

Code	Description
0	Request succeeded

---

Parameter Errors

Code	Message	Cause	Affected Endpoints
40001	Parameter [field] error: <reason>	Request parameter failed validation — field format invalid, value out of range, required parameter missing, or unsupported enum value. The msg field includes the specific field name and reason.	All endpoints

Common 40001 triggers:

• binanceChainId is blank or not on the supported-chain list
• tokenContractAddress is blank or malformed
• Batch request list exceeds 100 items (POST /price, POST /price-info)
• limit is out of range (e.g. GET /trades requires 1 ≤ limit ≤ 500)
• walletAddressFilter contains more than 2 comma-separated addresses
• tagFilter is set to an unsupported value
• bar (candlestick interval) is not one of the allowed enum values
• rankBy, rankingTimeFrame, pageId, or size is out of range for hot-token queries
• Required @RequestParam is absent from the request

---

Authentication & Authorization Errors

These codes are enforced by the API Gateway before the request reaches the Market API service.

Code	Message	Cause
40101	Invalid API Key	The X-OC-APIKEY header is missing, malformed, or the key has been deleted / disabled
40102	Signature error	The X-OC-SIGN value does not match the expected HMAC-SHA256 or Ed25519 signature
40103	Timestamp expired	The X-OC-TIMESTAMP is outside the allowed recv_window relative to server time (default ±5 000 ms)
40104	Permission denied	The API Key does not have the required permission for this endpoint

---

Rate Limit Errors

Code	Message	Cause
42900	Request rate limit exceeded. Please refer to the API docs and reduce request frequency	Per-IP, per-API-Key, per-user, or per-endpoint rate limit has been reached. Retry after the duration indicated in the Retry-After response header

---

Compliance Errors

IP Compliance

Code	Message	Cause
40301	Service not available in your region	The client IP originates from a sanctioned jurisdiction (e.g. North Korea, Iran, Cuba, Syria, or OFAC-listed territory)
40302	Proxy or VPN detected. Please use direct connection	A high-risk VPN or proxy was detected on the client connection
40303	Unusual IP activity detected. Please contact support	Anomalous IP activity such as frequent location switching or concurrent multi-region access

---

Market API Business Errors

Chain Support

Code	Message	Cause	Affected Endpoints
40411	This chain is not supported	The supplied binanceChainId is not in the supported-chain whitelist, or the chain has been temporarily disabled via configuration	All endpoints that accept binanceChainId

---

Server Errors

Code	Message	Cause
50000	Internal server error, please retry later	An unexpected server-side error occurred (e.g. null pointer, serialization error). If the problem persists, contact support with the request timestamp
50001	Service temporarily unavailable, please retry later	An upstream data provider (e.g. CoinMarketCap DEX service) is unreachable or returned an error. Retry after a short delay

---

Error Code Reference by Endpoint

Endpoint	Possible Error Codes
GET /api/v1/dex/market/supported/chain	40001, 50000
POST /api/v1/dex/market/price	40001, 40411, 50000, 50001
POST /api/v1/dex/market/price-info	40001, 40411, 50000, 50001
GET /api/v1/dex/market/candles	40001, 40411, 50000, 50001
GET /api/v1/dex/market/token/search	40001, 50000, 50001
POST /api/v1/dex/market/token/basic-info	40001, 40411, 50000, 50001
GET /api/v1/dex/market/token/hot-token	40001, 50000, 50001
GET /api/v1/dex/market/token/advanced-info	40001, 40411, 50000, 50001
GET /api/v1/dex/market/token/top-liquidity	40001, 40411, 50000, 50001
GET /api/v1/dex/market/token/holder	40001, 40411, 50000, 50001
GET /api/v1/dex/market/token/top-trader	40001, 40411, 50000, 50001
GET /api/v1/dex/market/trades	40001, 40411, 50000, 50001

---

Troubleshooting Guide

Symptom	Likely Code	Action
Signature mismatch	40102	Verify pre-hash string: timestamp + METHOD + requestPath + body. Ensure requestPath includes the raw query string exactly as sent
Timestamp drift	40103	Sync your system clock with an NTP server. Use X-OC-RECV-WINDOW to extend tolerance (max 60 000 ms)
Unsupported chain	40411	Call GET /api/v1/dex/market/supported/chain to retrieve the current whitelist before building your request
Batch list too large	40001	Split your token list into batches of ≤ 100 items per request
All retries return 50001	50001	The upstream data provider is degraded. Check the status page or contact support