4.下单函数

下单函数

摘要

• API文档的使用
• 常用下单函数
• 回测日志

- API文档

• 聚宽设计的函数(如前文所说准确叫法是API)的用法都写在API文档里，位置在聚宽网站导航栏-帮助-API文档。

• 接下来以order为例讲下文档怎么看。在API文档中找到 order - 按股数下单的说明，如下：
  

- order的各个参数

• • security 标的代码，数据类型要求是字符串，想知道 基金、期货、指数的代码都是什么，可以在这里看聚宽数据,比如聚宽数据-向下滚动页面-点击指数数据，可以看到各指数的代码。特别的是股票代码目前没有页面，但只需在平时使用的股票代码后面加后缀就好了，深交所（深交所股票0开头）股票代码后缀为.XSHE,如000001.XSHE,上交所股票代码（上交所股票6开头）后缀为.XSHG 如600000.XSHG。
  • amount 交易数量, 正数表示买入, 负数表示卖出，没什么可说的。
  • style参数决定下的订单是市价单还是限价单，默认是None代表市价单。目前就用默认吧，限价单以后讲。
  • side参数决定是开空单还是多单，默认为多单，股票只能多单，股指期货等其他品类可以开空单。
  • pindex参数是在多资金仓位时选择资金仓位的，股票一般用不到。

- 常用的下单函数

• 常用的下单函数有四个，使用方法和order()差不多，可能有人自己看API文档就能学会了。接下来我们分别介绍下基本用法，同样的不讲style，side，pindex这三个参数。

• order(security,amount)，刚刚细讲过，含义是买卖一定数量的（单位：股）股票。security是股票代码，amount是数量，amount为负数时就是代表卖出了，需要知道的是，国内股票买入最小单位是1手即100股。例子如下：

    # 买入100股平安银行
    order("000001.XSHE",100)
    # 卖出100股平安银行
    order("000001.XSHE",-100)
  

• order_target(security,amount)，含义是通过买卖，将股票仓位调整至一定数量（单位：股）。security是股票代码，amount是数量。例子如下：

    # 调整平安银行的持股数量至1000股
    # 即，如果目前平安银行的持股数量低于1000股就买入，高于就是卖出，不高不低就不动。
    order_target("000001.XSHE",1000)
  

• order_value(security,value)，含义是买卖一定价值量（单位：元）股票。security是股票代码，value是价值量。value为负数时就是代表卖出了。例子如下：

    # 买入10000元的平安银行
    # 如果当前股票市价是10元，则代表买入1000股
    # 如果除不开系统会自动调整成相近的合理数量。卖出时也会。
    order_value("000001.XSHE",10000)
    # 卖出10000元的平安银行
    # 如果当前股票市价是100元，则代表卖出100股
    order_value("000001.XSHE",-10000)
  

• order_target_value(security,value)，通过买卖，将股票仓位调整至一定价值量（单位：元）。security是股票代码，value是价值量。例子如下：

    # 调整平安银行的持股价值量至10000元
    # 即，如果目前平安银行的持股价值量（按股票市价算）低于10000元就买入，高于就是卖出，不高不低就不动。
    order_target_value("000001.XSHE",10000)
  

- 读者在尝试练习使用这些语句的时候，可以点击运行回测，通过查看回测结果页中的交易详情来看语句的执行效果，同时也可以看下日志。如下：