FAQs
Updated: 2026-03-31
Document Summary: This guide is designed to assist developers in quickly integrating the WEEX API, resolving issues related to permission configurations, rate limits, and common technical challenges during the trading process.
1. Account and Permission Configuration
Why is my API permission disabled or returning an "API Restricted" error?
- Risk Control Trigger: If an account triggers the platform's security risk control (such as abnormal login or high-frequency invalid requests), API permissions may be automatically disabled.
- Unblocking Process: Please contact customer service.
- Effective Time: Newly created or modified API Key permissions usually take approximately 15 minutes to take effect globally across the system.
Security Recommendations for Creating API Keys
- Passphrase: When setting the API Passphrase, do not include special characters (alphanumeric only).
- IP Whitelist: It is recommended to enable an IP whitelist to enhance security.
2. Rate Limits
WEEX imposes strict weight limits on different types of interfaces to ensure system stability. If the limit is exceeded, the system will return an HTTP 429 error.
| Business Type | Action Type | Rate Limit |
|---|---|---|
| Spot Trading | Cancel Order | 80 times / 10s; 200 times / 1min |
| Spot Trading | Place Order | 100 times / min |
| Network Connection | REST/WS Connection | 300 times / 5min / Per IP |
| WebSocket | Channel Subscription | 240 times / hour / Per Connection |
3. Common Technical Questions (Q&A)
Q1: Why does placing an order return -1052 (Insufficient permissions)?
A: This error is usually caused by the following reasons:
- Permission Settings: The corresponding "Futures" or "Spot" trading permissions were not checked on the API management page.
- Unsupported Trading Pairs: Certain tokens (such as TIA and other new listings) currently do not support API ordering.
- Interface Version: It is recommended to prioritize the V3 Interface, as V1/V2 will be deprecated.
Q2: Why does the WebSocket connection return a 403 error?
A: When establishing a WebSocket connection, you must include User-Agent information in the Header (content can be customized). If this field is missing, the request will be blocked by the firewall.
Q3: How do I get all tradable Symbols (trading pairs)?
A:
Spot: Access the Get Spot Trading Pairs Interface.
Futures: Access the Get Futures Trading Pairs Interface.
4: Does WEEX provide an API Testnet?
A: Currently, WEEX does not provide a standalone API testing environment. The "Demo Trading" feature on the web interface does not support API access at this time. It is recommended to use minimal funds in the production environment for logic debugging.
4. Further Support
If you encounter technical difficulties that cannot be resolved during development, you can obtain support through the following channels:
- Official API Documentation: WEEX API Documentation
- Technical Integration: Please contact your Account Manager to apply for access to the dedicated WEEX API Technical Integration Group.
- API trading involves high risks; please ensure you implement robust error-handling logic in your code.
- Strictly forbid leaking API Keys and Secret Keys to any third party.
- The content of this document may be adjusted along with system upgrades. Please refer to the latest official API documentation.