Developers · public by design

API & embeds

Every gauge, its history, and the markets behind it are served from a public, unauthenticated read API. The numbers are free to cite — in articles, dashboards, or research — with attribution to net-long.com. No key required.

Base URL & conventions

All endpoints are under https://net-long.com/api. Responses are JSON. {ticker} is case-insensitive (DOOM, doom).

Append ?live=1 to a gauge-bearing endpoint to recompute against fresh CLOB midpoints instead of the last cached snapshot. Without it you get the most recent cached marks (faster, and identical between requests within a refresh window). The live boolean in the payload tells you which you got.

These are read endpoints. Please cache where you can; gauges only move on the ~15s refresh cadence.

GET/api/themes

Every active index with its current gauge, leg count, 7-day move, and breadth. Indices not yet live carry a null gauge.

Request

curl https://net-long.com/api/themes

Response (abridged)

[
  {
    "ticker": "DOOM",
    "name": "World Doom Index",
    "rubric": "agent-v0.1",
    "gauge": 25.1,
    "n_legs": 32,
    "live": true,
    "as_of": "2026-06-11T18:41:50Z",
    "delta_7d": 0.4,
    "breadth_1d": 28.1
  }
  // …one entry per theme
]

GET/api/themes/{ticker}

Full detail for one index: gauge, the weighted constituent markets, breadth windows, carry tilt, average horizon, and the value-neutral axis charter.

Request

curl https://net-long.com/api/themes/DOOM?live=1

Response (abridged)

{
  "theme": "DOOM",
  "name": "World Doom Index",
  "gauge": 25.1,
  "n_legs": 32,
  "avg_days_to_resolution": 214,
  "carry_tilt": -1.8,
  "live": true,
  "as_of": "2026-06-11T18:41:50Z",
  "breadth": { "d1": { "rising": 9, "falling": 23, "flat": 0, "n": 32, "score": 28.1 }, "d7": { … } },
  "legs": [
    {
      "market_id": 410,
      "question": "Will China invade Taiwan by end of 2026?",
      "slug": "will-china-invade-taiwan-before-2027",
      "sign": -1,
      "p_yes": 0.061,
      "q": 0.939,
      "relevance": 0.92,
      "cluster": "taiwan",
      "liquidity": 184213,
      "end_date": "2026-12-31T00:00:00",
      "w": 0.071,
      "contribution": 6.67
    }
    // …n_legs total
  ],
  "axis_charter": "+ means the world is closer to catastrophe …"
}

GET/api/themes/{ticker}/series

Daily history: the 0–100 gauge with the leg count on each day. Pre-launch points are reconstructed; new points accrue daily.

Request

curl https://net-long.com/api/themes/DOOM/series

Response (abridged)

{
  "ticker": "DOOM",
  "rubric": "agent-v0.1",
  "points": [
    { "day": "2025-11-06", "gauge": 22.58, "n_legs": 6 },
    { "day": "2025-11-07", "gauge": 22.91, "n_legs": 6 }
    // …one point per calendar day
  ]
}

GET/api/themes/{ticker}/constituents

Each leg's theme-aligned probability (q) over time, plus its weight and correlated cluster — the raw material behind the gauge. Optional ?days=N window (default 365).

Request

curl https://net-long.com/api/themes/DOOM/constituents?days=90

Response (abridged)

{
  "ticker": "DOOM",
  "days": 90,
  "live": false,
  "as_of": "2026-06-11T18:41:50Z",
  "legs": [
    {
      "market_id": 410,
      "question": "Will China invade Taiwan by end of 2026?",
      "slug": "will-china-invade-taiwan-before-2027",
      "sign": -1,
      "w": 0.071,
      "cluster": "taiwan",
      "q_now": 0.939,
      "series": [ { "day": "2026-04-05", "q": 0.92 }, … ]
    }
    // …one entry per leg
  ]
}

GET/api/themes/{ticker}/basket

The exact share-weighted basket for a stake and direction — the positions you'd buy to take the theme long or short. Params: amount (USDC), direction (long | short).

Request

curl https://net-long.com/api/themes/DOOM/basket?amount=100&direction=short

Response (abridged)

{
  "direction": "short",
  "amount": 100.0,
  "max_payout": 133.51,
  "legs": [
    {
      "market_id": 410,
      "question": "Will China invade Taiwan by end of 2026?",
      "slug": "will-china-invade-taiwan-before-2027",
      "side": "NO",
      "token_id": "9077233243448714926…",
      "price": 0.939,
      "shares": 6.8,
      "cost": 6.39,
      "pct": 6.4
    }
    // …one entry per leg, heaviest first
  ]
}

GET/api/health

Liveness and freshness: market count, last ingest, and the most recent series day. Use it for uptime checks.

Request

curl https://net-long.com/api/health

Response (abridged)

{
  "ok": true,
  "markets": 1284,
  "last_ingest": "2026-06-11T18:41:50Z",
  "last_series_day": "2026-06-11"
}

Embeddable widgets

Drop a live gauge on your page

Each index has a chrome-less card at /embed/{ticker} that refreshes itself every 60 seconds and links back to net-long.com. Paste the snippet anywhere an iframe is allowed. Sized 360×200.

GSPXGermany Stability & Prosperity

Preview →

<iframe src="https://net-long.com/embed/GSPX" width="360" height="200" style="border:0" loading="lazy" title="Germany Stability & Prosperity — Net Long"></iframe>

DOOMWorld Doom Index

Preview →

<iframe src="https://net-long.com/embed/DOOM" width="360" height="200" style="border:0" loading="lazy" title="World Doom Index — Net Long"></iframe>

USIXUS Institutional Health

Preview →

<iframe src="https://net-long.com/embed/USIX" width="360" height="200" style="border:0" loading="lazy" title="US Institutional Health — Net Long"></iframe>

AIXAI Acceleration

Preview →

<iframe src="https://net-long.com/embed/AIX" width="360" height="200" style="border:0" loading="lazy" title="AI Acceleration — Net Long"></iframe>

MEXMiddle East Escalation

Preview →

<iframe src="https://net-long.com/embed/MEX" width="360" height="200" style="border:0" loading="lazy" title="Middle East Escalation — Net Long"></iframe>

RECXGlobal Recession

Preview →

<iframe src="https://net-long.com/embed/RECX" width="360" height="200" style="border:0" loading="lazy" title="Global Recession — Net Long"></iframe>

Citing Net Long

The data is free to cite. Please attribute to net-long.com and link back to the index (e.g. net-long.com/app/DOOM) so readers can see the live number and the methodology behind it. The full math is on the whitepaper.