📡 bgproutes.io real-time data access

Welcome to bgproutes.io’s real-time stream — your gateway to live BGP data. This service offers authenticated users low-latency access to BGP updates collected from the vantage points listed on our vantage_points page. These updates are sourced from platforms that support real-time streaming: bgproutes.io, ris, and routeviews. For pch and cgtf, real-time data is not available, but you can still access their historical records through the bgproutes.io API bgproutes.io API.

We stream data in real time through our WebSocket server, available at:

wss://websocket.bgproutes.io

The server runs over port 443 and delivers live BGP updates for the IP prefixes configured by each client (and associated to an API key). Our backend uses Apache Kafka to manage and deliver BGP updates. When a user connects via WebSocket using their API key, the server subscribes to the appropriate Kafka topics to stream updates for the selected prefixes.

Getting started is simple: First, generate an API key and associate the prefixes you want to monitor. Then, connect to the WebSocket using this key. We walk you through both steps below.

💡 We recommend using our Python client, it simplifies authentication, connection handling, and data parsing.

---

🔐 Authentication

Each WebSocket session requires an API key, which must be associated with the prefixes you wish to monitor.

1. Log in to bgproutes.io.

2. Navigate to the API Key section.

3. Generate an API key for real-time updates and associate it with a comma-separated list of prefixes, such as:

   192.23.62.0/24,2a06:3040:10::/48
   

You can also generate a key with no prefixes initially, and add them later.

⚠️ Your API key is not stored on our servers. Save it securely — it cannot be recovered. API key–prefix associations expire after 4 hours of inactivity (only the prefixes are cleared; the key remains valid).

Alternative Configuration of API key–prefix Association

You can also manage your prefixes programmatically via our Live Manager API and its update_live_prefixes endpoint. Example:

curl "https://live-manager-api.bgproutes.io/update_live_prefixes?api_key=MY_KEY&new_pfxs=192.23.62.0/24,2a06:3040:10::/48"

This associates the prefixes 192.23.62.0/24 and 2a06:3040:10::/48 to the API Key MY_KEY. Again, our Python client makes this even easier.

---

🔌 Connecting to the WebSocket

Once your API key is ready and associated with the desired prefixes, you can connect to our WebSocket server using a tool like wscat:

npx wscat -c "wss://websocket.bgproutes.io/?api_key=YOUR_API_KEY"

You’ll then start receiving real-time BGP updates directly in your terminal!

---

⚖️ Rate Limits

Each API key may be associated with up to 10 prefixes. If you require more, please contact us to discuss your use case.

---

For bug reports or feedback, feel free to reach out at contact@bgproutes.io.

Enjoy our real time service! 🌐