# SUBSCRIBE Positions **REQUEST** ``` * \*data\*\* array of strings required\ Channel name: `positions` ```


`</th> </tr>`
* \op\\* string required Operation code allowed values: `subscribe` `unsubscribe`

Example

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

**RESPONSE** ``` data.**timestamp** string required\ Update timestamp in UNIX timestamp in nanoseconds. Eg. `1680249600000000000` data.**positions** array of objects required\ Positions in `Position` object format.

**POSITION OBJECT**

**instrument_id** string required Instrument ID number. Eg. `12`

**instrument_name** string required Instrument name. Eg. `ETH-24DEC22-1250-C`

**instrument_type** string required Type of instrument. Allowed values: `OPTION` `PERPETUAL`

**amount** string required Amount of contracts. Negative amount means the position is net short. Eg. `12.23`

**mark_price** string required Mark price. Eg. `12.23`

**option** object

**OPTION OBJECT**

**strike** string required Option strike price. Eg. `2500`

**option_type** string required Type of option contract. Allowed values: `call` `put`

**expiry** string required Option expiry in UNIX timestamp in nanoseconds. Eg. `1680249600000000000`

**iv** string required Implied volatility. Eg. `0.23`

**delta** string required Option's Delta. Eg. `0.23`

**theta** string required Option's Theta. Eg. `0.23`

**rho** string required Option's Rho. Eg. `0.23`

**vega** string required Option's Vega. Eg. `0.23`

**asset** string required Name of underlying asset. Eg. `ETH`

**side** string required Trade side. Allowed values: `buy` `sell`

**avg_entry_price** string required Average entry price. Eg. `12.23`

**unrealized_pnl** string required Unrealized PNL. Eg. `12.23`

**maintenance_margin** string required Maintenance margin. Eg. `12.23`

```


`</th> </tr>`
* \channel\\* string required Channel name: `positions`

Example

```json { "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" } ] } } ```

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aevo.xyz/api-reference/websocket-api/private-operations/subcribe-positions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.