NEMESIS API Reference

REST API Reference

The Nemesis Analysis Fusion Engine operates on a multi-threaded Cloudflare Worker infrastructure. It exposes endpoints for mass transaction ingestion, browser-based OSINT scraping, AI forensic analysis, and Durable Object state synchronization.

POST /api/trace/batch

Offloads mass-sweep graph processing to the worker. Automatically performs Entity labeling, exchange terminal detection, and USD valuation before returning fully hydrated Vis.js compatible graph edges.

Request Payload

{
  "edges": [
    {
      "from": "bc1q...",
      "to": "1A1z...",
      "amount": 1.25,
      "txid": "a1b2...",
      "timestamp": 1698765432
    }
  ],
  "chain": "bitcoin"
}

Response Payload

{
  "success": true,
  "processed": 1,
  "hydratedEdges": [
    {
      "id": "bc1q..._1A1z...",
      "from": "bc1q...",
      "to": "1A1z...",
      "amount": 1.25,
      "value_usd": 75000.50,
      "entity_name": "Binance",
      "entity_class": "EXCHANGE"
    }
  ]
}

POST /api/scrape-entity

Leverages Cloudflare Browser Rendering (env.BROWSER.quickAction) to dynamically execute a headless browser, navigate to OKLink, bypass anti-bot challenges, and extract verified entity intelligence using raw XPath queries.

Request Payload

{
  "address": "bc1qq85v2c926eg6pgxhwp6q7lf6cnsz80qs3fcu9r",
  "chain": "bitcoin"
}

Response Payload

{
  "success": true,
  "entity_label": "Hack",
  "risk_tag": "HIGH-RISK",
  "chain": "bitcoin",
  "raw": { "..." }
}

POST /api/llm/analyze-tx

Injects massive graph contexts into the Nemesis PRO military-grade AI model. Forces the model to evaluate the transaction graph, assign risk profiles, and output actionable end-point vectors in strict JSON schema.

Request Payload

{
  "prompt": "[DUMP OF TRACING GRAPH EDGES AND LOGS]"
}

Response Payload

{
  "level1_category": "EXCHANGE",
  "sub_entity": "Binance",
  "aml_risk_tag": "CRITICAL-RISK",
  "confidence_score": "High",
  "nexus_classification": "Confirmed",
  "actionable_endpoints": ["Binance KYC Department"],
  "evidentiary_proof": "Victim funds successfully traced 4 hops deep directly into a known Binance hot wallet cluster."
}

POST /api/queue/dispatch

Offloads long-running, intense tracing sweeps directly into the Cloudflare Pipeline Queue system, bypassing Cloudflare worker execution timeouts for background resolution.

Request Payload

{
  "trace_id": "trace_ab12_...",
  "target_address": "bc1q...",
  "depth": 10
}

POST /api/upload-json POST /api/upload-image

Puts JSON State dumps or raw PNG graph screenshots straight into the Cloudflare R2 bucket for permanent forensic archive retention.