Data Permissions and Limitations

Market Data Permissions

Stocks (including ETFs)

Options

Futures

Futures market data L1 is not sold separately. Purchasing L2 market data automatically includes L1 data.

L2 market data provides real-time quotes, 10-level bid/ask depth quotes, and tick-by-tick transaction details.

Query market data permissions via API Query Market Data Permissions get_quote_permission

Historical Market Data Limitations & Subscription Limits

Clients who meet certain trading volume or total asset requirements can obtain corresponding historical market data permissions. Note: After meeting the tier requirements, you will have access to historical data (such as K-line data) and subscription quota for symbols. Real-time market data permissions (such as real-time quotes, tick data, etc.) need to be purchased separately.

User Tier Explanation

• Total assets are calculated as the average of daily closing assets for the most recent complete natural week (Monday to Sunday), denominated in USD. Individual clients are calculated based on the combined total assets of their comprehensive and global accounts; institutional clients are calculated based on the total assets of all main and sub-accounts.
• Trading volume calculation: The larger value between the previous natural month's cumulative trading volume and the current natural month's cumulative trading volume is used as the reference.
• Client tier update rules: The system automatically updates client tiers weekly, typically every Tuesday at 8:00 AM (GMT+8).

Historical Data Pull Quota Explanation

• Historical data includes K-line and intraday data
• Each Symbol's historical data request consumes 1 subscription quota when first requested. Repeat requests for the same Symbol within 30 days do not consume additional quota.
• For the same Symbol, regardless of what period or type of K-line data is requested, it counts as 1 quota and is not cumulative.
• If the Symbol supports historical intraday data, historical intraday and historical K-line data share the same quota, consuming only 1 quota in total.
  • Example: Suppose you have 20 stock historical data pull quotas. When you request AAPL's historical daily K, weekly K, and historical intraday data on April 18, 2020, the system will deduct 1 quota. Subsequently, from April 18, 2020 to May 18, 2020, any additional requests for AAPL's K-line or intraday data will not consume additional quota. If you pull historical data for 12 different stocks within this period, you will have 8 remaining quotas by May 18, 2020.

Subscription Quota Explanation

• Standard market data and Level 2 market data (depth quotes) are counted separately as independent categories. Except for Level 2 market data, basic market quotes, tick-by-tick transaction data, intraday data, etc., are all classified as standard market data, with standard market data quotas applying separately to each type of data in this category.
  • Example: If you have 20 standard market data quotas and 10 Level 2 market data quotas. When subscribing to HK.00700's basic market quotes and real-time tick-by-tick transaction data, 1 quota is deducted from each standard market data type, leaving 19 quotas for basic quotes and 19 quotas for tick-by-tick data. If you subsequently add a Level 2 market data subscription for HK.00700, it consumes 1 Level 2 quota, leaving 9 remaining.
• Changes in tier level do not invalidate existing market data subscriptions.

Historical Data Specifications

Stocks

Corresponding APIs: get_bars (Python) QuoteKlineRequest (Java)

Options

Corresponding APIs: get_option_bars (Python) OptionKlineQueryV2Request (Java)

Futures

Corresponding APIs: get_future_bars (Python) FutureKlineRequest (Java)

Shanghai-Hong Kong Stock Connect and Shenzhen-Hong Kong Stock Connect Stocks