Open Positions

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

# USDT (default; up to 20 positions)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions" \
  -H "X-Authentication: your-secret-key"

# 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"

# 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"

# 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):

{
    "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):

{
    "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.
`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=<that epoch ms>.
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.