Overview

Infrared is a liquidity aggregation API that routes token swaps across multiple decentralized exchange protocols to find optimal execution. Rather than integrating with each protocol individually, consumers make a single API call and Infrared handles protocol discovery, route optimization, and transaction assembly.

The API follows a two-step flow: request a quote to get the best available route across protocols, then build an executable transaction from that quote. This separation gives consumers full control over when and how they execute, with the option to simulate transactions before committing.

Key Capabilities

• Multi-protocol aggregation -- Routes swaps through the combination of protocols that produces the best output, including multi-hop paths across different protocol types.

• Optimal routing -- Evaluates available liquidity across all supported protocols and selects the execution path with the best price and lowest cost.

• Split output support -- A single request can split output across multiple tokens using basis-point ratios, enabling portfolio-style swaps in one transaction.

• Transaction simulation -- Quotes can be simulated against a fork of the current chain state to verify expected outputs before building the final transaction.

• Gas-aware cost estimation -- Every quote includes EIP-1559 gas parameters and cost breakdowns with configurable priority tiers.

• Permit2 support -- Optional signature-based approval flow eliminates the need for separate on-chain approval transactions.

Supported Chains

Infrared currently supports Ethereum mainnet (chain ID 1). The API is designed for multi-chain operation, with additional networks planned.

Supported Protocols

Infrared aggregates liquidity across the following protocols:

Protocol	Type
Uniswap V2	Constant-product AMM
Uniswap V3	Concentrated liquidity AMM
SushiSwap	Constant-product AMM
Curve	StableSwap AMM
Balancer	Weighted pool AMM
Fluid	DEX and lending
Morpho	Lending protocol
Lido	Liquid staking
ERC-4626 vaults	Tokenized vault standard

The routing engine treats each protocol as a source of liquidity and can combine multiple protocols in a single swap path.

Quote-Then-Build Flow

Every swap goes through two API calls:

1. Quote (POST /v1/quote) -- Submit input tokens, desired output tokens, and the taker address. Infrared evaluates all available routes and returns the optimal path with estimated outputs, costs, and a quote_id.

2. Build (POST /v1/build) -- Submit the quote_id to assemble an unsigned transaction targeting the ExecutionProxy contract. The response contains everything needed to sign and submit on-chain: to, data, value, gas, and chain_id.

This two-step design allows consumers to inspect the quote, run simulations, attach Permit2 signatures, and build the same quote multiple times without re-routing.