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.