Aggregator Dual-Channel Overview

1. Overview

The aggregator offers two integration modes — Fast Mode and Full Mode — representing a trade-off between fill success rate and quote optimality. General recommendation: use Fast Mode for small-to-mid volume where stable fills matter most; use Full Mode for large orders where getting the best price and full routing coverage is the priority, combined with pre-execution simulation to validate feasibility.

Additional notes on integration and order placement:

• Fast Mode can be used standalone: Simply use Fast quoting and order submission. Ideal for integrations that prefer a simple flow and prioritize success rate and stability by default.
• Full Mode should not be the sole quote source: When Full Mode is enabled, it is recommended to quote in parallel with Fast Mode and run pre-execution validation on candidates before placing an order. Place the order using the source that passes pre-execution and offers a better overall quote. If Full Mode fails pre-execution or carries higher risk, fall back to Fast Mode or other viable routes.

2. Dual-Channel Introduction

2.1 Fast Mode — Best for Small-to-Mid Projects (Stable, Fast, Low-Friction)

In a nutshell: Routes via a curated set of RFQ sources + full AMM pool coverage, prioritizing faster responses and higher fill rates.

• Coverage: Full AMM pool coverage captures mainstream liquidity; RFQ uses a curated/limited set of sources to reduce uncertainty from complex matching.
• Experience: Best suited for everyday trading volumes and business scenarios sensitive to latency and fill rate.
• Pricing: May not always beat Full Mode on specific pairs or market conditions (due to more conservative RFQ coverage), but is more stable and easier to fill overall.
• Best for: Small-to-mid projects, traffic spikes during campaigns, and integrations that want to avoid frequent failures and retries.
• Usage: Can be used standalone for quoting and execution — no need to run other modes in parallel.

2.2 Full Mode — Best for Large Orders (Stronger Quotes, but “Validate First”)

In a nutshell: Uses full RFQ + full AMM pool coverage to maximize quote space. Better suited for large orders, but requires pre-execution simulation to confirm that routes are actually executable on-chain.

• Coverage: Both RFQ and AMM are at full scale, making it theoretically easier to find better quotes.
• Capability requirement: Pre-execution (simulate / quote-to-execution validation) is strongly recommended to confirm route viability and avoid “looks great on paper, fails on-chain” scenarios.
• Trade-off: Higher probability of a better quote, but due to more complex routes and more counterparties/conditions, fill rate may be slightly lower than Fast Mode (mitigated via pre-execution and fallback strategies).
• Best for: Large orders, price-sensitive projects with engineered risk control and retry strategies.
• Usage (in combination with Fast Mode): When Full Mode is enabled, quote from both modes simultaneously; run pre-execution on both results (or sample as capacity allows), and place the order using the route that passes pre-execution and offers a better quote. If the Full Mode route is not executable or not superior, fall back to Fast Mode to keep overall fill rate under control.

3. Comparison Summary

4. How to Use

1. Contact our business team to enable dual-channel access
2. In the swap API, set market to bgwaggregatorplus to use Full Mode
3. Recommended: quote from both Fast Mode and Full Mode in parallel, run pre-execution on both results, and place the order using the market that passes pre-execution and offers the better quote (Fast Mode market values: bgwevmaggregator for EVM chains, bgwAggregator for Solana)
4. Currently, Full Mode is only available in Instruction Mode