> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/positions/get-all-positions-info.md).

# Get All Positions Info

## Get All Positions Info

Returns the authenticated account's position rows together with account-level margin and collateral metrics.

### Endpoint

**GET /v1/positions**

Mainnet: GET <https://api.orderly.org/v1/positions\\>
Testnet: GET <https://testnet-api.orderly.org/v1/positions>

Rate limit: 30 requests per 10 seconds per user.

### Headers

* `orderly-timestamp` (string, required): Signed request timestamp in milliseconds.
* `orderly-account-id` (string, required): Authenticated account ID.
* `orderly-key` (string, required): Public key used to sign the request.
* `orderly-signature` (string, required): Signature of the request payload.

### Parameters

No query or path parameters.

### Response

HTTP 200 returns `success`, `data`, and server `timestamp`. The account-level data includes required numeric values: `current_margin_ratio_with_orders`, `free_collateral`, `initial_margin_ratio`, `initial_margin_ratio_with_orders`, `maintenance_margin_ratio`, `maintenance_margin_ratio_with_orders`, `margin_ratio`, `open_margin_ratio`, `total_collateral_value`, and `total_pnl_24_h`. `account_value` is also returned.

`data.rows` is an array of positions. Each row may include numeric `IMR_withdraw_orders`, `MMR_with_orders`, `average_open_price`, `cost_position`, `est_liq_price`, `fee_24_h`, `imr`, `last_sum_unitary_funding`, `mark_price`, `mmr`, `pending_long_qty`, `pending_short_qty`, `pnl_24_h`, `position_qty`, `settle_price`, `seq`, `timestamp` (position entry creation time), `updated_time`, `unsettled_pnl`, `margin`, and `accrued_funding_fee`; `symbol` and `margin_mode` are strings; `leverage` is an integer.

```
{"success":true,"data":{"current_margin_ratio_with_orders":1.2385,"free_collateral":450315.09115,"initial_margin_ratio":0.1,"initial_margin_ratio_with_orders":0.1,"maintenance_margin_ratio":0.05,"maintenance_margin_ratio_with_orders":0.05,"margin_ratio":1.2385,"open_margin_ratio":1.2102,"total_collateral_value":489865.71329,"total_pnl_24_h":0,"rows":[{"symbol":"PERP_BTC_USDC","position_qty":-5,"average_open_price":27908.14386047,"mark_price":27794.9,"settle_price":27865.8716984,"est_liq_price":117335.92899428,"unsettled_pnl":354.858492,"leverage":10,"margin_mode":"CROSS","margin":0,"accrued_funding_fee":0.005202}],"account_value":40.63345663},"timestamp":1702989203989}
```
