Rate limits and errors
Rate limit 429 errors
Rate limit 429 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
CORS errors on ticker endpoint
CORS errors on ticker endpoint
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 error troubleshooting
Nonce error troubleshooting
Nonce errors occur when timestamps or request ordering are invalid. To resolve:
- Debug the code implementation
- Recreate API keys
- Ensure system time is properly synchronized
Smartplan endpoint 403 access errors
Smartplan endpoint 403 access errors
Smartplan endpoints are restricted to B2B partner services only. To gain access:
- Contact support@whitebit.com
- Request permissions for Smartplan endpoints
- Provide use case details
WebSocket
Multiple time periods in WebSocket Kline
Multiple time periods in WebSocket Kline
Multiple time periods for pairs are available through multiple WebSocket connections or the HTTP method. Two solutions:
- Open multiple WebSocket connections
- Use the equivalent HTTP method instead
Trade history limitations (24-hour window)
Trade history limitations (24-hour window)
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
Transfers and withdrawals
Transfer delays between balances
Transfer delays between balances
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
Insufficient funds errors despite available balance
Insufficient funds errors despite available balance
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
Webhook HTTPS requirements and port
Webhook HTTPS requirements and port
HTTPS is required for Webhook API communication:
- Communication occurs over port 443
- SSL/TLS encryption is mandatory
- HTTP connections are not supported
API and assets
Currency deposit and withdrawal availability
Currency deposit and withdrawal availability
Check currency status through the assets endpoint:
- URL: https://whitebit.com/api/v4/public/assets
- The endpoint provides real-time status of all currencies
- Check the currency-specific enabled/disabled flags
Security and API keys
API key security best practices
API key security best practices
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.
Compromised API key response
Compromised API key response
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
High-frequency trading API optimization
High-frequency trading API optimization
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.
API disconnection handling
API disconnection handling
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.