API Limit Types Overview

BYDFi currently enforces three main types of API limitations (subject to adjustment based on platform strategy):

Hard Limits

• Maximum Orders per Second: 20
• If exceeded: All new orders will be rejected, and the account will be temporarily unable to place orders — this applies to both the web and app platforms.

Common Error Codes & Solutions

1021 Error

• Message: "The request timestamp is outside the match engine's recvWindow."
• Solution: Sync your local system time with the server time. For Windows: You can use tools like Atomic Clock. For Linux/macOS: Use the ntpdate command to synchronize. If the issue persists due to network latency, try adjusting the recvWindow parameter accordingly.

API Key Security & Encryption

• One-Time Display: Your API secret key is shown only once upon creation. For security reasons, it will be masked with “**” after that.
• Lost Secret Key: If you see “**” instead of the actual key, it means the key is already hidden and cannot be retrieved. You’ll need to create a new API key and corresponding secret key.

Rate Limit Lockouts & Support Policy

• Auto Unlock: If you hit the hard rate limit, you cannot request manual unlock. The system will automatically restore access after a cooldown period.
• Third-Party Tools: If you’re using third-party wrappers or SDKs and encounter issues, please contact the tool’s original developer — BYDFi does not provide support for third-party integrations.
• Development Support: BYDFi does not offer assistance for custom coding or implementation issues.

Other Common Questions

API Key Status

• If your account is inactive or has been deactivated, all API keys will be deleted.
• If your API key has expired or disappeared, you can create a new one.
• “Read-only” API keys are retained for 3 months. If you don’t bind an IP whitelist within that time, the key will expire automatically.
• All active keys are removed when an account is disabled.

Requesting New Features

• If you can’t find a function in the official API documentation, it’s likely not supported yet.
• You’re welcome to submit a feature request via the feedback channel. We’ll review your suggestions.

Reporting Issues

• If you believe the issue is system-related (not due to your implementation), please contact us through the official BYDFi Telegram group.
• Be sure to provide clear evidence and logs to support your report. Vague or unsubstantiated reports may not be accepted for review.