public/openapi.md
Last updated: July 7, 2026
The World Monitor OpenAPI Specification is the machine-readable contract for the World Monitor REST API — the HTTP surface that exposes the same real-time global-intelligence tools and data as the MCP server via granular REST endpoints, returning source-attributed structured JSON. Point your OpenAPI client, code generator, or agent at the spec to discover every endpoint, parameter, and response shape.
https://api.worldmonitor.appapplication/yaml; charset=utf-8 (YAML) and application/json; charset=utf-8 (JSON), both with Access-Control-Allow-Origin: *. The API catalog advertises the OpenAPI descriptor media type application/vnd.oai.openapi for the spec.The spec is generated on every deploy from the canonical proto/service definitions, so it always matches the running gateway — there is no hand-maintained drift.
Send the header X-WorldMonitor-Key: wm_<40-hex> on data calls (issue a key at https://worldmonitor.app/pro); discovery routes are public. Always send a descriptive User-Agent — the edge firewall challenges generic library agents (curl/*, python-requests/*), and a 403 means "retry with a real UA", not "endpoint missing". Rate limit: 60 requests/minute/key; honor Retry-After on 429. Full matrix: https://www.worldmonitor.app/docs/usage-auth · walkthrough: auth.md
# Generate a typed client from the spec:
npx @openapitools/openapi-generator-cli generate \
-i https://worldmonitor.app/openapi.yaml -g python -o ./wm-client
Or skip codegen entirely and use an official SDK or the CLI.