Trade

The Trade page is a chart-first trading terminal for venues with an order book, such as Binance, Hyperliquid or XRPL. Everything you create here is an executor: a single operation the Hummingbot API runs and reports on. DEX pools traded through Gateway have their own page. See DEX.

The Trade page on XRPL XRP-RLUSD: market chip with star, interval and range buttons, chart, the Order builder in the Execute panel, and the executors pane below

Choosing a market

The chip at the top left shows the venue and pair, for example Xrpl XRP-RLUSD. Click it, or press / anywhere on the page, to open the market browser.

The left rail lists venues in two groups:
- Your accounts: venues you have API keys for.
- View only: venues whose market data is public, so you can chart them without keys.
The table lists the venue’s pairs with price, 24h volume and price change. You can sort by any column, search, filter by quote asset, or show Starred markets only.
Press Esc to close it.

Click the star next to the chip to save the market. Starred markets appear in the favorites strip under the top bar for one-click switching. Favorites are saved per server, in your browser. The venue list comes from the server: any connector you have keys for, plus any connector with public candle data. To add one to Your accounts, add its keys under Settings → Keys and Wallets.

The chart

Interval: 1m, 5m, 15m, 1h, 4h, 1d.
Range: 1h, 6h, 1d, 3d, 7d, 14d, 30d.
Shift+click to start measuring. Then move the mouse to see the % change from that point.
Prices you set in a builder, such as grid bounds or a limit price, are drawn as lines. Drag a line to change the price.
Executors on the pair are drawn on the chart too.

The Execute panel

The right panel has two tabs: Execute and Data. Execute holds one builder per executor type. Each builder ends with a Create … Executor button.

Builder	What it creates
Order	A single order. Set direction, amount (with 10/25/50/100% of balance shortcuts), execution strategy (Market, Limit, Limit Maker or Limit Chaser), leverage and position action (Open or Close).
Position	A position with stop-loss, take-profit, time limit and trailing stop. See Position Executor.
Grid	A ladder of orders between a lower and upper price, with a stop-loss limit, total amount, minimum order amount, spread and take-profit. Auto-fill proposes bounds around the current price. See Grid Executor.
DCA	Laddered entries with take-profit, stop-loss, time limit and trailing stop. See DCA Executor.
LP	A concentrated-liquidity position. See LP Executor.

Which builders you see depends on the venue:

A venue with an order book gets Order, Position, Grid and DCA.
LP appears only on a venue that can hold a CLMM position. In practice those are Gateway networks, which you trade from the DEX page.
A venue without Hummingbot market data gets Order only, with Market as its only strategy. That is what you see on a DEX pool.

On a View only venue, the builder is blurred and shows View only — no API keys for … with an Add API keys button. The chart, the market browser and the Data tab still work.

The Grid builder with direction, lower and upper prices, the stop-loss limit and grid structure fields

The Data tab

Data replaces the builder with the live order book and recent trades for the pair.

The bottom pane

Below the chart, a pane scoped to the current pair shows standalone executors, the ones on controller main, which is where this page creates them. Executors that bots run don’t appear here. The pane shows:

A summary line: the executor count, total PnL and volume, and your balances for the pair.
Executors: active executors first, with type, side, status, entry, price, PnL, volume and age. Click one to highlight it on the chart.
Positions: open positions on the pair.

Click the summary line to collapse the pane, or drag its top edge to resize it.

Using Telegram

/trade opens one trading menu for both CEX and DEX venues. /swap is an alias for it. Pick the venue and pair, set the side, amount and order type with buttons, then tap 📊 Quote and ✅ Execute. Type an amount like $100 to size it in USD. The same menu has 📋 Orders (view and cancel) and 📊 Positions (view and close). Perpetual venues also get leverage and position-mode buttons. Telegram places orders directly. To create grid or position executors from Telegram, use /executors.

Using Hummingbot API

The builders create executors. The API can also place orders directly, with no executor, no exit conditions and no attribution to an agent:

# Market order
curl -u YOUR_USERNAME:YOUR_PASSWORD -X POST http://localhost:8000/trading/orders \
  -H "Content-Type: application/json" \
  -d '{
    "account_name": "master_account",
    "connector_name": "binance",
    "trading_pair": "BTC-USDT",
    "trade_type": "BUY",
    "amount": 0.001,
    "order_type": "MARKET"
  }'

# Cancel: account, connector and client order id go in the path
curl -u YOUR_USERNAME:YOUR_PASSWORD -X POST \
  http://localhost:8000/trading/master_account/binance/orders/{client_order_id}/cancel

# Leverage (perpetual)
curl -u YOUR_USERNAME:YOUR_PASSWORD -X POST \
  http://localhost:8000/trading/master_account/binance_perpetual/leverage \
  -H "Content-Type: application/json" \
  -d '{"trading_pair": "BTC-USDT", "leverage": 5}'

Use direct orders for quick manual trades. Use executors when you want automatic exits (take-profit, stop-loss, time limit) and PnL tagged to whoever created them.

Learn more

Executors: every executor type in depth
DEX: pools traded through Gateway

Condor

Getting Started

Condor Agents

Running and Building Agents

Workspace Pages

Choosing a market

The chart

The Execute panel

The Data tab

The bottom pane

Using Telegram

Using Hummingbot API

Learn more

​Choosing a market

​The chart

​The Execute panel

​The Data tab

​The bottom pane

​Using Telegram

​Using Hummingbot API

​Learn more

Choosing a market

The chart

The Execute panel

The Data tab

The bottom pane

Using Telegram

Using Hummingbot API

Learn more