Skip to main content

Rate limits and errors

Rate limit 429 errors occur when an endpoint exceeds the rate limit. To resolve:
  • Wait for the rate limit window to reset
  • Check the specific rate limit value in the endpoint documentation
  • Implement rate limiting in code
For more details, see the API v4 overview.
CORS requests to the ticker endpoint are forbidden for security reasons. Make the request from a backend server instead of client-side code. For endpoint details, see the Market activity endpoint.
Nonce errors occur when timestamps or request ordering are invalid. To resolve:
  1. Debug the code implementation
  2. Recreate API keys
  3. Ensure system time is properly synchronized
For details on nonce requirements, see the Authentication guide.
Smartplan endpoints are restricted to B2B partner services only. To gain access:For endpoint details, see the Crypto Lending documentation.

WebSocket

Multiple time periods for pairs are available through multiple WebSocket connections or the HTTP method. Two solutions:
  1. Open multiple WebSocket connections
  2. Use the equivalent HTTP method instead
For more details, see the Kline documentation.
The system shows only the last 100 deals by default. To access more:
  • Subscribe to the WebSocket feed
  • Accumulate and store the data
  • Process the data as needed
For more details, see the Trades channel documentation.

Transfers and withdrawals

Transfers may take up to 2 seconds to complete. When making transfers and withdrawals:
  • Wait for transfers to complete (approximately 2 seconds)
  • Avoid initiating withdrawals before transfer completion
  • Implement proper error handling for transfer states
For endpoint details, see the Transfer between balances documentation.
Insufficient funds errors occur when the withdrawal amount plus the fee exceeds available balance. Important considerations:
  • Account for withdrawal fees in calculations
  • Check the fees documentation
  • Ensure sufficient balance for both amount and fees

Webhooks

HTTPS is required for Webhook API communication:
  • Communication occurs over port 443
  • SSL/TLS encryption is mandatory
  • HTTP connections are not supported
For more details, see the Webhook documentation.

API and assets

Check currency status through the assets endpoint:For endpoint details and response schema, see the Asset status list documentation.

Security and API keys

Store API keys securely using environment variables, restrict IP access, and use minimum required permissions. Never commit keys to version control.For details, see the Authentication guide.
Immediately delete the compromised key, review account activity for unauthorized actions, and create new API keys. Contact support if unauthorized activity is detected.For details, see the Authentication guide.

API usage

Use WebSocket for real-time data, batch requests when possible, implement proper rate limiting, and cache frequently accessed data.For details, see the WebSocket API.
Implement automatic reconnection with exponential backoff. Maintain local order state and set up monitoring and alerts for connection issues.For details, see the WebSocket API.