Futu OpenAPI

https://openapi.futunn.com/futu-api-doc/en
Admin
Futu OpenAPI provides market data and trading services for programmed trading, offering SDKs in...
Tokens:9,004
Snippets:33
Trust Score:9.6
Update:1 year ago
Show doc for...
Tokens:
Raw
### OpenD Installation Guide

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Instructions for installing OpenD after downloading. It involves extracting the downloaded file and running the installation executable. The default installation directory for Windows is the '%appdata%' directory.

```APIDOC
OpenD Installation:
1. Extract the downloaded OpenD file.
2. Locate and run the appropriate installation file for your operating system.
   - Windows Default Installation Path: %appdata%
```

--------------------------------

### OpenAPI Overview and Architecture

Source: https://openapi.futunn.com/futu-api-doc/en/intro/intro

Explains the Futu OpenAPI, its components (OpenD and Futu API SDK), and the overall architecture for accessing market data and trading services. It outlines the initial setup steps required for developers.

```APIDOC
OpenAPI Overview:
  Provides market data and trading services for programmed trading.
  Consists of OpenD (gateway program) and Futu API (SDK).

OpenD:
  - Gateway program running locally or in the cloud.
  - Responsible for transferring protocol requests to Futu servers and returning processed data.
  - Exposes interfaces via TCP.
  - Protocol interface is language-agnostic.

Futu API:
  - API SDK encapsulated by Futu.
  - Available for mainstream programming languages: Python, Java, C#, C++, JavaScript.
  - Allows interfacing with the protocol directly if the desired language is not listed.

Initial Setup Steps:
  1. Install and start OpenD.
  2. Download Futu API and complete Environment Setup.

Account Types:
  - Futu ID: User account (Futubull ID) usable in Futubull APP and OpenAPI.
  - Universal Account: Another type of account involved in OpenAPI.
```

--------------------------------

### Futu API Quota Usage Examples

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Illustrates how Subscription Quota and Historical Candlestick Quota are consumed and managed with practical examples.

```APIDOC
4. Subscription Quota
It is applicable to the real-time data interface that can only be obtained after a subscription. One type of subscription for each stock takes up 1 subscription quota, and canceling the subscription will release the occupied quota.
Example:
Suppose your Subscription Quota is 100. When you subscribe to real-time order book for HK.00700, real-time ticker for US.AAPL, and real-time quotation for SH.600519 at the same time, the Subscription Quota will occupy 3, and the remaining Subscription Quota will be 97. At this time, if you cancel the real-time order book subscription of HK.00700, your Subscription Quota will become 2, and the remaining Subscription Quota will become 98.

5. Historical Candlestick Quota
Suitable for [Get Historical Candlesticks](https://openapi.futunn.com/futu-api-doc/en/quote/request-history-kline.html) interface. In the last 30 days, requests for historical candlesticks of each stock will occupy one Historical Candlestick Quota. Repeated requests for historical candlestick of the same stock within the last 30 days will not be counted repeatedly.
Example:
Suppose your Historical Candlestick Quota is 100, and today is July 5, 2020. You have requested historical candlesticks for a total of 60 stocks between June 5, 2020 and July 5, 2020. The remaining Historical Candlestick Quota is 40.
```

--------------------------------

### API Frequency Limitation Example

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Demonstrates the frequency limitation rule for the 'Get Market Snapshot' API, specifying the maximum requests allowed within a given time frame and the implications of exceeding this limit.

```APIDOC
API: Get Market Snapshot
Rule: Maximum 60 requests every 30 seconds.
Equivalent: 1 request every 0.5 seconds.
Exceeding Limit: Returns an error.
```

--------------------------------

### MD5 Encryption Example

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Illustrates the expected format of the 32-bit MD5 encrypted hexadecimal ciphertext for WebSocket authentication.

```APIDOC
MD5 Encryption Example:

Ciphertext format: e10adc3949ba59abbe56e057f20f883e
```

--------------------------------

### Historical Candlestick Quota Management

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Details the 'Historical Candlestick Quota' used for requesting historical candlestick data via the Get Historical Candlesticks interface. Each stock's historical data request within a 30-day period counts as one quota, regardless of frequency. Subscribing to different periods for the same stock does not increase the quota usage.

```APIDOC
Historical Candlestick Quota:
  - Used for Get Historical Candlesticks interface.
  - Each stock's historical data request within the last 30 days occupies 1 quota.
  - Repeated requests for the same stock within 30 days are not counted repeatedly.
  - Subscribing to different periods for the same stock counts as 1 quota.
  - Example:
    Initial Quota: 100
    Requested 60 unique stocks between June 5, 2020 and July 5, 2020 -> Remaining Quota: 40
```

--------------------------------

### OpenD Startup and Configuration File Handling

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Explains how OpenD reads its configuration and provides methods for handling configuration file paths, especially on macOS.

```APIDOC
Default Configuration: OpenD reads OpenD.xml in the same directory by default.
macOS Path Handling:
  - Execute fixrun.sh under the tar package.
  - Specify configuration file path using the command line parameter `-cfg_file`.
```

--------------------------------

### Download OpenD for Different Operating Systems

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Provides direct download links for the OpenD application across various operating systems: Windows, MacOS, CentOS, and Ubuntu. These links fetch the latest available versions.

```APIDOC
OpenD Downloads:
  Windows: https://www.futunn.com/download/fetch-lasted-link?name=opend-windows
  MacOS: https://www.futunn.com/download/fetch-lasted-link?name=opend-macos
  CentOS: https://www.futunn.com/download/fetch-lasted-link?name=opend-centos
  Ubuntu: https://www.futunn.com/download/fetch-lasted-link?name=opend-ubuntu
```

--------------------------------

### OpenAPI Overview and Architecture

Source: https://openapi.futunn.com/futu-api-doc/en/index

Provides an overview of the Futu OpenAPI, explaining its components like OpenD (the gateway program) and the Futu API SDKs. It details the architecture for connecting to Futu servers and accessing market data and trading services.

```APIDOC
OpenAPI Overview:
  Provides wide varieties of market data and trading services for your programmed trading to meet the needs of every developer's programmed trading and help your Quant dreams.

Architecture:
  OpenAPI consists of OpenD and Futu API:
    - OpenD: The gateway program of Futu API, running on your local computer or cloud server. It is responsible for transferring the protocol requests to Futu servers, and returning the processed data. The protocol interface has nothing to do with the type of programming language.
    - Futu API: An API SDK encapsulated by Futu, including mainstream programming languages (Python, Java, C#, C++, JavaScript), to reduce the difficulty of your trading strategy development.

Setup Steps:
  1. Install and start a gateway program [OpenD].
  2. Download Futu API and complete [Environment Setup].

Account Types:
  - Futu ID: Your user account (Futubull ID), usable in Futubull APP and OpenAPI.
  - Universal account.
```

--------------------------------

### OpenD Login Process

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Describes the initial login procedure for the OpenD service, including account credentials and first-time user requirements.

```APIDOC
Login Procedure:
  - Enter account number and password.
First-time Login:
  - Complete questionnaire evaluation.
  - Confirm agreement.
Post-Login:
  - View account information.
  - Check quote rights.
```

--------------------------------

### OpenD Command Line Parameter

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Details how to specify a configuration file path for OpenD using a command-line parameter.

```APIDOC
Command Line Parameter:

-cfg_file <path>
  Specifies the configuration file path for OpenD.
```

--------------------------------

### OpenD Configuration Parameters

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Lists and describes the configuration items for the OpenD service, including network settings, logging, language, and security-related paths.

```APIDOC
Configuration Item | Description
---|---
IP | API listening IP address. Options: 127.0.0.1 (local), 0.0.0.0 (all network cards), or a specific network card address.
Port | API listening port.
Log Level | Log level of OpenD. Options: no (no log), debug (most detailed), info (less detailed).
Language | Language setting. Options: Simplified Chinese, English.
Time Zone of Future Trade API | Specifies the time zone for futures trading API calls.
Data Push Frequency | Controls the frequency of API subscription data push in milliseconds (excluding Candlestick and Time Frame).
Telnet IP | Listening address for remote operation commands.
Telnet Port | Listening port for remote operation commands.
Encrypted Private Key | Absolute path to the RSA Encrypted Private Key.
WebSocket IP | WebSocket listening address. Options: 127.0.0.1 (local), 0.0.0.0 (all network cards).
WebSocket Port | WebSocket listening port.
WebSocket Certificate | Path to the WebSocket certificate file. If not configured, WebSocket is not enabled. Must be configured with the private key.
WebSocket Private Key | Path to the WebSocket certificate private key file. Cannot be password-protected. If not configured, WebSocket is not enabled. Must be configured with the certificate.
WebSocket Authentication Key | Cipher text of the key (32-bit MD5 encrypted hexadecimal) used for JavaScript script connection trust.
```

--------------------------------

### OpenD Configuration Parameters

Source: https://openapi.futunn.com/futu-api-doc/en/quick/opend-base

Lists and describes the configuration items for the Visualization OpenD, including IP, Port, Log Level, Language, Time Zone, Data Push Frequency, Telnet settings, and WebSocket configurations. It also specifies options and requirements for each parameter.

```APIDOC
Configuration Item List:

Configuration Item | Description
---|---
IP | API listening IP address. Options: 127.0.0.1 (local), 0.0.0.0 (all networks), or a specific network card address.
Port | API listening port.
Log Level | Log level of OpenD. Options: no (no log), debug (most detailed), info (less detailed).
Language | Language setting. Options: Simplified Chinese, English.
Time Zone of Future Trade API | Specifies the time zone for futures trading API calls.
Data Push Frequency | Controls the frequency of API subscription data push in milliseconds (excluding Candlestick and Time Frame).
Telnet IP | Listening address for remote operation commands.
Telnet Port | Listening port for remote operation commands.
Encrypted Private Key | Absolute path to the RSA Encrypted Private Key.
WebSocket IP | WebSocket listening address. Options: 127.0.0.1 (local), 0.0.0.0 (all networks).
WebSocket Port | WebSocket listening port.
WebSocket Certificate | Path to the WebSocket certificate file. If not configured, WebSocket is not enabled. Must be configured with the private key.
WebSocket Private Key | Path to the WebSocket certificate private key file. Cannot be password-protected. If not configured, WebSocket is not enabled. Must be configured with the certificate.
WebSocket Authentication Key | 32-bit MD5 encrypted hexadecimal ciphertext for JavaScript script trust verification.
```

--------------------------------

### OpenD Supported Platforms

Source: https://openapi.futunn.com/futu-api-doc/en/intro/intro

OpenD, the platform associated with the Futu API, is compatible with multiple operating systems, ensuring broad accessibility for developers.

```APIDOC
OpenD supports:
- Windows
- MacOS
- CentOS
- Ubuntu
```

--------------------------------

### API Documentation Navigation

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Provides links to related sections of the Futu API documentation, including OpenAPI Introduction, Fee information, and specific details on Authorities and Limitations such as Login Limitations, Quotation Data, and Trading Functions.

```APIDOC
API Documentation Navigation:
  - OpenAPI Introduction: https://openapi.futunn.com/futu-api-doc/en/intro/intro.html
  - Fee: https://openapi.futunn.com/futu-api-doc/en/intro/fee.html
  - Authorities and Limitations: https://openapi.futunn.com/futu-api-doc/en/intro/authority.html
    - Login Limitations: https://openapi.futunn.com/futu-api-doc/en/intro/authority.html#7200
    - Quotation Data: https://openapi.futunn.com/futu-api-doc/en/intro/authority.html#7371
    - Trading Functions: https://openapi.futunn.com/futu-api-doc/en/intro/authority.html#1667
```

--------------------------------

### OpenD Supported Platforms

Source: https://openapi.futunn.com/futu-api-doc/en/index

OpenD, the platform associated with the Futu API, is compatible with multiple operating systems, ensuring broad accessibility for developers.

```APIDOC
OpenD supports:
- Windows
- MacOS
- CentOS
- Ubuntu
```

--------------------------------

### Futu Trading Capacity by Market

Source: https://openapi.futunn.com/futu-api-doc/en/intro/intro

Details the trading capacity for stocks, options, and futures across different markets, indicating support for paper and live trading.

```APIDOC
Market | Contracts | Paper Trading | Live Trading
---|---|---|---
HK Market | Stocks, ETFs, Warrants, CBBCs, Inline Warrants | ✓ | ✓
Options | Options including index options, tradable through futures account | ✓ | ✓
Futures | ✓ | ✓
US Market | Stocks, ETFs | ✓ | ✓
Options | ✓ | ✓
Futures | ✓ | ✓
A-share Market | China Connect Securities stocks | ✓ | ✓
Non-China Connect Securities stocks | ✓ | X
Singapore Market | Stocks, ETFs, Warrants, REITs, DLCs | X | X
Futures | ✓ | ✓
Japanese Market | Stocks, ETFs, REITs | X | X
Futures | ✓ | ✓
Australian Market | Stocks, ETFs | X | X
```

--------------------------------

### Futu API Supported Languages

Source: https://openapi.futunn.com/futu-api-doc/en/intro/intro

The Futu API supports a variety of programming languages, allowing developers to integrate trading functionalities into their applications.

```APIDOC
Futu API supports:
- Python
- Java
- C#
- C++
- JavaScript
```

--------------------------------

### Futu Trading Capacity by Market

Source: https://openapi.futunn.com/futu-api-doc/en/index

Details the trading capacity for stocks, options, and futures across different markets, indicating support for paper and live trading.

```APIDOC
Market | Contracts | Paper Trading | Live Trading
---|---|---|---
HK Market | Stocks, ETFs, Warrants, CBBCs, Inline Warrants | ✓ | ✓
Options | Options including index options, tradable through futures account | ✓ | ✓
Futures | ✓ | ✓
US Market | Stocks, ETFs | ✓ | ✓
Options | ✓ | ✓
Futures | ✓ | ✓
A-share Market | China Connect Securities stocks | ✓ | ✓
Non-China Connect Securities stocks | ✓ | X
Singapore Market | Stocks, ETFs, Warrants, REITs, DLCs | X | X
Futures | ✓ | ✓
Japanese Market | Stocks, ETFs, REITs | X | X
Futures | ✓ | ✓
Australian Market | Stocks, ETFs | X | X
```

--------------------------------

### Method to Obtain Market Data

Source: https://openapi.futunn.com/futu-api-doc/en/intro/intro

Describes the methods available for obtaining market data through the OpenAPI. This includes subscribing to real-time pushed data such as quotes, candlesticks, tick-by-tick data, and order books, as well as requesting historical data like candlesticks and market snapshots.

```APIDOC
Market Data Acquisition Methods:

1. Real-time Data Subscription:
   - Subscribe to and receive pushed real-time quotes.
   - Subscribe to and receive pushed real-time candlestick data.
   - Subscribe to and receive pushed real-time tick-by-tick data.
   - Subscribe to and receive pushed real-time order book data.

2. Historical Data Request:
   - Request the latest market snapshot data.
   - Request historical candlestick data.
```

--------------------------------

### Method to Obtain Market Data

Source: https://openapi.futunn.com/futu-api-doc/en/index

Describes the methods available for obtaining market data through the OpenAPI. This includes subscribing to real-time pushed data such as quotes, candlesticks, tick-by-tick data, and order books, as well as requesting historical data like candlesticks and market snapshots.

```APIDOC
Market Data Acquisition Methods:

1. Real-time Data Subscription:
   - Subscribe to and receive pushed real-time quotes.
   - Subscribe to and receive pushed real-time candlestick data.
   - Subscribe to and receive pushed real-time tick-by-tick data.
   - Subscribe to and receive pushed real-time order book data.

2. Historical Data Request:
   - Request the latest market snapshot data.
   - Request historical candlestick data.
```

--------------------------------

### Futu API Supported Languages

Source: https://openapi.futunn.com/futu-api-doc/en/index

The Futu API supports a variety of programming languages, allowing developers to integrate trading functionalities into their applications.

```APIDOC
Futu API supports:
- Python
- Java
- C#
- C++
- JavaScript
```

--------------------------------

### Futu API Metric Definitions

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Provides definitions and calculation methods for key metrics used in determining API quota limits, including Total Asset, Monthly Number of Filled Orders, and Monthly Trading Volume.

```APIDOC
1. Total asset
Total asset, refers to all your assets in Futu/moomoo, including securities, futures, funds and bonds assets, converted into HKD according to the spot exchange rate.

2. The monthly number of filled orders
It is calculated by taking the larger value of the number of filled orders the last natural month and that of the current natural month, that is: max (the number of filled orders of the last natural month, the number of filled orders of the current natural month)

3. Monthly Trading volume
It is calculated by taking the larger value of the total trading volume of your last natural month and that of the current natural month, which is converted into HKD according to the spot exchange rate, that is: max (the total trading volume of the last natural month, the total trading volume of the current natural month)
The calculation of futures trading value needs to be multiplied by the adjustment factor (0.1 by default). The formula for calculating futures trading volume is as follows:
Futures trading value = ∑ (volume of a single transaction * trading price * contract multiplier * exchange rate * adjustment factor)
```

--------------------------------

### Account Information

Source: https://openapi.futunn.com/futu-api-doc/en/index

Details the account types used within the Futu OpenAPI, specifically the Futu ID and universal account. Explains how the Futu ID serves as the primary user account for accessing services.

```APIDOC
Account Types:
  - Futu ID: Your user account (Futubull ID), which can be used in Futubull APP and OpenAPI. You can use your Futu ID and login password to log in to OpenD and obtain market data.
```

--------------------------------

### Subscription Quota Management

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Explains how subscribing to real-time data for different instruments consumes a 'Subscription Quota'. Each unique subscription occupies one quota, and cancelling a subscription frees up the quota. The remaining quota is calculated based on active subscriptions.

```APIDOC
Subscription Quota:
  - Occupied by real-time data subscriptions (e.g., order book, ticker, quotation).
  - Each unique subscription consumes 1 quota.
  - Cancelling a subscription releases the occupied quota.
  - Example:
    Initial Quota: 100
    Subscribe to HK.00700 (order book), US.AAPL (ticker), SH.600519 (quotation) -> Quota Used: 3, Remaining: 97
    Cancel HK.00700 subscription -> Quota Used: 2, Remaining: 98
```

--------------------------------

### Futu API - Authorities and Limitations

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Details the authorities and limitations for using the Futu OpenAPI. This includes requirements for opening trading accounts, compliance confirmations via API questionnaires and agreements, and various limitations on quotation data such as quote rights, interface frequency, subscription quotas, and historical candlestick quotas.

```APIDOC
Futu OpenAPI Authorities and Limitations:

1. Account Opening:
   - Users must complete trading account opening on Futubull APP or moomoo APP before logging into OpenAPI.

2. Compliance Confirmation:
   - After the first login, users must complete the 'API Questionnaire and Agreements' to continue using OpenAPI.
   - Futubull users: [Click here](https://www.futunn.com/about/api-disclaimer?lang=en-US)
   - moomoo users: [Click here](https://www.moomoo.com/about/api-disclaimer?lang=en-us)

3. Quotation Data Limitations:
   - Quote Right: Authority to obtain relevant market data.
   - Interface Frequency Limitations: Restrictions on the frequency of calling interfaces.
   - Subscription Quota: Limit on the number of real-time quotes that can be subscribed to simultaneously.
   - Historical Candlestick Quota: Total number of historical candlestick data pulls allowed per 30 days.
```

--------------------------------

### Futu OpenAPI Quote Right Acquisition

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Details the methods for acquiring quote rights for different markets and security types via Futu OpenAPI. This includes free LV1/LV2 quotes and paid options for advanced market data.

```APIDOC
Market Data Acquisition:

HK Market:
  - Securities (Stocks, ETFs, Warrants, CBBCs, Inline Warrants):
    - Chinese mainland customers: Free LV2 market quotes.
    - Non-Chinese mainland customers: Free LV1 market quotes. Purchase HK Stocks Advanced Full Market Quotes for SF market quotes.
  - Indices, Plates, Options:
    - Chinese mainland customers: Free LV2 market quotes during promotion.
    - Non-Chinese mainland customers: Free LV1 market quotes. Purchase HK stock options futures LV2 advanced market for LV2 data.
  - Futures:
    - CME Group quotes (CME, CBOT, NYMEX, COMEX): Access CME Group Futures LV2.
    - Other CME quotes: Access CME Futures LV2.
    - Other CBOT quotes: Access CBOT Futures LV2.
    - Other NYMEX quotes: Access NYMEX Futures LV2.
    - Other COMEX quotes: Access COMEX Futures LV2.
    - Clients with futures account (FUTU HK/Moomoo Financial Singapore Pte. Ltd.): Supported.
    - Clients without futures account: Unsupported.

US Market:
  - Securities (NYSE, NYSE-American, Nasdaq equities, ETFs):
    - Purchase Nasdaq Basic for LV1 market quotes (basic quotes, 24H).
    - Purchase Nasdaq Basic+TotalView for LV2 market quotes (Full Order Book for 24H trading).
  - Plates, OTC Securities: Unsupported.
  - Options (US stock options, US index options):
    - Customers meeting threshold (Total assets > $3000 in HK/US stocks, have traded HK/US stocks): Free LV1 market data.
    - Customers not meeting threshold: Purchase OPRA Options Real-time Quote for LV1 market data.
  - Futures:
    - CME Group quotes (CME, CBOT, NYMEX, COMEX): Access CME Group Futures LV2.
    - Other CME quotes: Access CME Futures LV2.
    - Other CBOT quotes: Access CBOT Futures LV2.
    - Other NYMEX quotes: Access NYMEX Futures LV2.
    - Other COMEX quotes: Access COMEX Futures LV2.
    - Clients with futures account (FUTU HK/Moomoo Financial Singapore Pte. Ltd.): Supported.
    - Clients without futures account: Unsupported.
  - Indices: Unsupported.

A-share Market:
  - Securities (Stocks, ETFs):
    - Chinese mainland customers: Free LV1 market data.
    - Non-Chinese mainland customers/institutional customers: Unsupported.
  - Indices, Plates: Unsupported.

Singapore Market:
  - Futures: Unsupported.

Japanese Market:
  - Futures: Unsupported.

Distinction between Chinese mainland and Non-Chinese mainland customers is based on OpenD login IP address.
```

--------------------------------

### Futu OpenAPI Quote Rights Acquisition

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

This section details how to acquire quote rights for various markets and security types through Futu OpenAPI. It specifies the data levels (LV1, LV2, SF) and the methods for obtaining them, differentiating between Chinese mainland and non-Chinese mainland customers. Links to purchase quotation cards are provided.

```APIDOC
Market Data Acquisition:

HK Market:
  Securities (stocks, ETFs, warrants, CBBCs, Inline Warrants):
    - Chinese mainland customers: Free LV2 market quotes. Purchase "HK Stocks Advanced Full Market Quotes" for SF market quotes.
    - Non-Chinese mainland customers: Free LV1 market quotes. Purchase "HK stocks LV2 advanced market" for LV2 quotes. Purchase "HK Stocks Advanced Full Market Quotes" for SF quotes.
  Indices, Plates, Options:
    - Chinese mainland customers: Free LV2 market quotes during promotion. 
    - Non-Chinese mainland customers: Free LV1 market quotes. Purchase "HK stock options futures LV2 advanced market" for LV2 data.
  Futures:
    - Supported by FUTU HK/Moomoo Financial Singapore Pte. Ltd. for clients with a futures account.
    - Not supported by Moomoo Financial Inc.
    - CME Group quotes (CME, CBOT, NYMEX, COMEX): Access "CME Group Futures LV2", "CME Futures LV2", "CBOT Futures LV2", "NYMEX Futures LV2", "COMEX Futures LV2" via provided links.
    - Unsupported for clients without a futures account.
  Indices: Unsupported.

US Market:
  Securities (NYSE, NYSE-American, Nasdaq listed equities, ETFs):
    - Purchase "Nasdaq Basic" for LV1 quotes (basic, 24H).
    - Purchase "Nasdaq Basic+TotalView" for LV2 quotes (Full Order Book, 24H).
  Plates, OTC Securities: Unsupported.
  Options (US stock options, US index options):
    - Customers with total assets > $3000: Free LV1 market data.
    - Customers not meeting threshold: Purchase "OPRA Options Real-time Quote" for LV1 data.
  Futures:
    - For clients who have a futures account.
    - Supported by FUTU HK/Moomoo Financial Singapore Pte. Ltd.
    - Not supported by Moomoo Financial Inc.
    - CME Group quotes (CME, CBOT, NYMEX, COMEX): Access "CME Group Futures LV2", "CME Futures LV2", "CBOT Futures LV2", "NYMEX Futures LV2", "COMEX Futures LV2" via provided links.
    - Unsupported for clients without a futures account.
  Indices: Unsupported.

A-share Market:
  Securities (stocks, ETFs):
    - Chinese mainland customers: Free LV1 market data.
    - Non-Chinese mainland customers/institutional customers: Unsupported.
  Indices, Plates: Unsupported.

Singapore Market:
  Futures: Unsupported.

Japanese Market:
  Futures: Unsupported.

Note: Quote rights are not identical to APP permissions. Different levels correspond to data delay, order book levels, and interface usage permissions.
```

--------------------------------

### Quotation Data Categories

Source: https://openapi.futunn.com/futu-api-doc/en/intro/intro

Details the supported markets and contract types for quotation data, including HK, US, A-share, Singapore, Japanese, Australian, and Global markets. It specifies which users have access to which data types and highlights the need for authorities for each market data type.

```APIDOC
Market Data Support:

HK Market:
  - Stocks, ETFs, Warrants, CBBCs, Inline Warrants: Supported for Futu Users
  - Options: Supported for Futu Users
  - Futures: Supported for Futu Users
  - Indices: Supported for Futu Users
  - Plates: Supported for Futu Users

US Market:
  - Stocks, ETFs (NYSE, NYSE-American, Nasdaq): Supported for Futu Users
  - OTC Securities: Not Supported
  - Options (US stock options, US index options): Supported for Futu Users
  - Futures: Supported for Futu Users
  - Indices: Not Supported
  - Plates: Supported for Futu Users

A-share Market:
  - Stocks, ETFs: Supported for Futu Users
  - Indices: Supported for Futu Users
  - Plates: Supported for Futu Users

Singapore Market:
  - Stocks, ETFs, Warrants, REITs, DLCs: Not Supported
  - Futures: Not Supported

Japanese Market:
  - Stocks, ETFs, REITs: Not Supported
  - Futures: Not Supported

Australian Market:
  - Stocks, ETFs: Not Supported

Global Markets:
  - Forex: Not Supported

Note: Market data access requires specific authorities. Refer to the authority documentation for details.
```

--------------------------------

### Trading Account Requirements

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Outlines the necessity of having a trading account opened in a specific market to perform trades in that market. For instance, US stock trading requires a US trading account, and cannot be conducted using an HK trading account.

```APIDOC
Trading Functions:
  - Market-specific trading requires a corresponding trading account.
  - Example:
    To trade US stocks, a US trading account is mandatory.
    Trading US stocks with an HK trading account is not permitted.
```

--------------------------------

### Quotation Data Categories

Source: https://openapi.futunn.com/futu-api-doc/en/index

Details the supported markets and contract types for quotation data, including HK, US, A-share, Singapore, Japanese, Australian, and Global markets. It specifies which users have access to which data types and highlights the need for authorities for each market data type.

```APIDOC
Market Data Support:

HK Market:
  - Stocks, ETFs, Warrants, CBBCs, Inline Warrants: Supported for Futu Users
  - Options: Supported for Futu Users
  - Futures: Supported for Futu Users
  - Indices: Supported for Futu Users
  - Plates: Supported for Futu Users

US Market:
  - Stocks, ETFs (NYSE, NYSE-American, Nasdaq): Supported for Futu Users
  - OTC Securities: Not Supported
  - Options (US stock options, US index options): Supported for Futu Users
  - Futures: Supported for Futu Users
  - Indices: Not Supported
  - Plates: Supported for Futu Users

A-share Market:
  - Stocks, ETFs: Supported for Futu Users
  - Indices: Supported for Futu Users
  - Plates: Supported for Futu Users

Singapore Market:
  - Stocks, ETFs, Warrants, REITs, DLCs: Not Supported
  - Futures: Not Supported

Japanese Market:
  - Stocks, ETFs, REITs: Not Supported
  - Futures: Not Supported

Australian Market:
  - Stocks, ETFs: Not Supported

Global Markets:
  - Forex: Not Supported

Note: Market data access requires specific authorities. Refer to the authority documentation for details.
```

--------------------------------

### Futu API Fee Structure

Source: https://openapi.futunn.com/futu-api-doc/en/intro/fee

Details the fee structure for accessing market data and trading through the Futu OpenAPI. LV2 HK and A-share LV1 market quotes are free for mainland China customers. Some data variations require purchasing quotation cards. Trading fees are consistent with the APP, with specific charging plans provided for different securities firms.

```APIDOC
# Fee

## Quote
LV2 HK market quotes and A-share LV1 market quotes are free for Chinese mainland customers. For some variaties, you need to buy quotation cards before obtaining market data. For more details of quotation cards prices, please click [Quote Right](https://openapi.futunn.com/futu-api-doc/en/intro/authority.html#5331) and go to data store.

## Trade
There is no extra fee for tradings through OpenAPI. The transaction fee is the same as that of APP. You can check the specific charging plans from the following table:

Securities Firm | Charging Options  
---|---
FUTU HK | [Charging Options](https://www.futufin.com/about/commissionnew?lang=en-us)  
Moomoo US | [Charging Options](https://help.fututrade.com/?tid=77)  
Moomoo SG | [Charging Options](https://support.futusg.com/en-us/topic76?lang=en-us)  
Moomoo AU | [Charging Options](https://www.futuau.com/support/categories/639?global_content=%7B%22promote_id%22%3A11927%2C%22sub_promote_id%22%3A21%7D)
```

--------------------------------

### Futu API Quota Limits

Source: https://openapi.futunn.com/futu-api-doc/en/intro/authority

Defines the subscription and historical candlestick quota limits based on user type and trading activity. User types are categorized by account status, total asset value, monthly filled orders, and monthly trading volume.

```APIDOC
User Type | Subscription Quota | Historical Candlestick Quota
---|---|---
Finished Opening trading accounts. | 100 | 100
Total asset > 10,000 HKD. | 300 | 300
Satisfy 1 of the items following: 
1. Total asset > 500,000 HKD; 
2. The number of monthly filled orders > 200; 
3. Monthly trading volume > 2 million HKD. | 1000 | 1000
Satisfy 1 of the items following: 
1. Total asset > 5 million HKD; 
2. The number of monthly filled orders > 2000; 
3. Monthly trading volume > 20 million HKD. | 2000 | 2000
```
Tokens:
Raw