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 create_trader
trader = create_trader(
    brokerID='yjb',
    account='你的佣金宝账号',
    password='加密后的密码'
)

print(trader.portfolio)

print(trader.orderlist)

支持券商

• 广发证券————('gf')
• 国金证券（佣金宝)———('yjb')
• 雪球组合管理———('xq')

主要接口介绍

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 —— 银证转账转出证券账户

组合委托下单指令

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

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

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

• order —— 基本组合下单交易
• order_target_amount —— 设定目标持仓股数进行下单
• order_target_volume —— 设定目标持仓市值进行下单
• order_target_percent —— 设定目标持仓比例进行下单

版本信息

0.1.2

创建第一个版本号 实现功能：

1. 广发证券
2. 国金证券
3. 雪球组合