When to Use
- You need firm pricing with guaranteed execution and guaranteed fill - no slippage, no solver auction, no price uncertainty
- You are trading major token pairs where private market maker liquidity offers tighter spreads than on-chain routing
- You want atomic multi-token swaps (e.g., sell 3 tokens for 1 or buy 1 token with 3 tokens) settled in a single transaction
At a Glance
| Transport | REST |
| Authentication | API key |
| Signing | EIP-712 |
| On-chain tx | Bebop submits (gasless) or you broadcast (self-execution) |
| Gasless | Yes (default) |
| Complexity | Medium - EIP-712 signing + token approvals |
How It Works
The RFQ 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 | Firm price, EIP-712 typed data |
| 2 | Sign the order | EIP-712 typed data → taker wallet | Signature |
| 3 | Submit to Bebop | Signature → POST /v3/order | Quote ID |
| 4 | Poll for settlement | Quote ID → GET /v3/order-status | Status: Settled |
Key Endpoints
| Endpoint | Purpose |
|---|---|
GET /pmm/{network}/v3/quote | Request a firm quote for a token swap |
POST /pmm/{network}/v3/order | Submit a signed order for gasless settlement |
GET /pmm/{network}/v3/order-status | Poll settlement status by quote ID (both modes) |
Next Steps
Quickstart
Make your first trade in 10-15 minutes.
Guides
Gasless execution, partial fills, multi-token trades, and more.