SUBCRIBE Positions

REQUEST


op* string required Operation code allowed values: `subscribe` `unsubscribe`
data* array of strings required Channel name: `positions`

Example

{
	"op":"subscribe", 
	"data": ["positions"]
}

RESPONSE

*channel** string required
Channel name: positions

data.timestampstringrequired
Update timestamp in UNIX timestamp in nanoseconds. Eg. 1680249600000000000

data.positions array of objects required
Positions in Position object format.

POSITION OBJECT

instrument_idstringrequired
Instrument ID number. Eg. 12

instrument_namestringrequired
Instrument name. Eg. ETH-24DEC22-1250-C

instrument_typestringrequired
Type of instrument. Allowed values: OPTIONPERPETUAL

amountstringrequired
Amount of contracts. Negative amount means the position is net short. Eg. 12.23

mark_pricestringrequired
Mark price. Eg. 12.23

optionobject

OPTION OBJECT

strikestringrequired
Option strike price. Eg. 2500

option_typestringrequired
Type of option contract. Allowed values: callput

expirystringrequired
Option expiry in UNIX timestamp in nanoseconds. Eg. 1680249600000000000

ivstringrequired
Implied volatility. Eg. 0.23

deltastringrequired
Option's Delta. Eg. 0.23

thetastringrequired
Option's Theta. Eg. 0.23

rhostringrequired
Option's Rho. Eg. 0.23

vegastringrequired
Option's Vega. Eg. 0.23

assetstringrequired
Name of underlying asset. Eg. ETH

sidestringrequired
Trade side. Allowed values: buysell

avg_entry_pricestringrequired
Average entry price. Eg. 12.23

unrealized_pnlstringrequired
Unrealized PNL. Eg. 12.23

maintenance_marginstringrequired
Maintenance margin. Eg. 12.23

Example

{
	"channel": "positions",
	"data": {
		"timestamp": "1673671845685460000",
		"positions": [
			{
				"instrument_id": "12",
				"instrument_name": "ETH-30JUN23-1600-C",
				"instrument_type": "OPTION",
				"amount": "12.23",
				"mark_price": "12.23",
				"option": {
					"iv": "0.23",
					"strike": "2500",
					"option_type": "put",
					"expiry": "1680249600000000000",
					"delta": "0.23",
					"theta": "0.23",
					"vega": "0.23",
					"rho": "0.23"
				},
				"asset": "ETH",
				"side": "buy",
				"avg_entry_price": "12.23",
				"unrealized_pnl": "12.23",
				"maintenance_margin": "12.23"
			}
		]
	}
}