Tool Reference

The Decibel MCP server exposes 25 tools. Each tool accepts a JSON input validated with Zod schemas and returns JSON results.

Trading tools

`place_limit_order`

Place a limit order on Decibel DEX. Returns order ID and transaction hash on success.

Parameter	Type	Required	Description
`side`	string	Yes	`buy`, `sell`, `long`, or `short`
`size`	number	Yes	Order size (quantity)
`symbol`	string	Yes	Market symbol (e.g., `BTC/USD`)
`price`	number	Yes	Limit price
`timeInForce`	string	No	`gtc` (default), `post-only`, or `ioc`
`reduceOnly`	boolean	No	Reduce-only order (default: `false`)
`clientOrderId`	string	No	Client order ID for tracking

`place_market_order`

Place a market order. Executes immediately at current price with slippage tolerance.

Parameter	Type	Required	Description
`side`	string	Yes	`buy`, `sell`, `long`, or `short`
`size`	number	Yes	Order size
`symbol`	string	Yes	Market symbol
`slippage`	number	No	Slippage percentage (default: `1`)
`reduceOnly`	boolean	No	Reduce-only order (default: `false`)
`clientOrderId`	string	No	Client order ID for tracking

`place_stop_limit_order`

Place a stop limit order. Triggers when the market reaches the stop price, then posts as a limit order at the specified price.

Parameter	Type	Required	Description
`side`	string	Yes	`buy`, `sell`, `long`, or `short`
`size`	number	Yes	Order size
`symbol`	string	Yes	Market symbol
`price`	number	Yes	Limit price (execution price after trigger)
`stopPrice`	number	Yes	Stop trigger price
`timeInForce`	string	No	`gtc` (default), `post-only`, or `ioc`
`reduceOnly`	boolean	No	Reduce-only order (default: `false`)
`clientOrderId`	string	No	Client order ID for tracking

`place_stop_market_order`

Place a stop market order. Triggers when the market reaches the stop price, then executes immediately with slippage tolerance.

Parameter	Type	Required	Description
`side`	string	Yes	`buy`, `sell`, `long`, or `short`
`size`	number	Yes	Order size
`symbol`	string	Yes	Market symbol
`stopPrice`	number	Yes	Stop trigger price
`slippage`	number	No	Slippage percentage from stop price (default: `1`)
`reduceOnly`	boolean	No	Reduce-only order (default: `false`)
`clientOrderId`	string	No	Client order ID for tracking

`place_twap_order`

Place a TWAP (Time-Weighted Average Price) order. Splits execution across a duration at regular intervals.

Parameter	Type	Required	Description
`side`	string	Yes	`buy`, `sell`, `long`, or `short`
`size`	number	Yes	Total order size
`symbol`	string	Yes	Market symbol
`duration`	number	Yes	Total duration in seconds (min: 120, max: 86400)
`frequency`	number	Yes	Execution frequency in seconds (min: 60)
`reduceOnly`	boolean	No	Reduce-only order (default: `false`)
`clientOrderId`	string	No	Client order ID for tracking

Order management tools

`close_position`

Close an open position. Places a reduce-only market order in the opposite direction. Supports partial closes.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol
`slippage`	number	No	Slippage percentage (default: `1`)
`size`	number	No	Partial close size (omit for full position)

`cancel_order`

Cancel an open order by order ID.

Parameter	Type	Required	Description
`orderId`	string	Yes	Order ID
`symbol`	string	Yes	Market symbol

`cancel_all_orders`

Cancel all open orders. Optionally filter by market.

Parameter	Type	Required	Description
`symbol`	string	No	Market symbol to filter (cancels all if omitted)

`cancel_twap_order`

Cancel an active TWAP order by order ID.

Parameter	Type	Required	Description
`orderId`	string	Yes	TWAP order ID
`symbol`	string	Yes	Market symbol

`place_tp_sl`

Set take-profit and/or stop-loss for an existing position. Omit size fields to apply to the full position.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol
`tpTriggerPrice`	number	No	Take-profit trigger price
`tpLimitPrice`	number	No	Take-profit limit price (execution price)
`tpSize`	number	No	Take-profit size (omit for full position)
`slTriggerPrice`	number	No	Stop-loss trigger price
`slLimitPrice`	number	No	Stop-loss limit price (execution price)
`slSize`	number	No	Stop-loss size (omit for full position)

`cancel_tp_sl`

Cancel a TP/SL order for a position.

Parameter	Type	Required	Description
`orderId`	string	Yes	TP/SL order ID
`symbol`	string	Yes	Market symbol

Account query tools

`get_positions`

Get all open positions for the account. No parameters required.

`get_orders`

Get all open orders for the account. No parameters required.

`get_balances`

Get account balances including wallet USDC, trading account value, and margin info. No parameters required.

`get_active_twaps`

Get all active TWAP orders for the account. No parameters required.

`get_trade_history`

Get recent trade fill history.

Parameter	Type	Required	Description
`limit`	number	No	Number of trades to return (default: 20, max: 100)

`get_order_history`

Get order history for the account (all states including filled, cancelled, etc.).

Parameter	Type	Required	Description
`limit`	number	No	Number of orders to return (default: 20, max: 200)

`get_twap_history`

Get TWAP order history (completed and cancelled TWAPs).

Parameter	Type	Required	Description
`limit`	number	No	Number of TWAP orders to return (default: 20, max: 200)

`get_funding_history`

Get funding rate payment history.

Parameter	Type	Required	Description
`limit`	number	No	Number of records to return (default: 20, max: 200)

`get_tp_sl`

Get all TP/SL orders for a market position, including position-level and fixed-size TP/SL orders.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol

Market data tools

`get_markets`

List all available markets on Decibel DEX with their configurations. No parameters required.

`get_price`

Get current price, funding rate, and open interest for a market.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol

`get_orderbook`

Get the order book (bids and asks) for a market.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol
`depth`	number	No	Number of price levels (default: 10, max: 20)

Configuration tools

`set_leverage`

Set leverage for a market.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol
`leverage`	number	Yes	Leverage value (1-100)
`marginType`	string	No	`cross` (default) or `isolated`

`set_margin_type`

Switch margin type for a market between cross and isolated. Preserves current leverage.

Parameter	Type	Required	Description
`symbol`	string	Yes	Market symbol
`marginType`	string	Yes	`cross` or `isolated`

LLMs.txt

MCP Server

Trading tools

`place_limit_order`

`place_market_order`

`place_stop_limit_order`

`place_stop_market_order`

`place_twap_order`

Order management tools

`close_position`

`cancel_order`

`cancel_all_orders`

`cancel_twap_order`

`place_tp_sl`

`cancel_tp_sl`

Account query tools

`get_positions`

`get_orders`

`get_balances`

`get_active_twaps`

`get_trade_history`

`get_order_history`

`get_twap_history`

`get_funding_history`

`get_tp_sl`

Market data tools

`get_markets`

`get_price`

`get_orderbook`

Configuration tools

`set_leverage`

`set_margin_type`

​Trading tools

​place_limit_order

​place_market_order

​place_stop_limit_order

​place_stop_market_order

​place_twap_order

​Order management tools

​close_position

​cancel_order

​cancel_all_orders

​cancel_twap_order

​place_tp_sl

​cancel_tp_sl

​Account query tools

​get_positions

​get_orders

​get_balances

​get_active_twaps

​get_trade_history

​get_order_history

​get_twap_history

​get_funding_history

​get_tp_sl

​Market data tools

​get_markets

​get_price

​get_orderbook

​Configuration tools

​set_leverage

​set_margin_type

Trading tools

`place_limit_order`

`place_market_order`

`place_stop_limit_order`

`place_stop_market_order`

`place_twap_order`

Order management tools

`close_position`

`cancel_order`

`cancel_all_orders`

`cancel_twap_order`

`place_tp_sl`

`cancel_tp_sl`

Account query tools

`get_positions`

`get_orders`

`get_balances`

`get_active_twaps`

`get_trade_history`

`get_order_history`

`get_twap_history`

`get_funding_history`

`get_tp_sl`

Market data tools

`get_markets`

`get_price`

`get_orderbook`

Configuration tools

`set_leverage`

`set_margin_type`