Futures Wallet

Futures wallet: available margin balance and related wallet reads.

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`