SDKs
Official, open-source client libraries for the Off-Nadir Delta API and MCP server. Today there is a Python SDK; more languages may follow.
Python
BetaApache-2.0- Synchronous Client and asynchronous AsyncClient (one dependency footprint).
- Fully typed responses (Pydantic v2), forward-compatible with additive API fields.
- Automatic cursor pagination, retry with backoff, and a uniform exception hierarchy.
- A built-in MCP client for the JSON-RPC MCP endpoint.
- Python 3.9–3.13. Open-source under Apache-2.0.
Install
pip install offnadir-deltaSynchronous
from offnadir_delta import Client
with Client(api_key="ond_...") as client: # or set OFFNADIR_DELTA_API_KEY
page = client.signals.list(bbox=[22, 44, 40, 53], days=7, min_severity=5, limit=50)
for signal in page.signals:
print(signal.event_date, signal.country_code, signal.title)
# Auto-pagination across pages:
for signal in client.signals.iterate(bbox=[22, 44, 40, 53], days=30):
...Asynchronous
import asyncio
from offnadir_delta import AsyncClient
async def main():
async with AsyncClient(api_key="ond_...") as client:
async for signal in client.signals.iterate(bbox=[22, 44, 40, 53], days=7):
print(signal.title)
asyncio.run(main())Error handling
from offnadir_delta.errors import InsufficientTokensError, RateLimitError
try:
client.signals.list(bbox=[22, 44, 40, 53])
except InsufficientTokensError as e:
print("Need", e.required, "have", e.available)
except RateLimitError as e:
print("Retry after", e.retry_after, "seconds")The SDK wraps signals, statistics, hotspots, imagery, collection planning and satellite passes, standing orders, the claim ledger, usage and status, the Daily World Brief, and the assessment and analyst endpoints — plus a thin client for the MCP server. The Delta Monitor endpoints (/api/v1/monitoring) are not wrapped yet — call them directly, or over MCP. Like the rest of the API, the assessment and analyst endpoints are available on every plan; the only gate is your token balance.
From headline to satellite evidence
One connected intelligence workflow across four surfaces — free to start, no GIS software or remote-sensing background required.