python量化交易：Joinquant_量化交易基础【四】：下单、函
数、API
本⽂是量化交易零基础⼊门教程的第四篇。
摘要
函数与API
函数使⽤⽅法
如何看API⽂档
⾃定义函数⽅法
常⽤的下单函数
⾃测与⾃学
我们继续以前⽂策略代码为例进⾏讲解，如下：
def initialize(context):
run_daily(period,time='every_bar')
g.security = '000001.XSHE'
def period(context):
order(g.security, 100)
通过前⽂讲解，现在这段代码中就剩这句下单语句还没讲了。为了理解这条语句，需要学习下python中函数的知识。
order(g.security, 100)
函数与API
基于web翻译软件怎么做函数是封装好的，可重复使⽤的 ，⽤来实现专⼀功能的代码段。函数能使代码易于维护与交流，提⾼编写策略的效率。通俗的理解是，把⼀系列代码指令包起来就是⼀个函数，起个名字就是函数名，之后⽤这个函数名，就知道这个名字指代那被包起来的⼀系列代码指令了。
Python语⾔⾃带了许多内建函数，⽐如之前见过的print()、type()都是Python⾃带的函数，可以直接⽤。你也可以⾃⼰创建函数⾃⼰⽤，这被叫做⾃定义函数。⽐如如下这段框架代码其实就是⾃定义了⼀个名为period的函数，该函数内包了⼀个聚宽系统⾃带的函数order()：
def period(context):
order(g.security, 100)
order()的准确称谓其实是API（application programming interface，即应⽤程序编程接⼝），API的含义与函数有所不同，解释起来略复杂。不过实际使⽤中跟函数⼏乎没有差别，可以理解成聚宽平台基于python封装⽽成的函数。在中你可以看到除order()外其他API。
使⽤⼀个函数
在使⽤函数的时候，通常需要提供⼀些参数(也有可能不需要)，函数根据提供的参数，执⾏⼀系列的函数作者设计好的操作，往往也会根据提供的参数返回结果（也可能返回为空，即不返回），如下：
# ⽤法: 函数名(参数，参数,......)
# 例⼦如下：
# 提供了两个参数g.security和100，执⾏了买⼊g.security中数据对应的股票100股的操作
order(g.security, 100)
# 提供了⼀个参数"你好"，执⾏了打印"你好"的操作
print("你好")
# 提供了⼀个参数"1"给type()函数，type函数执⾏了识别"1"数据类型的操作，并返回了"1"数据类型为结果。
# type返回的结果被当做参数提供给了print(),print执⾏了打印type返回的结果的操作
# type与print的嵌套使⽤，实现了打印"1"数据类型的操作。
print(type("1"))
可见，函数的功能多种多样，需要参数、返回的结果亦不尽相同，所以具体怎么⽤需要看函数作者提供的说明⽂档，或者看函数内的设计代码⾃⼰推断。函数内的代码不见得看得到，看到不⼀定看得懂，想看懂也可能很⾟苦。所以⼀般函数的⽤法要看函数作者提供的说明⽂档。
聚宽设计的函数(如前⽂所说准确叫法是API)的⽤法都写在API⽂档⾥，位置在聚宽⽹站导航栏-帮助-API⽂档。
接下来以order为例讲下⽂档怎么看。在API⽂档中到 的说明，如下：
可以看到，order可接受的参数有5个，分别是security，amount，style，side，pindex，这五个参数的名字与含义是函数作者设计的。意思是你使⽤order提供参数的时候，被提供参数将按提供的顺序依次对应这5个参数。⽐如下⾯的写法就是错误的。
# 函数会按顺序把100对应为security，即股票代码，把"000001.XSHE"对应为amount，即要交易的数量。所以就会错。
order(100,"000001.XSHE")
不按顺序提供参数的正确写法如下：
# ⽤等号表⽰对应关系，参数名写前，要当做参数的变量或数据写在后
# 如下是把100当做amount参数，把"000001.XSHE"当做security参数。
order(amount=100,security="000001.XSHE")
可以发现有些参数后⾯有等号，如style=None，含义style参数不提供的话，会被默认是None，其他的side='long', pindex=0也是⼀样的道理，如果不提供会被默认是等号后⾯的内容。所以前⽂order()只写了两个参数也不会错。注意，security和amount后⾯没有等号，即没有默认值，则必须提供参数不能省略。
2022《新神榜:杨戬》免费观看
# 以下两句含义相同
order("000001.XSHE",100)
order("000001.XSHE",100,None,'long',0)
细说下order的各个参数
security 标的代码，数据类型要求是字符串，想知道 基⾦、期货、指数的代码都是什么，可以在这⾥看,⽐如聚宽数据-向下滚动页⾯-点击指数数据，可以看到各指数的代码。特别的是股票代码⽬前没有页⾯，但只需在平时使⽤的股票代码后⾯加后缀就好了，深交所（深交所股票0开头）股票代码后缀为.XSHE，如000001.XSHE，上交所股票代码（上交所股票6开头）后缀为.XSHG 如600000.XSHG。
amount 交易数量, 正数表⽰买⼊, 负数表⽰卖出，没什么可说的。
style参数决定下的订单是市价单还是限价单，默认是None代表市价单。⽬前就⽤默认吧，限价单以后讲。
数学函数的基本公式
side参数决定是开空单还是多单，默认为多单，股票只能多单，股指期货等其他品类可以开空单。
b站怎么切换html5播放器pindex参数是在多资⾦仓位时选择资⾦仓位的，股票⼀般⽤不到。
根据说明⽂档，order函数是有返回值的，如果创建订单成功, 则返回Order对象, 失败则返回None。有返回值不⼀定要⽤，⽐如前⽂的例⼦都没⽤到这个返回值，实际上策略做的相当完备的时候才可能⽤到。⼀般⽤法是，根据返回值是否是None，判断是否下单成功，成功时，根据返回值可以查询订单或取消订单等。不过具体实现⽅法、以及Order对象是什么，还需要学习很多的知识，后续可能会讲到。
⾃定义函数
Python 定义函数使⽤ def 关键字，⼀般格式如下：
def 函数名(参数列表):
函数体
函数名即为该函数起的名字，函数体即包在函数中的⼀系列操作的代码，参数列表即使⽤函数需要提供的参数，⽐如⼀个根据圆半径求周长的函数如下：
# 根据圆半径r求周长l
def yuan(r):计算机入门自学教程python
p=3.14
l=2*p*r
return l
return的含义是结束函数的运⾏并返回⼀个值，如上例⼦中就是返回了算好的周长l。如果return后什么也不写就是返回None即空，如果不写return，函数体运⾏完后，⾃动return None。
⾄此，你应该意识到，函数内部是相对独⽴的，数据想进来要通过参数传进来，想出去要通过返回值传出去，函数从获得参数到返回值的过程中所产⽣的数据与变量中没通过返回值传出去的，在函数运⾏结束后（即返回值后）都将被计算机释放不再存储。如果想函数间通⽤某变量可以考虑⽤之前讲的全局变量。
如前⽂讲使⽤函数时看到的，可以⽤等号给参数附加默认值，⽽且可以⽤逗号分隔分隔多个参数，例⼦如下:
# 根据圆半径r求周长l的k分之⼀
def yuan(r,k=1):
p=3.14
l=2*p*r/k
return l
编程狮会员值得买吗
在返回值的时候可以返回多个变量，例⼦如下:
# 根据圆半径r求周长l与⾯积s的k分之⼀
def yuan(r,k=1):
p=3.14
l=2*p*r/k
s=p*r*r/k
return l,s
使⽤⾃定义函数的⽅法跟前⽂讲的使⽤函数的⽅法⼀致，需要说明的是定义函数的代码放的位置，如下：
常⽤的下单函数
常⽤的下单函数有四个，使⽤⽅法和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)
读者在尝试练习使⽤这些语句的时候，可以点击运⾏回测，通过查看回测结果页中的交易详情来看语
句的执⾏效果，同时也可以看下⽇志。如下：
股票拆分合并和分红，交易的税费，下单导致成交价向不利的⽅向波动，这些因素系统都是默认考虑并仿真处理的了，具体的详情以及下的订单系统是如何模拟真实情况撮合成交的，可以看下API⽂档。其实新⼿不⽤太关注 这些订单处理的细节，不核⼼，⽬前也不容易理解，可以等以后⾃⼰⽐较熟悉了再看。
⾃测与⾃学
实践下本⽂中的例⼦。
搜索了解下移动平均线（MA，均线）的计算⽅法。
搜索了解下市价单、限价单的含义。
⾃定义⼀个可计算包含若⼲数list中数的平均值的函数。即如果你定义的函数为pjs()，那么执⾏pjs([1,3,4,6])后，应该返回平均数
3.5。【提⽰：len()可⽤来计算list的长度，⽤法如len([1,2,3,4])】。

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。