> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bebop.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Route trades through competing solvers for comprehensive token coverage.

The Aggregation API connects you to Bebop's network of solvers who compete to find the best execution path across all available decentralized liquidity sources.

## When to Use

* You need **broad token coverage** including long-tail assets that private market makers may not quote
* You prefer **solver competition** across all available on-chain liquidity rather than a single market maker's inventory
* You are willing to configure **slippage tolerance** in exchange for access to deeper, more diverse liquidity pools

## At a Glance

| | |
| - | - |
| **Transport** | REST |
| **Authentication** | API key |
| **Signing** | Sign the `tx` object from the quote. |
| **On-chain transaction** | Broadcast `tx` before the quote expires. |
| **Complexity** | Medium - similar to RFQ, plus slippage configuration |

## How It Works

Aggregation API clients broadcast the returned transaction for on-chain settlement.

| Step | Action | You send | You get back |
| - | - | - | - |
| 1 | Request a quote | Token pair, amount | Best solver price and a `tx` object |
| 2 | Approve the sell token | `approvalTarget` and amount | Token allowance |
| 3 | Broadcast on-chain | Signed `tx` object | On-chain settlement |

See [Execution](/core-concepts/execution-modes) for the transaction flow.

## Slippage Protection

The Aggregation API applies slippage protection to account for price movement between the quote and settlement. This is a key difference from the RFQ API, where quotes are firm with guaranteed execution and guaranteed fill.

The `slippage` parameter on the quote request sets the maximum acceptable price deviation (0-50%, up to 2 decimal places). When omitted, the solver determines an appropriate slippage based on the pair and current market conditions.

In the quote response:

| Field | Description |
| - | - |
| `buyTokens.{addr}.amount` | Expected fill amount (best case) |
| `buyTokens.{addr}.minimumAmount` | Guaranteed minimum after slippage |

The settlement transaction reverts if the solver cannot deliver the minimum amount. Any output above that minimum benefits the taker.

## Key Endpoints

| Endpoint | Purpose |
| - | - |
| `GET /jam/{network}/v2/quote` | Request a quote through solver competition |

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/aggregation-api/quickstart">
    Make your first trade in 10-15 minutes.
  </Card>

  <Card title="Token Approvals" icon="key" href="/core-concepts/token-approvals">
    Set up ERC-20 approvals before trading.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.