Pools Options

This configuration section is responsible for automatic selection of pools for arbitrage and for managing Address Lookup Tables for those pools.

---

POOL_LOADER

Description: A module that, via the Quantum Arb service external API, gets a list of pools according to pre-set filters.

Options:

• FILTERS — an object specifying the criteria for filtering pools:

  • minLiquidity — Minimum pool liquidity (in USDT).

    • Recommended ≥ 10,000 USDT to exclude low-liquidity pairs.

  • maxLiquidity — Maximum pool liquidity.

  • minVolume1m, minVolume5m, minVolume1h, minVolume24h — Minimum trading volume for the specified timeframe (in USDT).

  • minTransactions1m, minTransactions5m, minTransactions1h, minTransactions24h — Minimum number of transactions for the given period.

  • sortByField — The field by which pools are sorted (two parameters available: "liquidity" or "volume").

  • sortByOrder — Sort direction: "asc" — ascending, "desc" — descending.

  • sortByTimeframe — Timeframe used when sorting by volume (sortByField="volume").

    • Must be specified when choosing to sort by volume.

  • poolTypeLimitRaydiumAmm, poolTypeLimitRaydiumCpmm, poolTypeLimitRaydiumClmm, poolTypeLimitMeteoraDlmm, poolTypeLimitMeteoraDammV2, poolTypeLimitPumpswap — Maximum number of pools of each type per trading pair.

    • If set 1, only one pool of the corresponding type is selected.

  • minPoolsPerPairPassingFilters — Minimum number of pools that must pass filtering for a pair to be included in arbitrage.

  • minPoolsPerPair — Minimum total number of pools per pair.

  • maxPoolsPerPair — Maximum number of pools selected for a single trading pair.

  • pairLimit — Maximum number of trading pairs that will be loaded into the system at once.

  • quoteTokens — List of tokens allowed as quoted.

    • Currently supported: SOL. In the future — USDC, USDT, USD1 and others.

  • blacklistTokens — List of tokens that must be excluded from processing.

  • whitelistTokens — Tokens that should always be included, even if they do not pass other filters.

  • useTokens22 — Boolean flag (true/false), determining whether to consider tokens of the Token-2022.

Example:

# Pool selection filters for loading liquidity pools to monitor.
# Filters are applied to select active, liquid pools suitable for arbitrage.
# All filter fields are optional - pools matching all specified criteria are selected
[POOL_LOADER]
[POOL_LOADER.FILTERS]
# Minimum pool liquidity in USDT
minLiquidity = 15000
# Maximum pool liquidity in USDT
maxLiquidity = 5000000
# Minimum trading volume in last 1 minute
minVolume1m = 1000
# Minimum trading volume in last 5 minutes
minVolume5m = 5000
# Minimum trading volume in last 1 hour
minVolume1h = 10000
# Minimum trading volume in last 24 hours
minVolume24h = 50000
# Minimum transaction count in last 1 minute
minTransactions1m = 1
# Minimum transaction count in last 5 minutes
minTransactions5m = 5
# Minimum transaction count in last 1 hour
minTransactions1h = 1
# Minimum transaction count in last 24 hours
minTransactions24h = 10
# Sort pools by field (requires sortByOrder)
sortByField = "liquidity"
# Timeframe for volume sorting (required when sortByField='volume')
sortByTimeframe = "1h"
# Sort direction (requires sortByField)
sortByOrder = "desc"
# Max Raydium AMM pools per pair
poolTypeLimitRaydiumAmm = 5
# Max Raydium CPMM pools per pair
poolTypeLimitRaydiumCpmm = 5
# Max Raydium CLMM pools per pair
poolTypeLimitRaydiumClmm = 5
# Max Meteora DLMM pools per pair
poolTypeLimitMeteoraDlmm = 5
# Max Meteora DAMM v2 pools per pair
poolTypeLimitMeteoraDammV2 = 5
# Max Pumpswap pools per pair
poolTypeLimitPumpswap = 5
# Minimum pools per pair that must pass filters to include the pair
minPoolsPerPairPassingFilters = 2
# Minimum total pools required per pair
minPoolsPerPair = 2
# Maximum pools to include per pair
maxPoolsPerPair = 2
# Maximum number of token pairs to load
pairLimit = 100
# Include Token-2022 program tokens
useTokens22 = true
# Quote tokens to filter pairs.
# Currently supported: SOL only
# Future: USDC, USDT, USD1 and other quote tokens
quoteTokens = [ "So11111111111111111111111111111111111111112" ]
# Token addresses to exclude
blacklistTokens = [ "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB" ]
# Only include these token addresses
whitelistTokens = []

Note:

• If PoolsLoader returns 0 pools via the API, the system stops operation until they appear, since there are no suitable pools for arbitrage.

---

TABLE_LOOKUP_MANAGER

Description: Address Lookup Table (ALT) manager that handles creating, expanding, and updating address tables required for transactions with pools.

Options:

• ENABLED — if enabled, when new pools appear from PoolLoader the system fetches the accounts required for arbitrage from those pools and adds them to existing tables, or creates new ones if absent.

• SHOULD_ADD_LIQUIDITY_ARRAYS — determines whether to add bin_arrays or tick_arrays for pools such as Meteora DLMM and Raydium CLMM.

Example:

# Address Lookup Tables for transaction size optimization
[TABLE_LOOKUP_MANAGER]
# Enable automatic ALT management
ENABLED = true
# Add bin_arrays/tick_arrays to ALTs for DLMM/CLMM pools
SHOULD_ADD_LIQUIDITY_ARRAYS = false