futures.md

Futures Module

The global --json flag is supported on every command and prints the raw API response as indented JSON instead of a table.

Quick Navigation

• Account
  • Show account balances
  • Show account info
  • Show commission rate
  • Query income history
  • Multi-assets mode
• Order
  • Create Order
  • List open orders
  • List orders
  • Get Order
  • Query trades
  • Query force orders
  • Cancel order by ID
  • Cancel all orders by symbol
• Position
  • List positions
  • Show position risk
  • Position mode
  • Set position margin
  • Margin history
  • ADL quantile
• Symbol
  • Set leverage
  • Set margin type
  • Leverage bracket
• Funding
  • Funding info
  • Funding rate history

Account

Account - Show account balances

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#futures-account-balance-v3-user_data

Exec: ./aster-cli futures account balances

┌──────────┬───────────┬──────────────────────┬──────────────┬───────────────────┬─────────────────────┐
│  ASSET   │  BALANCE  │ CROSS WALLET BALANCE │ CROSS UN PNL │ AVAILABLE BALANCE │ MAX WITHDRAW AMOUNT │
├──────────┼───────────┼──────────────────────┼──────────────┼───────────────────┼─────────────────────┤
│ CDL      │ 0         │ 0                    │ 0            │ 96.82822961       │ 0                   │
│ FBTC     │ 0         │ 0                    │ 0            │ 0.00006723        │ 0                   │
│ BONUSUSD │ 0         │ 0                    │ 0            │ 6.68838987        │ 0                   │
│ CAKE     │ 0         │ 0                    │ 0            │ 3.09168527        │ 0                   │
│ WBETH    │ 0         │ 0                    │ 0            │ 0.00197382        │ 0                   │
│ BTC      │ 0         │ 0                    │ 0            │ 0.00007349        │ 0                   │
│ TWT      │ 0         │ 0                    │ 0            │ 3.98481436        │ 0                   │
│ SOLVBTC  │ 0         │ 0                    │ 0            │ 0.00007021        │ 0                   │
│ USDCE    │ 0         │ 0                    │ 0            │ 6.68845694        │ 0                   │
│ FORM     │ 0         │ 0                    │ 0            │ 12.20320237       │ 0                   │
│ LISUSD   │ 0         │ 0                    │ 0            │ 6.09135015        │ 0                   │
│ USDBC    │ 0         │ 0                    │ 0            │ 6.68845694        │ 0                   │
│ STONE    │ 0         │ 0                    │ 0            │ 0.00204958        │ 0                   │
│ LISTA    │ 0         │ 0                    │ 0            │ 24.76868462       │ 0                   │
│ RSETH    │ 0         │ 0                    │ 0            │ 0.00202942        │ 0                   │
│ ASTER    │ 0         │ 0                    │ 0            │ 8.19088379        │ 0                   │
│ JLP      │ 0         │ 0                    │ 0            │ 1.3643923         │ 0                   │
│ SOL      │ 0         │ 0                    │ 0            │ 0.0494919         │ 0                   │
│ BNB      │ 0         │ 0                    │ 0            │ 0.00765242        │ 0                   │
│ ETH      │ 0         │ 0                    │ 0            │ 0.00225104        │ 0                   │
│ USDF     │ 0         │ 0                    │ 0            │ 6.6904639         │ 0                   │
│ USDT     │ 8.6922585 │ 8.6922585            │ -0.30366475  │ 6.6904639         │ 6.6904639           │
│ AFEE     │ 0         │ 0                    │ 0            │ 3.34469658        │ 0                   │
│ CUSDT    │ 0         │ 0                    │ 0            │ 284.83739457      │ 0                   │
│ PUMPBTC  │ 0         │ 0                    │ 0            │ 0.00003864        │ 0                   │
│ USD1     │ 0         │ 0                    │ 0            │ 6.5526223         │ 0                   │
│ USDC     │ 0         │ 0                    │ 0            │ 6.68845694        │ 0                   │
│ ASBNB    │ 0         │ 0                    │ 0            │ 0.00720871        │ 0                   │
│ SLISBNB  │ 0         │ 0                    │ 0            │ 0.00706604        │ 0                   │
│ VUSDT    │ 0         │ 0                    │ 0            │ 284.10015961      │ 0                   │
│ BUSD     │ 0         │ 0                    │ 0            │ 6.68905871        │ 0                   │
└──────────┴───────────┴──────────────────────┴──────────────┴───────────────────┴─────────────────────┘

Account - Show account info

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#account-information-v3-user_data

Exec: ./aster-cli futures account info

┌──────────┬───────────┬─────────────┬──────────────┬──────────────────────┬───────────────────┐
│ FEE TIER │ CAN TRADE │ CAN DEPOSIT │ CAN WITHDRAW │ TOTAL WALLET BALANCE │ AVAILABLE BALANCE │
├──────────┼───────────┼─────────────┼──────────────┼──────────────────────┼───────────────────┤
│ 0        │ true      │ true        │ true         │ 8.688694934782754    │ 6.68772242        │
└──────────┴───────────┴─────────────┴──────────────┴──────────────────────┴───────────────────┘

Account - Show commission rate

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#user-commission-rate-user_data

Exec: ./aster-cli futures account commission-rate --symbol=BTCUSDT

┌─────────┬───────────────────────┬───────────────────────┐
│ SYMBOL  │ MAKER COMMISSION RATE │ TAKER COMMISSION RATE │
├─────────┼───────────────────────┼───────────────────────┤
│ BTCUSDT │ 0.00005               │ 0.0004                │
└─────────┴───────────────────────┴───────────────────────┘

Account - Query income history

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#get-income-historyuser_data

Exec: ./aster-cli futures account income

Supported parameters:

• --symbol, -s: Trading pair symbol
• --incomeType, -t: Income type (e.g., REALIZED_PNL, COMMISSION, FUNDING_FEE)
• --startTime, -a: Start time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --endTime, -e: End time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --limit, -l: Number of results (default 100, max 1000)

If the value contains spaces, wrap it in quotes, e.g. --startTime "2025-12-18 04:16:21". Date time strings are parsed in local timezone.

┌───────┬─────────────┬─────────────────────────┬─────────────────────────┬─────────┬─────────────────────┬────────────────────┬──────────┐
│ ASSET │   INCOME    │       INCOME TYPE       │          INFO           │ SYMBOL  │        TIME         │      TRAN ID       │ TRADE ID │
├───────┼─────────────┼─────────────────────────┼─────────────────────────┼─────────┼─────────────────────┼────────────────────┼──────────┤
│ USDT  │ -0.00012014 │ FUNDING_FEE             │ FUNDING_FEE             │ ETHUSDT │ 2025-12-18 00:00:01 │ 538239185439545510 │          │
│ USDT  │ -1          │ TRANSFER_FUTURE_TO_SPOT │ TRANSFER_FUTURE_TO_SPOT │         │ 2025-12-18 02:20:34 │ 50548639           │          │
│ USDT  │ -1          │ TRANSFER_FUTURE_TO_SPOT │ TRANSFER_FUTURE_TO_SPOT │         │ 2025-12-18 02:21:23 │ 50548682           │          │
│ USDT  │ -1          │ TRANSFER_FUTURE_TO_SPOT │ TRANSFER_FUTURE_TO_SPOT │         │ 2025-12-18 03:08:26 │ 50552972           │          │
│ USDT  │ 1           │ TRANSFER_SPOT_TO_FUTURE │ TRANSFER_SPOT_TO_FUTURE │         │ 2025-12-18 03:08:26 │ 50552973           │          │
└───────┴─────────────┴─────────────────────────┴─────────────────────────┴─────────┴─────────────────────┴────────────────────┴──────────┘

Account - Multi-assets mode

Show docs: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#get-current-multi-assets-mode-user_data Set docs: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#change-multi-assets-mode-trade

Show current mode:

./aster-cli futures account multi-assets-mode show

Enable/Disable multi-assets mode:

./aster-cli futures account multi-assets-mode set --multiAssetsMargin=true
./aster-cli futures account multi-assets-mode set --multiAssetsMargin=false

Order

Order - Create Order

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#new-order-trade

Create a new futures order. Supports various order types. The created order is printed back as a single-row table (or JSON with --json).

Market Order (Open Short):

./aster-cli futures order create --symbol=ETHUSDT --side=SELL --positionSide=SHORT --type=MARKET --quantity=0.1

Limit Order (Open Long):

./aster-cli futures order create --symbol=ETHUSDT --side=BUY --positionSide=LONG --type=LIMIT --timeInForce=GTC --quantity=0.01 --price=4000

Reduce Short Position (Market):

./aster-cli futures order create --symbol=ETHUSDT --side=BUY --positionSide=SHORT --type=MARKET --quantity=1.0

Reduce Long Position (Limit):

./aster-cli futures order create --symbol=ETHUSDT --side=SELL --positionSide=LONG --type=LIMIT --timeInForce=GTC --price=4000.0 --quantity=0.01

Supported parameters:

• --symbol, -s: Trading pair symbol (required)
• --side, -S: BUY or SELL
• --type, -t: LIMIT, MARKET, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET
• --positionSide, -P: LONG or SHORT (default BOTH for One-way Mode)
• --quantity, -q: Order quantity (decimal string)
• --price, -p: Order price (decimal string, required for LIMIT orders)
• --timeInForce, -T: GTC, IOC, FOK, GTX
• --reduceOnly: Reduce only order
• --stopPrice: Stop price (decimal string) for STOP/TAKE_PROFIT orders
• --closePosition: Close all position
• --activationPrice: Activation price (decimal string) for TRAILING_STOP_MARKET
• --callbackRate: Callback rate (decimal string) for TRAILING_STOP_MARKET (min 0.1, max 5)
• --workingType: MARK_PRICE or CONTRACT_PRICE
• --priceProtect: Price protection
• --newClientOrderId: Custom order ID

Order - List open orders

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#current-all-open-orders-user_data

Exec: ./aster-cli futures order open

Or for a specific symbol:

./aster-cli futures order open --symbol=ETHUSDT

┌─────────────┬─────────┬──────┬───────┬───────────────┬────────┬───────┬───────────┬──────────┬──────────────┬───────────┬─────┬─────────────────────┬─────────────────────┐
│  ORDER ID   │ SYMBOL  │ SIDE │ TYPE  │ POSITION SIDE │ STATUS │ PRICE │ AVG PRICE │ QUANTITY │ EXECUTED QTY │ CUM QUOTE │ TIF │        TIME         │     UPDATE TIME     │
├─────────────┼─────────┼──────┼───────┼───────────────┼────────┼───────┼───────────┼──────────┼──────────────┼───────────┼─────┼─────────────────────┼─────────────────────┤
│ 12929613862 │ ETHUSDT │ SELL │ LIMIT │ BOTH          │ NEW    │ 4000  │ 0         │ 0.003    │ 0            │ 0         │ GTC │ 2025-12-18 05:26:45 │ 2025-12-18 05:26:45 │
└─────────────┴─────────┴──────┴───────┴───────────────┴────────┴───────┴───────────┴──────────┴──────────────┴───────────┴─────┴─────────────────────┴─────────────────────┘

Order - List orders

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#all-orders-user_data

Exec: ./aster-cli futures order list --symbol=ETHUSDT

Supported parameters:

• --symbol, -s: Trading pair symbol (required)
• --orderId, -i: Start from this Order ID (returns orders >= orderId)
• --limit, -l: Number of results (default 500, max 1000)
• --startTime, -a: Start time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --endTime, -e: End time (unix ms or "YYYY-MM-DD HH:MM:SS")

┌─────────────┬─────────┬──────┬────────┬───────────────┬────────┬───────┬───────────┬──────────┬──────────────┬───────────┬─────┬─────────────────────┬─────────────────────┐
│  ORDER ID   │ SYMBOL  │ SIDE │  TYPE  │ POSITION SIDE │ STATUS │ PRICE │ AVG PRICE │ QUANTITY │ EXECUTED QTY │ CUM QUOTE │ TIF │        TIME         │     UPDATE TIME     │
├─────────────┼─────────┼──────┼────────┼───────────────┼────────┼───────┼───────────┼──────────┼──────────────┼───────────┼─────┼─────────────────────┼─────────────────────┤
│ 12803994759 │ ETHUSDT │ BUY  │ MARKET │ BOTH          │ FILLED │ 0     │ 2928.5    │ 0.003    │ 0.003        │ 8.7855    │ GTC │ 2025-12-16 09:37:12 │ 2025-12-16 09:37:12 │
│ 12929613862 │ ETHUSDT │ SELL │ LIMIT  │ BOTH          │ NEW    │ 4000  │ 0         │ 0.003    │ 0            │ 0         │ GTC │ 2025-12-18 05:26:45 │ 2025-12-18 05:26:45 │
└─────────────┴─────────┴──────┴────────┴───────────────┴────────┴───────┴───────────┴──────────┴──────────────┴───────────┴─────┴─────────────────────┴─────────────────────┘

Order - Get Order

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#query-order-user_data

Query a single order by orderId or origClientOrderId.

./aster-cli futures order get --symbol=ETHUSDT --orderId=xxx

Or:

./aster-cli futures order get --symbol=ETHUSDT --origClientOrderId=xxx

Order - Query trades

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#account-trade-list-user_data

Exec: ./aster-cli futures order trade --symbol=BTCUSDT

Supported parameters:

• --symbol, -s: Trading pair symbol (required)
• --startTime, -a: Start time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --endTime, -e: End time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --fromId, -f: Trade ID to fetch from
• --limit, -l: Number of results (default 500, max 1000)

┌─────────────┬─────────┬──────┬────────┬───────────────┬────────┬───────┬───────────┬──────────┬──────────────┬───────────┬─────┬─────────────────────┬─────────────────────┐
│  ORDER ID   │ SYMBOL  │ SIDE │  TYPE  │ POSITION SIDE │ STATUS │ PRICE │ AVG PRICE │ QUANTITY │ EXECUTED QTY │ CUM QUOTE │ TIF │        TIME         │     UPDATE TIME     │
├─────────────┼─────────┼──────┼────────┼───────────────┼────────┼───────┼───────────┼──────────┼──────────────┼───────────┼─────┼─────────────────────┼─────────────────────┤
│ 12803994759 │ ETHUSDT │ BUY  │ MARKET │ BOTH          │ FILLED │ 0     │ 2928.5    │ 0.003    │ 0.003        │ 8.7855    │ GTC │ 2025-12-16 09:37:12 │ 2025-12-16 09:37:12 │
└─────────────┴─────────┴──────┴────────┴───────────────┴────────┴───────┴───────────┴──────────┴──────────────┴───────────┴─────┴─────────────────────┴─────────────────────┘

Order - Query force orders

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#users-force-orders-user_data

Query user's force orders (liquidation orders).

./aster-cli futures order force

Supported parameters:

• --symbol, -s: Trading pair symbol
• --autoCloseType, -t: Auto close type: LIQUIDATION or ADL
• --startTime, -a: Start time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --endTime, -e: End time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --limit, -l: Number of results (default 50, max 100)

Order - Cancel order by ID

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#cancel-order-trade

Exec: ./aster-cli futures order cancel --symbol=ETHUSDT --orderId=xxx

Or by client order ID:

./aster-cli futures order cancel --symbol=ETHUSDT --origClientOrderId=xxx

The canceled order is printed back as a single-row table (or JSON with --json).

Order - Cancel all orders by symbol

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#cancel-all-open-orders-trade

Exec: ./aster-cli futures order cancel --symbol=ETHUSDT

If neither --orderId nor --origClientOrderId is provided, all open orders for the symbol will be canceled. The response is the API's {code, msg} envelope.

Position

Position - List positions

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#account-information-v3-user_data

Exec: ./aster-cli futures position list

┌─────────┬───────────────┬─────────────────┬─────────────┬───────────────────┬──────────┬─────────────────────┐
│ SYMBOL  │ POSITION SIDE │ POSITION AMOUNT │ ENTRY PRICE │ UNREALIZED PROFIT │ LEVERAGE │     UPDATE TIME     │
├─────────┼───────────────┼─────────────────┼─────────────┼───────────────────┼──────────┼─────────────────────┤
│ ETHUSDT │ BOTH          │ 0.003           │ 2928.5      │ -0.30615          │ 5        │ 2025-12-16 09:37:12 │
└─────────┴───────────────┴─────────────────┴─────────────┴───────────────────┴──────────┴─────────────────────┘

Position - Show position risk

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#position-information-v3-user_data

Exec: ./aster-cli futures position risk

Or for a specific symbol:

./aster-cli futures position risk --symbol=BTCUSDT

┌─────────┬───────────────┬─────────────────┬─────────────┬────────────┬───────────────────┬───────────────────┬──────────┬─────────────────────┐
│ SYMBOL  │ POSITION SIDE │ POSITION AMOUNT │ ENTRY PRICE │ MARK PRICE │ UNREALIZED PROFIT │ LIQUIDATION PRICE │ LEVERAGE │     UPDATE TIME     │
├─────────┼───────────────┼─────────────────┼─────────────┼────────────┼───────────────────┼───────────────────┼──────────┼─────────────────────┤
│ ETHUSDT │ BOTH          │ 0.003           │ 2928.5      │ 2823.95    │ -0.31365          │ 31.15841161       │ 5        │ 2026-04-29 09:37:12 │
└─────────┴───────────────┴─────────────────┴─────────────┴────────────┴───────────────────┴───────────────────┴──────────┴─────────────────────┘

Position - Position mode

Get docs: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#get-current-position-modeuser_data Set docs: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#change-position-modetrade

Get current position mode:

./aster-cli futures position mode get

Set position mode (Hedge/One-way):

./aster-cli futures position mode set --dualSidePosition=true   # Hedge mode (dual side position)
./aster-cli futures position mode set --dualSidePosition=false  # One-way mode (single side position)

Position - Set position margin

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#modify-isolated-position-margin-trade

Modify isolated position margin.

./aster-cli futures position set-margin --symbol=BTCUSDT --amount=1.0 --positionSide=SHORT --type=ADD

Supported parameters:

• --symbol, -s: Trading pair symbol (required)
• --positionSide, -p: Position side: BOTH, LONG, or SHORT (default BOTH)
• --amount, -a: Margin amount (decimal string, required)
• --type, -t: Margin type: ADD or REDUCE (default ADD)

Position - Margin history

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#get-position-margin-change-history-trade

Query position margin change history.

./aster-cli futures position margin-history --symbol=BTCUSDT

Supported parameters:

• --symbol, -s: Trading pair symbol (required)
• --type, -t: Margin type: 1 for Add, 2 for Reduce
• --startTime, -a: Start time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --endTime, -e: End time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --limit, -l: Number of results (default 500)

Position - ADL quantile

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#position-adl-quantile-estimation-user_data

Query ADL (Auto-Deleveraging) quantile estimation for positions.

./aster-cli futures position adl-quantile

Or for a specific symbol:

./aster-cli futures position adl-quantile --symbol=BTCUSDT

Symbol

Symbol - Set leverage

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#change-initial-leverage-trade

Change initial leverage for a symbol.

./aster-cli futures symbol set-leverage --symbol=BTCUSDT --leverage=10

Symbol - Set margin type

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#change-margin-type-trade

Change symbol level margin type.

./aster-cli futures symbol set-margin-type --symbol=BTCUSDT --marginType=CROSSED

Supported types: ISOLATED, CROSSED

Symbol - Leverage bracket

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/account%26trades/#notional-and-leverage-brackets-user_data

Query notional and leverage bracket information.

./aster-cli futures symbol leverage-bracket

Or for a specific symbol:

./aster-cli futures symbol leverage-bracket --symbol=BTCUSDT

Funding

Funding - Funding info

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/market-data/#get-funding-rate-config

Query funding info including funding interval and fee cap/floor.

./aster-cli futures funding info

Or for a specific symbol:

./aster-cli futures funding info --symbol=BTCUSDT

Funding - Funding rate history

Docs Link: https://asterdex.github.io/aster-api-website/futures-v3/market-data/#get-funding-rate-history

Query funding rate history.

./aster-cli futures funding rate --symbol=BTCUSDT

Supported parameters:

• --symbol, -s: Trading pair symbol
• --startTime, -a: Start time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --endTime, -e: End time (unix ms or "YYYY-MM-DD HH:MM:SS")
• --limit, -l: Number of results (default 100, max 1000)