nexrade-req

Fast Python HTTP client for trading bots — bypasses exchange rate limits by routing requests through Nexrade relay nodes.

Part of the Nexrade ecosystem.

How it works

Your bot
   │
   ▼
nexrade-req  ──(no api_key)──▶  direct request to exchange
   │
   └──(with api_key)──▶  https://api.nexrade.com/market-data ──▶  exchange
                         (rotates IPs, bypasses rate limits)

• Without api_key: behaves like a normal fast HTTP client
• With api_key: routes through api.nexrade.com/market-data — each request gets a fresh IP, bypassing exchange rate limits

Installation

pip install nexrade-req

Quick start

import nexrade_req as req

# Simple GET (no relay)
r = req.get("https://api.binance.com/api/v3/ticker/price", params={"symbol": "BTCUSDT"})
print(r.status_code, r.json())

# POST
r = req.post("https://httpbin.org/post", json={"key": "value"})
print(r.json())

Using the relay network (bypass rate limits)

from nexrade_req import Client

client = Client(api_key="your_nexrade_api_key")

# All requests are routed through Nexrade relay nodes
r = client.get("https://api.binance.com/api/v3/ticker/price", params={"symbol": "ETHUSDT"})
print(r.json())

Get your API key at nexrade.com or self-host a relay proxy with nexrade-node.

Session (connection reuse)

from nexrade_req import Client

with Client(api_key="your_key") as c:
    r1 = c.get("https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT")
    r2 = c.get("https://api.binance.com/api/v3/ticker/price?symbol=ETHUSDT")

Custom relay nodes

from nexrade_req import Client

client = Client(
    api_key="your_key",
    base_urls=["https://your-own-relay.example.com"],
    endpoint="market-data",
    timeout=10,
    max_retries=3,
)

Fallback client

FallbackClient retries through the relay, then falls back to a direct request if all relay attempts fail.

from nexrade_req import FallbackClient

r = FallbackClient.get(
    "https://api.binance.com/api/v3/ticker/price",
    params={"symbol": "BTCUSDT"},
    max_retries=3,
)
print(r.json())

API reference

Top-level functions

import nexrade_req as req

req.get(url, **kwargs)
req.post(url, data=None, json=None, **kwargs)
req.put(url, data=None, **kwargs)
req.patch(url, data=None, **kwargs)
req.delete(url, **kwargs)
req.head(url, **kwargs)
req.options(url, **kwargs)
req.request(method, url, **kwargs)

Client constructor

Smart auto-mode (relay ⇄ direct failover)

When auto_mode=True the client watches every relay response. If the relay signals a limit (HTTP 429 / 503, or X-RateLimit-Remaining: 0), the client immediately switches to direct-mode — subsequent requests skip the relay and go straight to the upstream exchange — for the duration of the relay's Retry-After header (default 60 s). Once the cooldown elapses, the client flips back to relay automatically.

client = Client(api_key="your_key", auto_mode=True)

r = client.get("https://api.binance.com/api/v3/ticker/price",
               params={"symbol": "BTCUSDT"})

print(client.mode)              # "relay" or "direct"
print(client.cooldown_remaining) # seconds left in the current cooldown

This protects you from paying a relay-attempt tax when nexrade is already rate-limiting you, and it recovers without any caller intervention.

Common request kwargs

Response

Exceptions

from nexrade_req.exceptions import NexradeException

try:
    r = client.get("https://api.binance.com/...")
except NexradeException as e:
    print("All relay attempts failed:", e)

License

MIT — see LICENSE.

Part of Nexrade