账户与交易

设定实盘交易账户

TqSdk 要求在创建 TqApi 时指定交易账户。一旦TqApi创建成功,后续所有通过TqApi发出的交易指令均在此账户中进行.

要使用实盘交易账户, 请使用 TqAccount (注:使用前请先 import TqAccount) .

api = TqApi(TqAccount("H海通期货", "320102", "123456"))

TqAccount 的三个参数分别为 期货公司名, 用户名和密码. 目前TqSdk支持的期货公司列表请参见 TqSdk支持的期货公司列表

如果您在期货公司的账户位于期货公司的其它席位上(非主席), 您可以在创建 TqAccount 时用 front_broker 和 front_url 参数指定次席服务器:

api = TqApi(TqAccount("H海通期货", "320102", "123456", front_broker="3233", front_url="tcp://132.31.128.201:41205"))

TqApi 创建成功即代表相应账户已登录成功. 如果在60秒内无法完成登录, 会抛出超时异常, 用户代码可以此判定登录失败:

try:
    api = TqApi(TqAccount("H海通期货", "320102", "123456"))
except Exception as e:
    print("行情服务连不上, 或者期货公司服务器关了, 或者账号密码错了, 总之就是有问题")

设定模拟交易账户

如果您需要使用模拟账户进行测试,只需在创建TqApi时传入一个 TqSim 的实例(不填写参数则默认为 TqSim() 模拟账号):

api = TqApi(TqSim())

如果需要使用能保存账户资金及持仓信息的模拟账户,请使用 "快期模拟" 账号, 账户申请及使用方法请参考 模拟交易和论坛 部分内容。

获取账户情况

TqApi 提供以下函数来获取交易账户相关信息:

以上函数返回的都是dict, 并会在 wait_update 时更新

交易指令

要在交易账户中发出一个委托单, 使用 insert_order() 函数:

order = api.insert_order(symbol="SHFE.rb1901", direction="BUY", offset="OPEN", limit_price=4310, volume=2)
print(order)

这个函数调用后会立即返回一个指向此委托单的对象引用, 使用方法与dict一致, 内容如下:

{
    "order_id": "",  # "123" (委托单ID, 对于一个用户的所有委托单,这个ID都是不重复的)
    "exchange_order_id": "",  # "1928341" (交易所单号)
    "exchange_id": "",  # "SHFE" (交易所)
    "instrument_id": "",  # "rb1901" (交易所内的合约代码)
    "direction": "",  # "BUY" (下单方向, BUY=买, SELL=卖)
    "offset": "",  # "OPEN" (开平标志, OPEN=开仓, CLOSE=平仓, CLOSETODAY=平今)
    "volume_orign": 0,  # 10 (总报单手数)
    "volume_left": 0,  # 5 (未成交手数)
    "limit_price": float("nan"),  # 4500.0 (委托价格, 仅当 price_type = LIMIT 时有效)
    "price_type": "",  # "LIMIT" (价格类型, ANY=市价, LIMIT=限价)
    "volume_condition": "",  # "ANY" (手数条件, ANY=任何数量, MIN=最小数量, ALL=全部数量)
    "time_condition": "",  # "GFD" (时间条件, IOC=立即完成,否则撤销, GFS=本节有效, GFD=当日有效, GTC=撤销前有效, GFA=集合竞价有效)
    "insert_date_time": 0,  # 1501074872000000000 (下单时间(按北京时间),自unix epoch(1970-01-01 00:00:00 GMT)以来的纳秒数)
    "status": "",  # "ALIVE" (委托单状态, ALIVE=有效, FINISHED=已完)
    "last_msg": "",  # "报单成功" (委托单状态信息)
}

与其它所有数据一样, 委托单的信息也会在 api.wait_update() 时被自动更新:

order = api.insert_order(symbol="SHFE.rb1901", direction="BUY", offset="OPEN", limit_price=4310,volume=2)
while order.status != "FINISHED":
    api.wait_update()
    print("委托单状态: %s, 未成交手数: %d 手" % (order.status, order.volume_left))

要撤销一个委托单, 使用 cancel_order() 函数:

api.cancel_order(order)
  • 除 insert_order 和 cancel_order 外, TqSdk 提供了一些更强的交易辅助工具比如 TargetPosTask. 使用这些工具, 可以简化交易逻辑的编码工作.

TqSdk支持的期货公司列表

A安粮期货

B渤海期货

B宝城期货

B北京首创

B倍特期货

C长安期货

C长城期货

C长江期货

C创元期货

C财达期货

D大地期货

D大越期货

D东航期货

D大陆期货

D德盛期货

D东吴期货

D东证期货

D东华期货

D东方财富

D东海期货

D大有期货

D东方汇金

D东兴期货

F方正中期

G广发期货

G光大期货

G国际期货

G国投安信

G国富期货

G国金期货

G国联期货

G国元期货

G广金期货

G格林大华

G国贸期货

G国泰君安

G广州期货

G国信期货

G国都期货

G国海良时

G冠通期货

G国盛期货

H华安期货

H华泰期货

H海通期货

H海证期货

H华西期货

H混沌天成

H华鑫期货

H华信期货

H和合期货

H恒泰期货

H弘业期货

H徽商期货

H宏源期货

H海航期货

H华联期货

H华龙期货

H华创期货

H华闻期货

H华金期货

H华融期货

H红塔期货

J金石期货

J金元期货

J建信期货

J金瑞期货

J金信期货

J锦泰期货

J江海汇鑫

J金汇期货

L良运期货

L鲁证期货

M迈科期货

M美尔雅期货

N南华期货

N宁证期货

P平安期货

Q前海期货

R瑞达期货

R瑞奇期货

S申万期货

S上海中期

S上海东方

S上海东亚

S盛达期货

S山西三立

S神华期货

S首创京都

S山金期货

T铜冠金源

T天富期货

T通惠期货

T天鸿期货

T天风期货

W五矿经易

X先锋期货

X兴证期货

X兴业期货

X新湖期货

X新世纪期货

X先融期货

X西部期货

X西南期货

X信达期货

X新纪元期货

X鑫鼎盛期货

Y银河期货

Y英大期货

Y永安期货

Y一德期货

Z中信建投

Z中融汇信

Z招金期货

Z中财期货

Z中钢期货

Z中辉期货

Z中信期货

Z中天期货

Z中粮期货

Z中州期货

Z中原期货

Z浙商期货

Z浙江中大

Z中投天琪

Z招商期货

Z中航期货

Z中衍期货