API Reference
Hanzo World API Hanzo World Model — real-time global-intelligence data on the unified cloud
Hanzo World Model — real-time global-intelligence data on the unified cloud
Base URL https://api.hanzo.aiVersion 1.0.0 Operations 69
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions .
curl -H "Authorization: Bearer $HANZO_API_KEY " https://api.hanzo.ai Method Endpoint Description POST/v1/world/groq-summarizeWorld-brief summary via Hanzo inference (forwards the caller IAM token → org/project/billing; anon → skipped) POST/v1/world/openrouter-summarizeAlt summary path via Hanzo inference (per-user IAM token) POST/v1/world/classify-batchBatch headline classification (per-user IAM token) POST/v1/world/classify-eventSingle event classification (per-user IAM token) POST/v1/world/country-intelAI country intelligence brief (per-user IAM token)
Method Endpoint Description GET/v1/world/cloud-pulsePublic platform aggregate (SaaS variant). Anonymized counts; demo-flagged unless a service token is wired server-side. GET/v1/world/cloud/modelsPublic served-model catalog + scale (from the gateway /v1/models). No auth. GET/v1/world/cloud/fleetADMIN. Machines + GPUs grouped by provider/region (visor). Requires an admin-org IAM bearer; 401 without a token, 403 for non-admin. GET/v1/world/cloud/servicesADMIN. Per-subsystem health + RED metrics (o11y). Requires an admin-org IAM bearer. GET/v1/world/cloud/analyticsADMIN. Web analytics aggregate — top pages/referrers/countries, live visitors (analytics.hanzo.ai). Requires an admin-org IAM bearer. GET/v1/world/cloud/llmADMIN. Platform LLM observability — per-model/per-org usage, tokens, cost, errors, trace latency (cloud /v1/admin/o11y). Requires an admin-org IAM bearer. GET/v1/world/cloud/chain-nodesPublic blockchain-network map data — per-network block height, peer count, live flag, and modeled node positions (positionsModeled:true; counts are real, geo is illustrative). No auth. GET/v1/world/cloud/byo-gpuPublic BYO-GPU map data — connected GPU workers by region (real counts when a service token is wired server-side, else demo-flagged). No auth. GET/v1/world/cloud/trafficPublic request-traffic arcs — country-level origin → nearest region, weight-normalized (real analytics when a service token is wired server-side, else demo-flagged). No auth.
Method Endpoint Description GET/v1/world/acledACLED conflict events (requires ACLED_ACCESS_TOKEN) GET/v1/world/acled-conflictACLED conflict summary (requires ACLED_ACCESS_TOKEN) GET/v1/world/ucdpUCDP conflict data GET/v1/world/ucdp-eventsUCDP georeferenced events GET/v1/world/unhcr-populationUNHCR displacement/population GET/v1/world/hapiHumanitarian API (HDX HAPI) GET/v1/world/cyber-threatsCyber threat feed
Method Endpoint Description GET/v1/world/earthquakesUSGS earthquake feed GET/v1/world/firms-firesNASA FIRMS active fires (requires NASA_FIRMS_API_KEY) GET/v1/world/openskyOpenSky flight states GET/v1/world/ais-snapshotAIS vessel snapshot (requires WS_RELAY_URL) GET/v1/world/wingbitsWingbits ADS-B (requires WINGBITS_API_KEY) GET/v1/world/climate-anomaliesClimate anomaly feed GET/v1/world/worldpop-exposurePopulation exposure model GET/v1/world/faa-statusFAA airport status GET/v1/world/nga-warningsNGA maritime safety warnings GET/v1/world/cloudflare-outagesCloudflare internet outages
Method Endpoint Description GET/v1/world/risk-scoresCountry risk scores GET/v1/world/theater-postureStrategic theater posture GET/v1/world/temporal-baselineTemporal baseline metrics GET/v1/world/service-statusUpstream data-source status GET/v1/world/pizzint/dashboard-dataPIZZINT dashboard aggregate GET/v1/world/pizzint/gdelt/batchPIZZINT GDELT batch GET/v1/world/model/stateWorld model — full compact world-state snapshot (all entities, instability-ranked) GET/v1/world/model/country/{iso}World model — one country's full state vector + recent deltas GET/v1/world/model/topWorld model — top entities by metric GET/v1/world/model/changesWorld model — what changed since a timestamp (the inform-our-AI hook) GET/v1/world/model/streamWorld model — SSE stream of state deltas as folds land
Method Endpoint Description GET/v1/world/coingeckoCrypto spot prices (CoinGecko) GET/v1/world/polymarketPrediction markets (Polymarket gamma) GET/v1/world/yahoo-financeEquity/index quotes (Yahoo) GET/v1/world/finnhubMarket data (Finnhub; requires FINNHUB_KEY) GET/v1/world/stock-indexStock index snapshot GET/v1/world/macro-signalsMacro market-radar signals GET/v1/world/etf-flowsBTC/crypto ETF flows GET/v1/world/stablecoin-marketsStablecoin market health GET/v1/world/indicatorsTrader indicator suite (VIX/VVIX/MOVE, yield curve + 2s10s, crypto/equity fear-greed, momentum, sector breadth, BTC dominance + perp funding, DXY/metals, risk-on/off composite) GET/v1/world/sentimentRealtime news-sentiment index (GDELT tone: global + per-topic + per-region, 24h sparkline + velocity) GET/v1/world/fred-dataFRED economic series (requires FRED_API_KEY) GET/v1/world/worldbankWorld Bank indicators GET/v1/world/eiaUS EIA energy data (requires EIA_API_KEY)
Method Endpoint Description GET/v1/world/healthLiveness probe GET/v1/world/versionBuild version
Method Endpoint Description GET/v1/world/gdelt-docGDELT article search GET/v1/world/gdelt-geoGDELT geo-tagged events GET/v1/world/rss-proxyAllowlisted RSS feed proxy (SSRF-bounded) GET/v1/world/hackernewsHacker News stories GET/v1/world/github-trendingGitHub trending repositories GET/v1/world/arxivarXiv research feed (backs Robotics/Quantum lenses) GET/v1/world/tech-eventsCurated technology events GET/v1/world/storyStory detail GET/v1/world/og-storyOpen-graph story card
Method Endpoint Description GET/v1/world/limitsResolved World plan limits (contract echo)
Method Endpoint Description GET/v1/world/youtube/liveResolve a channel handle to its current LIVE video id GET/v1/world/youtube/embedSelf-contained IFrame-API player page (text/html)
All Hanzo APIs · OpenAPI spec
How is this guide?