Authentication

All production usage of Bebop’s APIs requires an API key. Without one, trading endpoints return widened demo-mode quotes and some endpoints are inaccessible entirely.

Obtaining an API Key

Request an API key through the Bebop support page. The team will provision a key and send it to you directly.

Passing Your API Key

REST APIs
WebSocket

For HTTP requests (RFQ, Aggregation, Trade History), authenticate with the Authorization header using your API key as a Bearer token:

YOUR_API_KEY = "YOUR_API_KEY"

headers = {"Authorization": f"Bearer {YOUR_API_KEY}"}

With curl:

curl -H "Authorization: Bearer YOUR_API_KEY" ...

For WebSocket connections (Price API), send the Authorization header with your API key as a Bearer token on the connection handshake:

import websockets

ws_url = "wss://api.bebop.xyz/pmm/ethereum/v3/pricing"

async with websockets.connect(
    ws_url,
    additional_headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
) as ws:
    ...

What Requires Authentication

API	Without key	With key
Price API	Cannot connect	Full access to real-time price streams
RFQ API	Demo mode - quotes are widened, heavily rate limited and not suitable for production	Firm, tight quotes ready for execution
Aggregation API	Demo mode - quotes are widened, heavily rate limited and not suitable for production	Firm, tight quotes ready for execution
Trade History API	Public lookups by wallet address only	Full access - see all trades attributed to your integration

Demo mode is useful for testing your integration flow end-to-end before going live, but the prices returned are not competitive.

Rate Limits

Rate limits apply per API key. If you have concerns about throughput for your use case, reach out via the support page.

Best Practices

Keep your API key secret. Do not expose it in client-side code, public repositories, or browser network requests. All Bebop API calls should be made from your backend. If you suspect your key has been compromised, contact the Bebop team immediately via the support page to rotate it.

Introduction

Core Concepts

RFQ API

BopAMM

Aggregation API

Price API

Trade History API

Obtaining an API Key

Passing Your API Key

What Requires Authentication

Rate Limits

Best Practices

​Obtaining an API Key

​Passing Your API Key

​What Requires Authentication

​Rate Limits

​Best Practices

Obtaining an API Key

Passing Your API Key

What Requires Authentication

Rate Limits

Best Practices