vxTrader

vxTrader

一个标准化，统一封装的A股券商web 交易接口。

安装方法

1. 安装tesseract-ocr 程序，用于校验码识别

apt-get install tesseract-ocr

2. 安装依赖库

pip3 install -r requirements.txt

3. 安装vxTrader

pip3 install vxTrader

使用方法

from vxTrader import Trader
trader = Trader(
    brokerID='gf',
    account='加密后广发账号',
    password='加密后的密码'
)

print(trader.portfolio)

print(trader.orderlist)

支持券商

• 广发证券————('gf')

• 雪球组合管理———('xq')

• 国金证券（佣金宝)———('yjb') 11月30日以后，佣金宝不再提供web交易接口

主要接口介绍

hq——实时行情接口（level 1）

支持单只股票实时行情查询

df = trader.hq('sz150023')

或者是 多只股票实时行情查询

df = trader.hq(['sz150023','sz150022'])

返回一个pandas.DataFrame格式的数据

• index

symbol : 被查询的股票

• columns

[
    "name", "open", "yclose", "lasttrade", "high", "low", "bid", "ask",
    "volume", "amount", "bid1_m", "bid1_p", "bid2_m", "bid2_p", "bid3_m",
    "bid3_p", "bid4_m", "bid4_p", "bid5_m", "bid5_p", "ask1_m", "ask1_p",
    "ask2_m", "ask2_p", "ask3_m", "ask3_p", "ask4_m", "ask4_p", "ask5_m",
    "ask5_p", "date", "time", "status"
]

portfolio——查询当前的持仓状况

trader.portfolio

返回pandas.DataFrame格式的数据

• index

symbol : 持仓股票,'cash' 标识现金持有情况

• columns:

symbol_name : 股票名称

current_amount : 当前持有股数

enable_amount : 当前可卖股数

lasttrade : 最近成交价格

market_value : 证券市值

weight : 持仓权重（精确到小数点后4为)

orderlist ——委托订单查询（当日）

trader.orderlist

返回pandas.DataFrame格式的数据

• index

order_no : 订单号

• columns

symbol : 交易证券代码

symbol_name : 交易证券名称

trade_side : 交易方向， '买入' 或 '卖出'

order_price : 下单价格

order_amount : 下单数量

business_price : 已成交平均成交价格

business_amount : 已成交的数量

order_status : 订单状态: 如'已报','未报','部成','部撤','已撤','已成'

order_time : 下单时间

基本委托下单指令

• buy —— 股票/ETF/LOF买入
• sell —— 股票/ETF/LOF卖出
• subscription —— 场内基金/分级基金申购
• redemption —— 场内基金/分级基金赎回
• split —— 分级基金拆分
• merge —— 分级基金合并
• cancel —— 撤单
• ipo_subscribe —— 新股申购交易
• trans_in —— 银证转账转入证券账户
• trans_out —— 银证转账转出证券账户
• ipo_list —— ipo申购股票情况
• ipo_limits —— ipo申购额度查询

组合委托下单指令

组合下单时，程序会每隔5秒对成交情况进行监控，并持续10次；

如果不成交，将进行撤单并且按照最新的价格进行下单，以确保最快速的达成交易;

下单指令返回后，这个交易指令下达的所有未成交的订单都会被 撤销 。

• order —— 基本组合下单交易

trader.order('sh511880',amount=500)

trader.order('sh511880',volume=50000)

trader.order('sh511880',weight=0.2)

• order_target —— 按照目标持股数量、持股市值、持股比例下单

trader.order_target('sh511880', target_amount=500)

trader.order_target('sh511880', target_volume=50000)

trader.order_target('sh511880', target_weight=0.2)

• order_auto_ipo —— 自动IPO申购

trader.order_auto_ipo()

• order_transfer_to —— 调仓操作

trader.order_transfer_to(source_symbol='sh511880', target_symbol='sh511010', transfer_amount=100)

• order_cashout -- 套现交易

trader.order_cashout(['sh511880','sh511010'], 30000)

版本信息

参见ChangeLog.md