Futures Wallet

The Futures Wallet section lets you see how much margin you have available for futures trading. It exposes endpoints to fetch your current futures wallet balance, the amount locked in open positions or orders, a flag indicating whether you are a first‑time futures user, and your futures transaction history. To move money into or out of your futures wallet, use the transfer endpoints under the Wallet section.

Currency. Pass trade_currency (USDT or INR) on these GET endpoints; omitted defaults to USDT.

Transactions — `GET /futures/transactions`

List futures wallet transactions (transfers in/out) for one currency, with filtering and pagination. Use this to confirm the status of a transfer — for example, an INR transfer created via POST /futures/transfers/inr. DEPOSIT = spot → futures; WITHDRAW = futures → spot.

Request

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/transactions?limit=20&status=completed&sort_order=desc&sort_by=updated_at&trade_currency=INR" \
  -H "X-Authentication: your-secret-key"

Parameters

Parameter	Type	Required	Description
`trade_currency`	string	No	`USDT` or `INR`. Defaults to `USDT` when omitted.
`type`	string	No	Filter by transaction type: `DEPOSIT` (spot → futures) or `WITHDRAW` (futures → spot).
`status`	string	No	Filter by status, lowercase (e.g. `completed`). The response value is capitalized (e.g. `Completed`).
`sort_by`	string	No	Field to sort by (e.g. `updated_at`).
`sort_order`	string	No	`asc` (oldest first) or `desc` (newest first).
`limit`	number	No	Maximum number of records to return.

Response

Status: 200 OK

Sorted by updated_at descending (newest first). Both completed transfers are returned because no type filter was applied.

{
    "success": true,
    "data": [
        {
            "id": "019ecc71-2314-780d-9e65-21343eaa99c6",
            "wallet_transaction_id": "",
            "transaction_type": "WITHDRAW",
            "amount": "14.6719",
            "status": "Completed",
            "created_at": "2026-06-15T18:00:27Z",
            "updated_at": "2026-06-15T18:00:29Z"
        },
        {
            "id": "019ecc51-9004-7dd1-8654-64420289af4e",
            "wallet_transaction_id": "",
            "transaction_type": "DEPOSIT",
            "amount": "89.12",
            "status": "Completed",
            "created_at": "2026-06-15T17:25:58Z",
            "updated_at": "2026-06-15T17:25:59Z"
        }
    ]
}

Response fields

Field	Description
`id`	Transaction ID (matches the `id` returned by the transfer call).
`transaction_type`	`DEPOSIT` (spot → futures) or `WITHDRAW` (futures → spot).
`amount`	Amount transferred, in `trade_currency`.
`status`	Transaction status, capitalized (e.g. `Completed`).
`created_at`	Timestamp when the transaction was created.
`updated_at`	Timestamp when the transaction was last updated.
`wallet_transaction_id`	Linked wallet transaction reference (may be empty).

Notes

To return only one direction, pass type=DEPOSIT or type=WITHDRAW; the response then contains only matching rows.
The status filter is lowercase (completed) while the response status value is capitalized (Completed).
Related: Transfer funds — USDT (/wallet/futures/transfer) and INR (/futures/transfers/inr).

Transactions — GET /futures/transactions

Request

Response

Notes

Transactions — `GET /futures/transactions`