tqsdk2.TqApi

class tqsdk2.TqApi(self: tqsdk2.tqsdk2.TqApi, account: object = <tqsdk2.tqsdk2.TqSim object at 0x7fe68c49a7f0>, auth: object = None, backtest: object = None, web_gui: object = False, debug: object = False, disable_print: bool = False, _md_url: str = '', _srandom: int = 0) None

创建天勤2 接口实例.

Args:
account (None/TqSim/TqKq/TqAccount/TqCtp/TqRohon): [可选] 交易账号:
  • None: 账号将根据环境变量决定, 默认为 :py:class: ~tqsdk2.TqSim

  • TqSim : 使用 TqApi 自带的本地模拟账号

  • TqKq : 使用快期账号登录,直连行情和快期模拟交易服务器, 需提供 auth 参数

  • TqAccount : 使用实盘账号, 直连行情和交易中继服务器, 需提供期货公司/帐号/密码

  • TqCtp : 使用实盘账号, 直连行情和期货公司 CTP 交易服务器, 需提供期货公司/帐号/密码

  • TqRohon : 直连融航资管柜台

auth (TqAuth/str): [必填] 用户信易账户

  • TqAuth : 信易账户类,例如:TqAuth("tianqin@qq.com", "123456"), 您可以通过 https://account.shinnytech.com 进行注册管理

debug(bool/str): [可选] 是否将调试信息输出到指定文件,默认值为 False

disable_print(bool): [可选] 是否禁用调试信息输出,默认值为 False

backtest(TqBacktest): [可选] 进入时光机,此时强制要求 account 类型为 TqSim
  • TqBacktest : 传入 TqBacktest 对象,进入回测模式, 在回测模式下, 由 TqBacktest 内部完成回测时间段内的行情推进和 K 线、Tick 更新.

web_gui(bool/str): [可选]是否启用图形化界面功能, 默认不启用.
  • 启用图形化界面传入参数 web_gui=True 会每次以随机端口生成网页,也可以直接设置本机IP和端口 web_gui=[ip]:port 为网页地址,ip 可选,默认为 0.0.0.0,参考example 6

  • 为了图形化界面能够接收到程序传输的数据并且刷新,在程序中,需要循环调用 api.wait_update的形式去更新和获取数据

  • 推荐打开图形化界面的浏览器为Google Chrome 或 Firefox

Returns:

TqApi: 返回当前TqApi的一个副本

Example1:

# 使用实盘帐号直连行情和交易服务器
from tqsdk2 import TqApi, TqAuth, TqAccount
api = TqApi(TqAccount("H海通期货", "022631", "123456"), auth=TqAuth("信易账户", "账户密码"))
__init__(self: tqsdk2.tqsdk2.TqApi, account: object = <tqsdk2.tqsdk2.TqSim object at 0x7fe68c49a7f0>, auth: object = None, backtest: object = None, web_gui: object = False, debug: object = False, disable_print: bool = False, _md_url: str = '', _srandom: int = 0) None

__init__(self: tqsdk2.tqsdk2.TqApi, account: object = <tqsdk2.tqsdk2.TqSim object at 0x7fe68c49a7f0>, auth: object = None, backtest: object = None, web_gui: object = False, debug: object = False, disable_print: bool = False, _md_url: str = '', _srandom: int = 0) -> None

创建天勤2 接口实例.

Args:
account (None/TqSim/TqKq/TqAccount/TqCtp/TqRohon): [可选] 交易账号:
  • None: 账号将根据环境变量决定, 默认为 :py:class: ~tqsdk2.TqSim

  • TqSim : 使用 TqApi 自带的本地模拟账号

  • TqKq : 使用快期账号登录,直连行情和快期模拟交易服务器, 需提供 auth 参数

  • TqAccount : 使用实盘账号, 直连行情和交易中继服务器, 需提供期货公司/帐号/密码

  • TqCtp : 使用实盘账号, 直连行情和期货公司 CTP 交易服务器, 需提供期货公司/帐号/密码

  • TqRohon : 直连融航资管柜台

auth (TqAuth/str): [必填] 用户信易账户

  • TqAuth : 信易账户类,例如:TqAuth("tianqin@qq.com", "123456"), 您可以通过 https://account.shinnytech.com 进行注册管理

debug(bool/str): [可选] 是否将调试信息输出到指定文件,默认值为 False

disable_print(bool): [可选] 是否禁用调试信息输出,默认值为 False

backtest(TqBacktest): [可选] 进入时光机,此时强制要求 account 类型为 TqSim
  • TqBacktest : 传入 TqBacktest 对象,进入回测模式, 在回测模式下, 由 TqBacktest 内部完成回测时间段内的行情推进和 K 线、Tick 更新.

web_gui(bool/str): [可选]是否启用图形化界面功能, 默认不启用.
  • 启用图形化界面传入参数 web_gui=True 会每次以随机端口生成网页,也可以直接设置本机IP和端口 web_gui=[ip]:port 为网页地址,ip 可选,默认为 0.0.0.0,参考example 6

  • 为了图形化界面能够接收到程序传输的数据并且刷新,在程序中,需要循环调用 api.wait_update的形式去更新和获取数据

  • 推荐打开图形化界面的浏览器为Google Chrome 或 Firefox

Returns:

TqApi: 返回当前TqApi的一个副本

Example1:

# 使用实盘帐号直连行情和交易服务器
from tqsdk2 import TqApi, TqAuth, TqAccount
api = TqApi(TqAccount("H海通期货", "022631", "123456"), auth=TqAuth("信易账户", "账户密码"))

Methods

__init__(self, account, auth, backtest, ...)

__init__(self: tqsdk2.tqsdk2.TqApi, account: object = <tqsdk2.tqsdk2.TqSim object at 0x7fe68c49a7f0>, auth: object = None, backtest: object = None, web_gui: object = False, debug: object = False, disable_print: bool = False, _md_url: str = '', _srandom: int = 0) -> None

cancel_order(self, order_or_order_id)

发送撤单指令.

close(self)

关闭天勤接口实例并释放相应资源.

get_account(self, trading_unit)

获取用户账户资金信息

get_kline_serial(self, symbol, ...)

获取tick序列数据.

get_order(*args, **kwargs)

Overloaded function.

get_position(*args, **kwargs)

Overloaded function.

get_quote(self, symbol)

获取指定合约的盘口行情.

get_tick_serial(self, symbol, data_length)

获取指定时间段内的 K 线序列.

get_trade(*args, **kwargs)

Overloaded function.

get_trading_unit(self)

查询交易单元信息.

insert_order(self, symbol, direction, ...)

发送下单指令.

is_changing(*args, **kwargs)

Overloaded function.

query_cont_quotes(self, exchange_id, ...)

根据填写的参数筛选,返回主力连续合约对应的标的合约列表.

query_options(self, underlying_symbol, ...)

发送合约服务请求查询,查询符合条件的期权列表,并返回查询结果.

query_quotes(self, ins_class, exchange_id, ...)

根据相应的参数发送合约服务请求查询,并返回查询结果.

wait_update(self, deadline)

等待业务数据更新.