输入/搜索内容
内置函数
结构体
Ticker
Depth
OrderBook
Trade
Record
Market
Order
Condition
Account
Asset
Position
Funding
其它结构
内置变量与常量
通用约定
交易所

exchange.GetPositions()返回的持仓:品种、杠杆、持仓量与冻结量、持仓均价、浮动盈亏、持仓方向、合约代码与保证金。

属性

名称类型描述

Info

object

交易所接口返回的原始数据,回测时无此属性。

Symbol

string

FMZ定义的品种代码,写法见品种代码,例如现货BTC_USDT、期货BTC_USDT.swap(USDT本位永续合约),格式与Ticker的Symbol相同。

MarginLevel

number

持仓杆杠大小,如果交易所接口没有提供该数据则通过计算填充,可能会有误差。

Amount

number

持仓量,通常是正整数(合约张数)。注意每个交易所的合约乘数、价值等合约规格可能不一样。

FrozenAmount

number

仓位冻结量,平仓单未成交时的临时冻结仓位数量。

Price

number

持仓均价,原则上该属性为仓位总体的平均价格(不参与结算), 如果交易所接口没有提供该数据则用交易所接口现有的持仓均价填充(参与结算)。

Profit

number

持仓浮动盈亏,原则上为持仓的未实现盈亏,如果交易所接口没有提供该数据则用交易所接口其它盈亏数据填充,盈亏数值的单位和当前合约保证金的单位相同。

Type

number

仓位类型,参考PD_LONG, PD_SHORT。

ContractType

string

合约代码,具体可以参看exchange.SetContractType函数的描述内容。

Margin

number

仓位占用的保证金,如果交易所接口没有提供该数据则使用0填充。

参考

备注

exchange.GetPositions()函数返回一个Position数组,没有持仓时为空数组,调用失败时返回空值(JavaScript为null,Python为None)。

对于加密货币期货需要注意,exchange.GetPositions()函数返回的Position结构数组。
对于其中持仓数据结构中的FrozenAmount、Profit、Margin属性,由于交易所提供数据并不统一,不同交易所对象调用exchange.GetPositions()接口时返回的数据的定义可能不同。
例如,有些交易所持仓数据中无仓位冻结数据,此时FrozenAmount为0。 如果需要计算某些数据可以使用Info属性中的原始数据计算分析。