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.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.
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 | EIP-712 (gasless) / none (self-execution) |
| On-chain tx | Bebop submits (gasless) or you broadcast (self-execution) |
| Gasless | Yes (default) |
| Complexity | Medium - similar to RFQ, plus slippage configuration |
How It Works
The Aggregation API supports two execution modes. Gasless is the default and recommended for most integrations.- Gasless (default)
- Self-execution
Bebop handles on-chain submission. Your users sign a message but never pay gas.
| Step | Action | You send | You get back |
|---|---|---|---|
| 1 | Request a quote | Token pair, amount | Best solver price, EIP-712 typed data (JamOrder) |
| 2 | Sign the order | EIP-712 typed data → taker wallet | Signature |
| 3 | Submit to Bebop | Signature → POST /jam/{network}/v2/order | Quote ID |
| 4 | Poll for settlement | Quote ID → GET /jam/{network}/v2/order-status | Status: Settled |
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. Theslippage 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 |
toSign.buyAmounts | The minimumAmount values - this is what you sign and what the contract enforces |
buyAmounts. Any amount above that minimum is surplus that benefits the taker.
Key Endpoints
| Endpoint | Purpose |
|---|---|
GET /jam/{network}/v2/quote | Request a quote through solver competition |
POST /jam/{network}/v2/order | Submit a signed order for gasless settlement |
GET /jam/{network}/v2/order-status | Poll settlement status |
Next Steps
Quickstart
Make your first trade in 10-15 minutes.
Token Approvals
Set up ERC-20 approvals before trading.