---
updatedAt: 2025-09-30T09:47:25.000Z
agentTools:
  projectIndex: https://api-docs.aevo.xyz/llms.txt
---

# SUBCRIBE Positions

<div class="ws-method-div"><span class="APIMethod APIMethod_fixedWidth ws-sub-tag">SUB</span> <span class="ws-small-font">wss://ws.aevo.xyz</span></div>

<span class="ws-description"> Returns relevant positions if any changes occur. </span>

<span class="ws-small-font">**REQUEST**</span>

<Table align={["left"]}>
  <thead>
    <tr>
      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        * \*op\*\* <span class="ws-data-type ws-small-font">string</span>  <span class="ws-required-tag ws-small-font">required</span>
          Operation code allowed values: `subscribe` `unsubscribe`
      </td>
    </tr>

    <tr>
      <td>
        * \*data\*\* <span class="ws-data-type ws-small-font">array of strings</span>  <span class="ws-required-tag ws-small-font">required</span>\
          Channel name: `positions`
      </td>
    </tr>
  </tbody>
</Table>

<details>
<summary>Example</summary>

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

</details>
<br/>

<span class="ws-small-font">**RESPONSE**</span>

<Table align={["left"]}>
  <thead>
    <tr>
      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        * \*channel\*\* <span class="ws-data-type ws-small-font">string</span>  <span class="ws-required-tag ws-small-font">required</span>
          Channel name: `positions`
      </td>
    </tr>

    <tr>
      <td>
        <span class="ws-small-font">data.</span>**timestamp** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>\
        Update timestamp in UNIX timestamp in nanoseconds. Eg. `1680249600000000000`
      </td>
    </tr>

    <tr>
      <td>
        <span class="ws-small-font">data.</span>**positions** <span class="ws-data-type ws-small-font">array of objects</span> <span class="ws-required-tag ws-small-font">required</span>\
        Positions in `Position` object format.  

        <div style={{ height: "10px" }}></div><table><tr><td class="child-header">**POSITION OBJECT**</td></tr><tr><td>**instrument_id** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Instrument ID number. Eg. `12` </td></tr><tr><td>**instrument_name** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Instrument name. Eg. `ETH-24DEC22-1250-C`</td></tr><tr><td>**instrument_type** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Type of instrument. Allowed values: `OPTION` `PERPETUAL`</td></tr><tr><td>**amount** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Amount of contracts. Negative amount means the position is net short. Eg. `12.23`</td></tr><tr><td>**mark_price** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Mark price. Eg. `12.23`</td></tr><tr><td>**option** <span class="ws-data-type ws-small-font">object</span>  
        <div style={{ height: "10px" }}></div><table><tr><td class="child-header">**OPTION OBJECT**</td></tr><tr><td>**strike** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Option strike price. Eg. `2500` </td></tr><tr><td>**option_type** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Type of option contract. Allowed values: `call` `put` </td></tr><tr><td>**expiry** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Option expiry in UNIX timestamp in nanoseconds. Eg. `1680249600000000000` </td></tr><tr><td>**iv** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Implied volatility. Eg. `0.23`</td></tr><tr><td>**delta** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Option's Delta. Eg. `0.23`</td></tr><tr><td>**theta** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Option's Theta. Eg. `0.23`</td></tr><tr><td>**rho** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Option's Rho. Eg. `0.23`</td></tr><tr><td>**vega** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Option's Vega. Eg. `0.23`</td></tr></table></td></tr><tr><td>**asset** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Name of underlying asset. Eg. `ETH`</td></tr><tr><td>**side** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Trade side. Allowed values: `buy` `sell`</td></tr><tr><td>**avg_entry_price** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Average entry price. Eg. `12.23`</td></tr><tr><td>**unrealized_pnl** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Unrealized PNL. Eg. `12.23`</td></tr><tr><td>**maintenance_margin** <span class="ws-data-type ws-small-font">string</span> <span class="ws-required-tag ws-small-font">required</span>  
        Maintenance margin. Eg. `12.23`</td></tr></table>
      </td>
    </tr>
  </tbody>
</Table>

<details>
<summary>Example</summary>

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

```

</details>
<br/>