Delta Exchange MCPAccount
Account tools for positions, balances, fills, orders, exports, and profile. A Read Data API key is required.
All tools on this page need a Read Data API key (see
Authentication). They are read-only; none can place,
modify, or cancel orders or move funds. Fills/orders/wallet timestamps are
microseconds (*_us); paginated tools return a meta.after cursor.
get_positions
Open position(s), lightweight. Returns entry_price and size only.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
product_id | int | no | single product id |
underlying_asset_symbol | string | no | e.g. BTC; returns all positions under it |
Pass exactly one of the two. For unrealized_pnl, margin, mark_price,
liquidation_price and other analytics, use get_margined_positions.
Do I have an open BTC position? Show entry price and size.get_margined_positions
All open margined positions with analytics. The tool to use for risk and P&L.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
contract_types | string[] | no | subset of perpetual_futures, call_options, put_options |
product_ids | int[] | no | max 10 product ids |
size is signed (positive = long, negative = short). For notional exposure use
abs(size) * contract_value * index_price. Use index_price, not
mark_price (an option's mark is its premium). The tool also patches
unrealized_pnl for short options client-side, since the upstream API returns
the unsigned premium value.
Across all my open positions, show unrealised PnL, margin used, and approximate
distance to liquidation. Rank by risk.get_product_leverage
The order leverage configured for a product on your account.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
product_id | int | yes | product id to fetch leverage for |
What leverage am I set to on BTCUSD?get_wallet_balances
Balances across all assets.
Auth: Read Data key
No parameters.
Fields: asset_symbol, balance, available_balance, position_margin,
strategy_blocked_amount. strategy_blocked_amount is collateral reserved by an
active Algo Marketplace strategy; normal, not an anomaly.
Show my wallet balances and how much is available vs locked in margin.get_wallet_transactions
Wallet transaction history. Paginated. Timestamps are microseconds. Without
start_time_us, only the last ~90 days are returned (the response carries a
notice field); pass it to reach older history.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
transaction_types | string[] | no | e.g. deposit, withdrawal, funding, settlement, commission |
asset_ids | int[] | no | filter by asset |
start_time_us | int | no | microseconds epoch |
end_time_us | int | no | microseconds epoch |
page_size | int | no | default 50, max 200 |
after / before | string | no | pagination cursors |
Group my wallet transactions for the last 30 days by type and show net change
per asset.get_fills
Your executed trades (fills). Paginated. Timestamps are microseconds. Without
start_time_us, only the last ~90 days are returned; pass it to reach older
fills.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
product_ids | int[] | no | filter by product |
contract_types | string[] | no | filter by contract type |
start_time_us | int | no | microseconds epoch |
end_time_us | int | no | microseconds epoch |
page_size | int | no | default 50, max 200 |
after | string | no | pagination cursor |
List my fills for the last 7 days grouped by symbol with realised PnL.bulk_fills_export
Bulk-export your full fills history to a CSV file on disk: for tax, accounting, or backtesting without dozens of paginated calls.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
output_path | string | yes | must be inside the current working directory or your home directory; ~ expands |
product_ids | int[] | no | filter by product |
contract_types | string[] | no | filter by contract type |
start_time_us | int | no | microseconds epoch |
end_time_us | int | no | microseconds epoch |
Returns {path, row_count, size_bytes}. Without start_time_us, the export
covers only the last ~90 days; for a full tax-year export, pass an explicit start
(and usually end) time.
Export all my fills from 1 Jan 2026 to today to ~/delta-fills-2026.csv.get_order_history
Closed / cancelled orders, filterable and paginated. Timestamps are microseconds.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
product_ids | int[] | no | filter by product |
contract_types | string[] | no | filter by contract type |
order_types | string[] | no | market, limit, stop_market, stop_limit, all_stop |
start_time_us | int | no | microseconds epoch |
end_time_us | int | no | microseconds epoch |
page_size | int | no | default 50, max 200 |
after | string | no | pagination cursor |
Show my cancelled and filled orders on ETHUSD over the last week.get_open_orders
Current open / pending orders. Paginated.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
states | string[] | no | subset of open, pending |
product_ids | int[] | no | max 10 product ids |
contract_types | string[] | no | filter by contract type |
page_size | int | no | default 50, max 200 |
after | string | no | pagination cursor |
What open orders do I have right now, and at what prices?get_order_by_id
Fetch a single order by id or client order id.
Auth: Read Data key
| Param | Type | Required | Notes |
|---|---|---|---|
order_id | int | no | Delta-assigned order id |
client_order_id | string | no | your client order id, if set |
Provide exactly one.
Look up order 123456789 and show its status and fills.get_profile
Your account profile.
Auth: Read Data key
No parameters.
Show my Delta account profile.get_trading_preferences
Your trading preferences: margin mode, notifications, and similar settings.
Auth: Read Data key
No parameters.
What's my current margin mode and trading preferences?get_trading_stats
Account-level trading volume and statistics.
Auth: Read Data key
No parameters.
Show my trading volume and stats for this account.Market Data
Public market-data tools for tickers, order book, candles, open interest, funding, options chain, and indices. No API key required.
Trading
Trading tools to place, edit, and cancel orders, manage brackets, leverage, margin, and positions. Off by default; requires a Trading key and DELTA_MCP_MODE=trade.