BacktestRoutingModel#
tradeexecutor.backtest.backtest_routing.BacktestRoutingModel class.
- class BacktestRoutingModel[source]#
Bases:
RoutingModel
A simple router that does not optimise the trade execution cost.
Able to trade on multiple exchanges
Able to three-way trades through predefined intermediary hops, either on the exchange itself or some outside exchange
- __init__(factory_router_map, allowed_intermediary_pairs, reserve_token_address)[source]#
- Parameters
factory_router_map (Dict[str, Tuple[str, Optional[str]]]) – Defines router smart contracts to be used with each DEX. Each Uniswap v2 is uniquely identified by its factory contract. Addresses always lowercase.
allowed_intermediary_pairs (Dict[str, str]) –
Quote token address -> pair smart contract address mapping.
Because we hold our reserves only in one currecy e.g. BUSD and we want to trade e.g. Cake/BNB pairs, we need to whitelist BNB as an allowed intermediary token. This makes it possible to do BUSD -> BNB -> Cake trade. This set is the list of pair smart contract addresses that are allowed to be used as a hop.
reserve_token_address (str) – Token address of our reserve currency. Relevent for buy/sell routing. Lowercase.
Methods
__init__
(factory_router_map, ...)- param factory_router_map
create_routing_state
(universe, execution_details)Create a new routing state for this cycle.
get_reserve_asset
(pair_universe)Translate our reserve token address tok an asset description.
route_pair
(pair_universe, trading_pair)Return Uniswap routing information (path components) for a trading pair.
setup_internal
(routing_state, trade)Simulate trade braodcast and mark it as success.
setup_trades
(routing_state, trades[, ...])Strategy and live execution connection.
trade
(routing_state, target_pair, ...[, ...])- param routing_state
- __init__(factory_router_map, allowed_intermediary_pairs, reserve_token_address)[source]#
- Parameters
factory_router_map (Dict[str, Tuple[str, Optional[str]]]) – Defines router smart contracts to be used with each DEX. Each Uniswap v2 is uniquely identified by its factory contract. Addresses always lowercase.
allowed_intermediary_pairs (Dict[str, str]) –
Quote token address -> pair smart contract address mapping.
Because we hold our reserves only in one currecy e.g. BUSD and we want to trade e.g. Cake/BNB pairs, we need to whitelist BNB as an allowed intermediary token. This makes it possible to do BUSD -> BNB -> Cake trade. This set is the list of pair smart contract addresses that are allowed to be used as a hop.
reserve_token_address (str) – Token address of our reserve currency. Relevent for buy/sell routing. Lowercase.
- get_reserve_asset(pair_universe)[source]#
Translate our reserve token address tok an asset description.
- Parameters
pair_universe (PandasPairUniverse) –
- Return type
- trade(routing_state, target_pair, reserve_asset, reserve_asset_amount, max_slippage=0.01, check_balances=False, intermediary_pair=None)[source]#
- Parameters
routing_state (BacktestRoutingState) –
target_pair (TradingPairIdentifier) –
reserve_asset (AssetIdentifier) –
reserve_asset_amount (Decimal) –
max_slippage (float) – Max slippage per trade. 0.01 is 1%.
check_balances – Check on-chain balances that the account has enough tokens and raise exception if not.
intermediary_pair (Optional[TradingPairIdentifier]) – If the trade needs to be routed through a intermediary pool, e.g. BUSD -> BNB -> Cake.
- Returns
List of prepared transactions to make this trade. These transactions, like approve() may relate to the earlier transactions in the routing_state.
- Return type
- route_pair(pair_universe, trading_pair)[source]#
Return Uniswap routing information (path components) for a trading pair.
For three-way pairs, figure out the intermedia step.
- Returns
(router address, target pair, intermediate pair) tuple
- Parameters
pair_universe (PandasPairUniverse) –
trading_pair (TradingPairIdentifier) –
- Return type
Tuple[TradingPairIdentifier, Optional[TradingPairIdentifier]]
- setup_internal(routing_state, trade)[source]#
Simulate trade braodcast and mark it as success.
- Parameters
routing_state (RoutingState) –
trade (TradeExecution) –
- setup_trades(routing_state, trades, check_balances=False)[source]#
Strategy and live execution connection.
Turns abstract strategy trades to real blockchain transactions.
Modifies TradeExecution objects in place and associates a blockchain transaction for each
Signs tranactions from the hot wallet and broadcasts them to the network
- Parameters
check_balances – Check that the wallet has enough reserves to perform the trades before executing them. Because we are selling before buying. sometimes we do no know this until the sell tx has been completed.
max_slippage – Max slippaeg tolerated per trade. 0.01 is 1%.
routing_state (BacktestRoutingState) –
trades (List[TradeExecution]) –
- create_routing_state(universe, execution_details)[source]#
Create a new routing state for this cycle.
- Parameters
universe (TradingStrategyUniverse) –
execution_details (dict) –
- Return type