Skip to main content

FAQ

1. Why am I receiving an HTTP 403 error (Forbidden)?​

A 403 error is returned by the market data API when any of the following conditions are met:

  • The request does not include authentication information
  • The authentication credentials are invalid
  • The user does not have sufficient permissions

For more details, please refer to:
User Authentication and Authorization Process Authentication.

Note

In accordance with Hong Kong security and compliance requirements, OpenAPI not only relies on identity authentication using the App Key and secret signature, but also requires token authentication. For token creation and verification, please refer to Token Creation and Verification.

2: Do we need to handle signatures when using the Webull SDK?​

A: No, the Webull SDK has already encapsulated signature generation within the SDK, so you do not need to worry about it.

3: Why do we need to add an App Key and App Secret?​

A: The App Key and App Secret are application-level identity credentials assigned to developers. Only users with an App Key and App Secret can interact with the API properly.

4: Are there any usage restrictions for OpenAPI paid market data permissions?​

A: According to exchange rules, Hong Kong Level 2 permissions can only be used on one device at a time. If a new device is used, the permission on the old device will be revoked and fall back to Lv1 basic market data permission.

5: Can the market data I subscribed to in QT or the mobile app be used with OpenAPI?​

A: No. Subscriptions in QT or the mobile app are independent of OpenAPI. You need a separate data subscription specifically enabled for OpenAPI usage.

6: How can I enable paid market data permissions?​

A: Please go to Market Data Store for purchase.

7: Why do I receive the error message "Insufficient permission, please subscribe to stock quotes."when using the real-time market data function?​

A: This error indicates that your current account has not subscribed to the required advanced market data service. Some real-time market data on Webull requires activating a paid market data subscription to access. Please refer to Subscribe Advanced Quotes for details.