Public API

OpenTrade Developer API

Integrate real-time supply chain disruption intelligence directly into your logistics platform. Monitor shipments, receive AI-generated resolution options, and automate rerouting via webhooks.

Quick Start

Demo API Key

opentrade-demo-key-2026

Read-only · 100 req/min · No sign-up required

Base URL

https://opentrade-blue.vercel.app

All endpoints prefixed with /api/v1

# Your first call — get live shipments
curl "https://opentrade-blue.vercel.app/api/v1/shipments" \
  -H "x-api-key: opentrade-demo-key-2026"

Authentication

Pass your API key in the x-api-key header on every request. Generate a production key in Settings → API Keys.

JavaScript / fetch

const res = await fetch('https://opentrade-blue.vercel.app/api/v1/shipments', {
  headers: { 'x-api-key': process.env.OPENTRADE_KEY }
});
const { data } = await res.json();

Python / requests

import os
import requests

r = requests.get(
  'https://opentrade-blue.vercel.app/api/v1/shipments',
  headers={'x-api-key': os.environ['OPENTRADE_KEY']}
)
shipments = r.json()['data']

Try It Live

Live API Tester

Endpoints

Webhooks

Register a URL to receive resolution.ready events. OpenTrade POSTs the full resolution payload to your URL whenever AI agents resolve a disruption.

// Incoming webhook payload
{
  "event": "resolution.ready",
  "traceId": "trace-abc123",
  "disruption": { "id": "disr-001", "severity": "high", "description": "..." },
  "options": [
    { "rank": 1, "description": "Reroute via Cape of Good Hope", "costDelta": 18000, "timeDeltaDays": 4 },
    { "rank": 2, "description": "Switch to air freight (urgent cargo)", "costDelta": 95000, "timeDeltaDays": -3 }
  ]
}

Your webhook endpoint must respond with HTTP 200 within 10 seconds or delivery is marked failed. Retry logic uses exponential backoff.