aegis-sdk

Privacy-routed HTTP requests for AI agents and developers. Route any request through a residential exit node and pay per-request in USDC on Solana.

Install

pip install aegis-sdk

Quick start

from aegis import Aegis

aegis = Aegis(api_key="aegis_your_key_here")

# GET — routed through a US residential IP
res = aegis.get("https://httpbin.org/ip")
print(res.json())
# {"origin": "12.34.56.78"}  ← a residential US IP, not yours

# POST with a specific exit country
res = aegis.post(
    "https://api.example.com/data",
    body={"query": "hello"},
    country="JP",
    ip_class="residential",
)
print(res.json())

API

Aegis(api_key, *, base_url?, default_country?, default_ip_class?)

aegis.fetch(url, *, method, country, ip_class, headers, body) → AegisResponse

Full request method. All keyword args are optional.

aegis.get(url, *, country?, ip_class?, headers?) → AegisResponse

aegis.post(url, body, *, country?, ip_class?, headers?) → AegisResponse

aegis.balance() → dict

Returns {"usdc": "1.23"} — remaining balance for this API key.

AegisResponse

res.status   # int
res.ok       # bool
res.headers  # dict
res.text()   # str
res.json()   # any

Errors

from aegis.errors import AegisAuthError, AegisBalanceError, AegisNodeError

try:
    res = aegis.get("https://example.com", country="JP")
except AegisBalanceError:
    pass  # top up at aegisprivacy.org/dashboard
except AegisNodeError:
    pass  # no nodes available in that country
except AegisAuthError:
    pass  # invalid API key

Pricing

Get an API key at aegisprivacy.org/agent.