Quickstart

To call the Off-Nadir Delta API, create an API key, then send it as a bearer token to any endpoint under /api/v1. Verify your key for free against the Daily World Brief, then query geolocated event signals. You can do this with curl, the Python SDK, or any MCP client — all three are shown below.

1. Get an API key

Create a key from your Developer API settings. Keys look like ond_… and are shown once — store it securely and never expose it in client-side code. The API — including the AI endpoints (/assess, /analyst) — is available on every plan, including Free; the only gate is your token balance.

2. Verify your key (free)

The Daily World Brief is free, so it is the safest first call. A 200 response means your key works.

curl -H "Authorization: Bearer ond_..." \
  "https://offnadir-delta.com/api/v1/brief"

3. Query geolocated signals (3 tokens/page)

Pass a bounding box (bbox=minLon,minLat,maxLon,maxLat), a date window, and optional filters. Results are cursor-paginated.

curl -H "Authorization: Bearer ond_..." \
  "https://offnadir-delta.com/api/v1/signals?bbox=22,44,40,53&days=7&min_severity=5&sort=severity&limit=50"

Python SDK

The official open-source Python SDK gives you typed models, sync and async clients, and automatic pagination. See the SDKs page to install it.

from offnadir_delta import Client

with Client(api_key="ond_...") as client:
    # Free preflight: check your balance and plan.
    print(client.usage().tokens.remaining)

    # Query the highest-severity signals in an area of interest.
    page = client.signals.list(
        bbox=[22, 44, 40, 53], days=7, min_severity=5, sort="severity", limit=50
    )
    for signal in page.signals:
        print(signal.event_date, signal.country_code, signal.title)

MCP client

Connect an AI agent to the same data over the Model Context Protocol. For Claude Code:

claude mcp add --transport http off-nadir-delta \
  https://offnadir-delta.com/api/v1/mcp \
  --header "Authorization: Bearer ond_..."

See the MCP documentation for Claude Desktop, Cursor, and VS Code setup, plus the full list of tools, resources, and prompts.

Next steps

• API reference — every endpoint, parameter, and response.
• SDKs — install and use the Python client.
• MCP server — connect AI agents.