exchange.CreateOrder()函数用于下单。
下单成功返回订单Id,下单失败返回空值。FMZ平台的订单{@struct/Order Order}结构的属性Id由交易所品种代码和交易所原始订单Id组成,以英文逗号分隔。例如OKX交易所的现货交易对ETH_USDT订单的属性Id格式为:ETH-USDT,1547130415509278720。
调用exchange.CreateOrder(symbol, side, price, amount)函数下单时,返回值订单Id与订单{@struct/Order Order}结构的Id属性一致。
string / 空值
exchange.CreateOrder(symbol, side, price, amount) exchange.CreateOrder(symbol, side, price, amount, …args)
参数symbol用于指定订单的交易对或合约代码。
当调用exchange.CreateOrder(symbol, side, price, amount)函数下单时,若exchange为现货交易所对象,订单计价币种为USDT,交易币种为BTC,则参数symbol为:"BTC_USDT",格式为FMZ平台定义的交易对格式。
当调用exchange.CreateOrder(symbol, side, price, amount)函数下单时,若exchange为期货交易所对象,订单为BTC的U本位永续合约,则参数symbol为:"BTC_USDT.swap",格式为FMZ平台定义的交易对与合约代码的组合,以字符”.“分隔。
当调用exchange.CreateOrder(symbol, side, price, amount)函数下单时,若exchange为期货交易所对象,订单为BTC的U本位期权合约,则参数symbol为:"BTC_USDT.BTC-240108-40000-C"(以币安期权BTC-240108-40000-C为例),格式为FMZ平台定义的交易对与交易所定义的具体期权合约代码的组合,以字符”.“分隔。
symbol
true
string
参数side用于指定订单的交易方向。
对于现货交易所对象,side参数的可选值为:buy、sell。buy表示买入,sell表示卖出。
对于期货交易所对象,side参数的可选值为:buy、closebuy、sell、closesell。buy表示开多仓,closebuy表示平多仓,sell表示开空仓,closesell表示平空仓。
side
true
string
参数price用于设置订单价格。当价格为-1时,表示该订单为市价单。
price
true
number
参数amount用于设置订单的下单量。需要注意,当订单为现货市价买单时,下单量为买入金额;个别现货交易所的市价买单下单量为交易币数量,具体请查看《用户指南》中的交易所特殊说明。对于期货交易所对象,使用CreateOrder()/Buy()/Sell()函数下单时,如无特殊说明,下单量参数amount均为合约张数。
amount
true
number
扩展参数,可以将附加信息输出到此条下单日志中,arg参数可以传入多个。
arg
false
string / number / bool / object / array / any (平台支持的任意类型)
function main() {
var id = exchange.CreateOrder("BTC_USDT", "buy", 60000, 0.01) // 现货交易所对象下单币币交易BTC_USDT交易对
// var id = exchange.CreateOrder("BTC_USDT.swap", "buy", 60000, 0.01) // 期货交易所对象下单BTC的U本位永续合约
Log("Order Id:", id)
}
def main():
id = exchange.CreateOrder("BTC_USDT", "buy", 60000, 0.01) # 现货交易所对象下单币币交易BTC_USDT交易对
# id = exchange.CreateOrder("BTC_USDT.swap", "buy", 60000, 0.01) # 期货交易所对象下单BTC的U本位永续合约
Log("Order Id:", id)
void main() {
auto id = exchange.CreateOrder("BTC_USDT", "buy", 60000, 0.01); // 现货交易所对象下单币币交易BTC_USDT交易对
// auto id = exchange.CreateOrder("BTC_USDT.swap", "buy", 60000, 0.01); // 期货交易所对象下单BTC的U本位永续合约
Log("Order Id:", id);
}
现货交易所对象、期货交易所对象调用exchange.CreateOrder()函数下单。
{@fun/Trade/exchange.Buy exchange.Buy}, {@fun/Trade/exchange.Sell exchange.Sell}