The institutional research pipeline, as an endpoint.

A full research pipeline, available as HTTP.

Prime runs the same steps as the Research Desk: parse a thesis, search academic sources, backtest on historical prices, write a summary, review with a second model, and sign the result.

Anyone who needs a defensible research artifact, fast.

Run a real thesis on a shared demo key.

This widget posts to the live /api/v1/runs. Pick a preset or type your own — runs typically complete in 40–90s depending on provider latency. The output is byte-identical to what your code will receive in production.

The agent pipeline.

1. 1
   Researcher

   Claude Haiku 4.5 (ReAct tool loop) + arXiv

   Runs a fast tool-use loop — macro, strategy-graph prior art, asset stats, and a best-effort arXiv literature query — then decomposes the thesis into a grounded hypothesis and a liquid candidate universe.

2. 2
   Quant

   Yahoo Finance OHLC + native backtester

   Translates the thesis into strategy variants, runs backtests on real historical daily closes (model-estimated fallback when no liquid feed exists), and picks the best risk-adjusted result net of turnover cost.

3. 3
   Overlay

   Deterministic rules

   Adjusts weights using macro data and position limits. Every change is logged.

4. 4
   Critic

   Claude — adversarial

   Lists falsifying observations, regime risks, and what would break the thesis.

5. 5
   Scribe

   Claude Opus 4.8 (Sonnet 4.6 fallback)

   Writes the report: title, evidence score, key findings, thesis stance, and risks — numbers pulled from the backtest object. Promotes to Opus 4.8 when the budget allows, else Sonnet 4.6.

6. 6
   Consensus

   GPT-5.5 (frontier)

   A separate frontier model re-reads the memo cold and either confirms or dissents. Divergence is surfaced as a first-class field — not buried in a confidence number.

7. 7
   Sign

   ed25519 + Vercel Blob

   The final memo is canonicalised, hashed, signed, and persisted. A verifyUrl comes back with the response. Public verification needs no Attevia account.

Lifecycle of a Prime run.

1. 1
   POST /api/v1/runs

   You send { thesis, currency? }. Default wait=true blocks until complete (40–90s). Set wait=false to poll with the returned id.

2. 2
   Pipeline executes server-side

   Researcher → Quant → overlay → Critic → backtest → Scribe → consensus → sign. Anthropic prompt caching reduces cost on repeat tool inputs.

3. 3
   Poll GET /api/v1/runs?id=…

   GET with ?id=yourRunId. Status flows queued → running → complete (or error). Response includes memo, metrics, signature, permalink, and verifyUrl when complete.

4. 4
   Permalink + receipt

   The permalink (/m/<id>) renders the memo as a shareable page. verifyUrl (/verify/<id>) walks through the cryptographic proof — no API key needed.

One endpoint to start. One endpoint to poll.

curl -X POST $ATTEVIA_URL/api/v1/runs \
  -H "Authorization: Bearer $ATTEVIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "thesis": "Indian rural wages + monsoon predict NIFTY auto-component alpha over 5y",
    "currency": "INR"
  }'

{
  "ok": true,
  "id": "th_8fJK2pQ",
  "status": "running",
  "poll": "/api/v1/runs?id=th_8fJK2pQ"
}

curl "$ATTEVIA_URL/api/v1/runs?id=th_8fJK2pQ" \
  -H "Authorization: Bearer $ATTEVIA_KEY"

{
  "ok": true,
  "run": {
    "id": "th_8fJK2pQ",
    "status": "complete",
    "memo": {
      "title": "Rural wage + monsoon as a leading signal for NSE auto-ancillaries",
      "summary": "Statistically meaningful but regime-sensitive…",
      "recommendation": "supported",
      "stanceLabel": "Thesis supported",
      "conviction": 0.62,
      "keyFindings": ["...", "..."]
    },
    "metrics": {
      "sharpe": 0.84,
      "annualReturn": 0.143,
      "maxDrawdown": -0.211
    },
    "signature": {
      "fingerprint": "bks8zvfobs-nOEJo",
      "digest": "a42f…",
      "signature": "cR9f…"
    },
    "permalink": "/m/th_8fJK2pQ",
    "verifyUrl": "/verify/th_8fJK2pQ"
  }
}

Typed client in 20 lines.

async function runPrime(thesis: string) {
  const start = await fetch(`${ATTEVIA_URL}/api/v1/runs`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.ATTEVIA_KEY!}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ thesis, currency: "USD" }),
  }).then((r) => r.json());

  // poll until complete (typical: 40–90s)
  while (true) {
    const r = await fetch(`${ATTEVIA_URL}/api/v1/runs?id=${start.id}`, {
      headers: { Authorization: `Bearer ${process.env.ATTEVIA_KEY!}` },
    }).then((r) => r.json());
    if (r.run?.status === "complete") return r.run;
    if (r.run?.status === "error") throw new Error("prime failed");
    await new Promise((s) => setTimeout(s, 4_000));
  }
}

Operational questions.