--- updatedAt: 2026-10-01T18:13:49.000Z agentTools: projectIndex: https://docs.trade.mudrex.com/llms.txt --- # Open Positions List open futures positions for one currency. Supports `limit` (default 20) and epoch-ms `offset` paging. Get detailed info about your currently open positions, for one currency. `trade_currency` defaults to `USDT` when omitted; the response never mixes currencies, and each position carries a `trade_currency` tag. ### Request ```bash # USDT (default; up to 20 positions) curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions" \ -H "X-Authentication: your-secret-key" ``` ```bash # USDT with a higher page size curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions?trade_currency=USDT&limit=100" \ -H "X-Authentication: your-secret-key" ``` ```bash # Next page using time cursor (offset = epoch ms of oldest created_at from the previous page) curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions?trade_currency=USDT&limit=5&offset=1732000000000" \ -H "X-Authentication: your-secret-key" ``` ```bash # INR curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions?trade_currency=INR" \ -H "X-Authentication: your-secret-key" ``` **Parameters** | Parameter | Type | Required | Description | | ---------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | `trade_currency` | string | No | `USDT` or `INR`. Defaults to `USDT`. One currency per call. | | `limit` | number | No | Maximum number of open positions to return (default: 20). | | `offset` | number | No | Time cursor in **epoch milliseconds**, not a row index. Returns up to `limit` positions **older than** this timestamp. See Notes. | ### Response Status: `200 OK` USDT (default): ```json { "success": true, "data": [ { "created_at": "2026-10-01T18:04:17Z", "updated_at": "2026-10-01T18:04:47Z", "stoploss": { "price": "0.085", "order_id": "01a0f8a4-1289-7f13-8ab2-0c9c95e2a617", "order_type": "SHORT" }, "takeprofit": { "price": "0.11", "order_id": "01a0f8a4-1289-7f16-9fd8-82239532c514", "order_type": "SHORT" }, "entry_price": "0.09485", "quantity": "60", "leverage": "5", "liquidation_price": "0.0731", "initial_margin": "1.34088616", "maintenance_margin": "0.04533715", "entry_hedge_rate": "1", "order_type": "LONG", "status": "OPEN", "id": "01a0f8a3-7528-7016-bd45-9c387f8cc74b", "position_id": "01a0f8a3-7528-7016-bd45-9c387f8cc74b", "asset_uuid": "01903bcd-4ce6-7759-90ea-c6bc68608aea", "symbol": "DOGEUSDT", "trade_currency": "USDT" } ] } ``` INR (`?trade_currency=INR`): ```json { "success": true, "data": [ { "created_at": "2026-10-01T18:09:20Z", "updated_at": "2026-10-01T18:09:40Z", "stoploss": { "price": "0.105", "order_id": "01a0f8a8-6604-7e41-9ba7-c73393f63d21", "order_type": "LONG" }, "takeprofit": { "price": "0.085", "order_id": "01a0f8a8-6604-7e45-9d14-9169fccae833", "order_type": "LONG" }, "entry_price": "0.09491", "quantity": "60", "leverage": "5", "liquidation_price": "0.1179", "initial_margin": "146.57", "maintenance_margin": "4.76", "entry_hedge_rate": "102", "order_type": "SHORT", "status": "OPEN", "id": "01a0f8a8-15b3-7097-b547-325de06fc486", "position_id": "01a0f8a8-15b3-7097-b547-325de06fc486", "asset_uuid": "01903bcd-4ce6-7759-90ea-c6bc68608aea", "symbol": "DOGEUSDT", "trade_currency": "INR" } ] } ``` **Response fields** | Field | Description | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | Position UUID. | | `position_id` | Position UUID. Same value as `id`. See [Order and position IDs](https://docs.trade.mudrex.com/docs/order-position-ids). | | `symbol` | Trading pair (e.g. `SOMIUSDT`). | | `asset_uuid` | Asset UUID. | | `order_type` | Position side: `LONG` or `SHORT`. | | `status` | Position status (e.g. `OPEN`). | | `entry_price` | Average entry price (USDT). | | `quantity` | Position size (base asset). | | `leverage` | Leverage on the position. | | `liquidation_price` | Estimated liquidation price (USDT). | | `initial_margin` | Initial margin in the position currency. | | `maintenance_margin` | Maintenance margin in the position currency. | | `trade_currency` | `USDT` or `INR`. | | `entry_hedge_rate` | INR/USDT rate at entry (`1` for USDT positions; INR rate for INR). | | `stoploss` / `takeprofit` | Stop-loss and take-profit legs: `price` (USDT trigger price), `order_id` (order UUID), `order_type` (closing side: `SHORT` for a `LONG` position, `LONG` for a `SHORT` position). `price` is `"0"` and the other fields are empty when unset. | | `created_at` / `updated_at` | ISO-8601 timestamps (UTC). | > `initial_margin` and `maintenance_margin` are in the position's currency. `entry_price`, `liquidation_price`, and the `stoploss`/`takeprofit` `price` values remain USDT; `quantity` is the base asset. ### Notes * Omitting `trade_currency` returns USDT positions only, each tagged `trade_currency: "USDT"`. INR positions are returned only with `trade_currency=INR`. * Without `limit`, the response is capped at **20** open positions for that currency. Pass a higher `limit` (for example `50` or `100`) when you may have more than 20 opens on a single page. * **`offset` is a time cursor (epoch ms), not a row/page index.** To page through a larger open book: 1. Call with a chosen `limit` (and `trade_currency`). 2. Take the **oldest** item in the response (the **last** item returned) and read its `created_at`. 3. Convert that `created_at` to epoch milliseconds. 4. Call again with the same `limit` and `offset=`. 5. The next response returns up to `limit` positions **older than** that time. * Passing a meaningless cursor (for example `offset=0`) can return empty / `data: null`. Always derive `offset` from a real `created_at` on the previous page. * No open positions returns `{"success": true, "data": null}`. * Only `OPEN` positions are listed. Placing an order creates its position with status `INITIATED` and returns the `position_id` without waiting for a fill; the position is listed here once it is `OPEN`. * `position_id` does not change on average-in, partial close, or reverse.