.. note::

  Futu OpenAPI 文档已于2020年10月16日全新升级，请移步至 `新文档 <https://openapi.futunn.com/futu-api-doc/>`_ 

  旧的github文档已于2020年11月16日正式停止访问。

  
.. _FutuOpenD: FutuOpenDGuide.html
  
介绍
========
futu-api提供了交易和行情接口，可以满足个人开发者使用富途牛牛软件进行程序化投资的需求。
  
-----------------------------------------------------------------------------------

主要功能
----------

交易品种：
::

          1. 港股：正股、ETF、窝轮、牛熊证、界内证、期货、期权
          2. 美股：正股、ETF、期权、期货
          3. A股：可通过A股通交易部分A股
  
行情数据：
::

          1. 港股：正股、ETF、窝轮、牛熊证、界内证、期货、期权、指数、板块
          2. 美股：正股、ETF、期权
          3. A股：正股、ETF、指数、板块
 
行情数据获取方式：
::

          支持订阅并接收实时报价、实时K线、实时逐笔、实时摆盘等数据推送
          支持获取市场快照，历史K线等

特点
-----
======================    =================================================================================
高效的执行                   配合 FutuOpenD_ ，一行简单的命令就可以执行您的策略
活跃的社区                   富途牛牛圈、QQ群和众多牛人一起分享心得
丰富的接口                   港股、A股行情数据获取、港美股实盘交易、A股通实盘交易以及港美A模拟交易                           
跨平台支持                   兼容 Windows / Mac OS / Linux
======================    =================================================================================


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

系统架构
--------

简介
~~~~~

使用futu-api时，需在本地或云端启动网关程序 FutuOpenD_，该程序以自定义TCP协议的方式对外暴露接口, 
该协议接口与编程语言无关, 为方便使用，针对不同编程语言，富途封装了对应语言的API SDK供第三方使用


第三方应用与 FutuOpenD_ 通讯架构
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. image:: ../_static/API.png