Arbitrage Executor

The Arbitrage Executor watches the same asset on two markets. When buying on one and selling on the other would be profitable after fees, it sends both orders at once as market orders. One executor makes one arbitrage trade.

Condor can’t create an arbitrage executor. None of its tools creates one, so agents and the Condor chat can’t use it. Create it through the Hummingbot API with POST /executors/, as shown below.

Overview

Property	Value
Markets	Two markets that trade the same base asset
Created with	The Hummingbot API only
Trades	One: a market buy on `buying_market` and a market sell on `selling_market`
`keep_position`	Not a config field. Only a stop parameter.

How it works

On each update, the executor asks both markets what price it would get for order_amount: a buy on buying_market and a sell on selling_market. If the quote assets differ, it converts the sell price with the rate oracle.
It computes the profitability: the gap between the two prices as a fraction of the buy price, minus the estimated fees on both sides as a fraction of order_amount.
When the profitability is above min_profitability, it places a market buy on buying_market and a market sell on selling_market at the same time.
When both orders have filled, it ends with close type COMPLETED.

It keeps waiting until the gap appears or you stop it. A failed order is placed again. After more than 10 failures (the retry limit the Hummingbot API gives every executor) it ends as FAILED.

Configuration

Field	Required	Meaning
`buying_market`	Yes	`{"connector_name": ..., "trading_pair": ...}` for the market to buy on
`selling_market`	Yes	The same for the market to sell on. Must differ from `buying_market`.
`order_amount`	Yes	Amount to buy and sell, in the base asset
`min_profitability`	Yes	Smallest profitability that triggers the trade, as a fraction (`0.004` is 0.4%)
`gas_conversion_price`	For a Gateway AMM market	Used to convert that market’s gas cost into the base asset

The two trading pairs must have the same base asset, or an interchangeable one. The base assets are the only part that is checked. Hummingbot treats these as interchangeable: ETH and WETH, BTC and WBTC, BNB and WBNB, POL and WPOL, AVAX and WAVAX, ONE and WONE, USDC and USDC.E, SOL and USOL, ETH and UETH, BTC and UBTC, and any two tokens whose names both contain USD.

Via the API

Buy 10 SOL on Binance and sell 10 SOL on KuCoin as soon as the gap is worth more than 0.4% after fees:

curl -u YOUR_USERNAME:YOUR_PASSWORD -X POST http://localhost:8000/executors/ \
  -H "Content-Type: application/json" \
  -d '{
    "account_name": "master_account",
    "controller_id": "main",
    "executor_config": {
      "type": "arbitrage_executor",
      "buying_market": {"connector_name": "binance", "trading_pair": "SOL-USDT"},
      "selling_market": {"connector_name": "kucoin", "trading_pair": "SOL-USDT"},
      "order_amount": "10",
      "min_profitability": "0.004"
    }
  }'

When it starts, the executor checks that the account holds at least order_amount of the base asset on the selling market, and enough quote on the buying market to buy order_amount. If not, it ends with INSUFFICIENT_BALANCE.

Close types

Close type	When
`COMPLETED`	Both orders filled
`EARLY_STOP`	You stopped it with `keep_position=false`
`POSITION_HOLD`	You stopped it with `keep_position=true`
`INSUFFICIENT_BALANCE`	A market didn’t hold enough to fund its side
`FAILED`	More than 10 order failures

Stopping early

Stop the executor with POST /executors/{executor_id}/stop. It stops right away. keep_position only changes the close type: nothing is unwound either way, and nothing is added to the Position Hold.

What it reports

The executor’s custom_info includes buy_connector, sell_connector, buy_pair, sell_pair, the last quoted buy_price and sell_price, trade_pnl_pct (the gap), tx_cost_pct, profit_pct (the gap minus costs) and failures. Its net_pnl_quote is the sell proceeds minus the buy cost minus fees, and is reported only once the executor has completed.

Considerations

Factor	Impact
Fees	The fee estimate is part of the profitability check, so a gap smaller than the fees never triggers
Slippage	Prices are quoted for the full `order_amount`, but the market orders can still fill at a worse price
Latency	The two orders are sent together, not atomically. If one fills and the other fails, the failed one is placed again.
Inventory	Each trade moves base from the selling market to the buying market. Rebalancing between venues is up to you.

Learn more

Executors overview: lifecycle, close types and the API
XEMM Executor: earn the spread with a resting limit order instead

Condor

Getting Started

Condor Agents

Running and Building Agents

Workspace Pages

Arbitrage Executor

Overview

How it works

Configuration

Via the API

Close types

Stopping early

What it reports

Considerations

Learn more

​Overview

​How it works

​Configuration

​Via the API

​Close types

​Stopping early

​What it reports

​Considerations

​Learn more

Overview

How it works

Configuration

Via the API

Close types

Stopping early

What it reports

Considerations

Learn more