Isolated Positions

Get existing open isolated positions for a provided cross subaccount.

Rate limits

• 1200 requests/min or 200 requests every 10 seconds per IP address. (weight = 2)

See more details in API Rate limits

Request

Websocket

Connect

WEBSOCKET [GATEWAY_WEBSOCKET_ENDPOINT]

Message

{
    "type": "isolated_positions",
    "subaccount": "0xeae27ae6412147ed6d5692fd91709dad6dbfc34264656661756c740000000000"
}

REST (GET)

GET [GATEWAY_REST_ENDPOINT]/query?type=isolated_positions&subaccount={subaccount}

REST (POST)

POST [GATEWAY_REST_ENDPOINT]/query

Message

{
    "type": "isolated_positions",
    "subaccount": "0xeae27ae6412147ed6d5692fd91709dad6dbfc34264656661756c740000000000"
}

Request Parameters

Parameter	Type	Required	Description
subaccount	string	Yes	A bytes32 sent as a hex string; includes the address and the subaccount identifier. See sender field structure for details.

Response

Note:

• isolated_positions[i].subaccount: is the isolated subaccount for the base product.

• healths:

  • healths[0]: info about your initial health, which is weighted by long_weight_initial_x18 and short_weight_initial_x18.

  • healths[1]: info about your maintenance health, which is weighted by long_weight_maintenance_x18 and short_weight_maintenance_x18.

  • healths[2]: info about your unweighted health.

{
  "status": "success",
  "data": {
    "isolated_positions": [
      {
        "subaccount": "0xeae27ae6412147ed6d5692fd91709dad6dbfc34200000000000000280269736f",
        "quote_balance": {
          "product_id": 0,
          "lp_balance": {
            "amount": "0"
          },
          "balance": {
            "amount": "200044412311089295472",
            "last_cumulative_multiplier_x18": "1097675096214613904"
          }
        },
        "base_balance": {
          "product_id": 40,
          "lp_balance": {
            "amount": "0",
            "last_cumulative_funding_x18": "0"
          },
          "balance": {
            "amount": "1720000000000000000000",
            "v_quote_balance": "-800854578334374649165",
            "last_cumulative_funding_x18": "85496772388082947"
          }
        },
        "quote_product": {
          "product_id": 0,
          "oracle_price_x18": "1000000000000000000",
          "risk": {
            "long_weight_initial_x18": "1000000000000000000",
            "short_weight_initial_x18": "1000000000000000000",
            "long_weight_maintenance_x18": "1000000000000000000",
            "short_weight_maintenance_x18": "1000000000000000000",
            "large_position_penalty_x18": "0"
          },
          "config": {
            "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
            "interest_inflection_util_x18": "800000000000000000",
            "interest_floor_x18": "10000000000000000",
            "interest_small_cap_x18": "40000000000000000",
            "interest_large_cap_x18": "1000000000000000000"
          },
          "state": {
            "cumulative_deposits_multiplier_x18": "1097675096214613904",
            "cumulative_borrows_multiplier_x18": "1166015186852074795",
            "total_deposits_normalized": "22809170545456359355285848",
            "total_borrows_normalized": "17529305597694020774669111"
          },
          "lp_state": {
            "supply": "0",
            "quote": {
              "amount": "0",
              "last_cumulative_multiplier_x18": "1097675096214613904"
            },
            "base": {
              "amount": "0",
              "last_cumulative_multiplier_x18": "1097675096214613904"
            }
          },
          "book_info": {
            "size_increment": "0",
            "price_increment_x18": "0",
            "min_size": "0",
            "collected_fees": "0",
            "lp_spread_x18": "0"
          }
        },
        "base_product": {
          "product_id": 40,
          "oracle_price_x18": "446392009987515605",
          "risk": {
            "long_weight_initial_x18": "900000000000000000",
            "short_weight_initial_x18": "1100000000000000000",
            "long_weight_maintenance_x18": "950000000000000000",
            "short_weight_maintenance_x18": "1050000000000000000",
            "large_position_penalty_x18": "0"
          },
          "state": {
            "cumulative_funding_long_x18": "85496772388082947",
            "cumulative_funding_short_x18": "85496772388082947",
            "available_settle": "1520756601047227411193",
            "open_interest": "270380000000000000000000"
          },
          "lp_state": {
            "supply": "0",
            "last_cumulative_funding_x18": "85496772388082947",
            "cumulative_funding_per_lp_x18": "0",
            "base": "0",
            "quote": "0"
          },
          "book_info": {
            "size_increment": "20000000000000000000",
            "price_increment_x18": "100000000000000",
            "min_size": "1000000000000000000000",
            "collected_fees": "0",
            "lp_spread_x18": "3000000000000000"
          }
        },
        "quote_healths": [
          "200044412311089295472",
          "200044412311089295472",
          "200044412311089295472"
        ],
        "base_healths": [
          "-109839746873700492625",
          "-71450034014774150595",
          "-33060321155847808565"
        ],
        "healths": [
          {
            "assets": "200044412311089295472",
            "liabilities": "109839746873700492625",
            "health": "90204665437388802847"
          },
          {
            "assets": "200044412311089295472",
            "liabilities": "71450034014774150595",
            "health": "128594378296315144877"
          },
          {
            "assets": "200044412311089295472",
            "liabilities": "33060321155847808565",
            "health": "166984091155241486907"
          }
        ]
      }
    ]
  },
  "request_type": "query_isolated_positions"
}