Skip to main content
The /trade command provides direct trading on centralized exchanges without creating executors.

​
Supported Exchanges

ExchangeSpotPerpetual
BinanceYesYes
BybitYesYes
OKXYesYes
KucoinYesYes
KrakenYesNo
CoinbaseYesNo
HyperliquidNoYes

​
Via Telegram

​
Place Order

/trade → Select exchange → Select market → Buy/Sell → Enter amount

​
Order Types

TypeDescription
MarketExecute immediately at best price
LimitExecute at specified price or better

​
Position Management (Perpetual)

For perpetual markets:
  • Set leverage before opening position
  • View entry price and unrealized P&L
  • Close position partially or fully
/trade → Positions → Select position → Close

​
Via API

​
Get Markets

curl -u admin:admin http://localhost:8000/connectors/binance/trading-pairs

​
Place Market Order

curl -u admin:admin -X POST http://localhost:8000/trading/place-order \
  -H "Content-Type: application/json" \
  -d '{
    "connector_name": "binance",
    "trading_pair": "BTC-USDT",
    "side": "BUY",
    "amount": 0.001,
    "order_type": "MARKET"
  }'

​
Place Limit Order

curl -u admin:admin -X POST http://localhost:8000/trading/place-order \
  -H "Content-Type: application/json" \
  -d '{
    "connector_name": "binance",
    "trading_pair": "BTC-USDT",
    "side": "BUY",
    "amount": 0.001,
    "order_type": "LIMIT",
    "price": 60000.0
  }'

​
Cancel Order

curl -u admin:admin -X POST http://localhost:8000/trading/cancel-order \
  -H "Content-Type: application/json" \
  -d '{
    "connector_name": "binance",
    "trading_pair": "BTC-USDT",
    "order_id": "12345"
  }'

​
Set Leverage (Perpetual)

curl -u admin:admin -X POST http://localhost:8000/trading/set-leverage \
  -H "Content-Type: application/json" \
  -d '{
    "connector_name": "binance_perpetual",
    "trading_pair": "BTC-USDT",
    "leverage": 5
  }'

​
Trade vs Executors

Aspect/tradeExecutors
Use CaseQuick manual tradesAgent-controlled operations
P&L TrackingExchange-levelPer-agent via controller_id
Exit ConditionsManualAutomatic (TP/SL/time)
AttributionNoneTagged to agent
For agent-controlled trading with P&L attribution, use Executors instead.