NEMESIS API GATEWAY

Developer Documentation

GODMODE TERMINAL

# NEMESIS Enterprise API Documentation

## OmniChain Blockchain Intelligence & Digital Forensics Platform

**Version:** 2.0 Enterprise  
**API Gateway:** Cloudflare Workers Edge (`nemesis-api`)  
**Compute Engine:** FastAPI Intelligence Core  
**Transport:** HTTPS • WebSockets • HTTP/2 • HTTP/3  
**Architecture:** Edge-First • Multi-Cloud • Event-Driven • Zero-Trust

---

# Overview

The **NEMESIS Enterprise API** provides a unified interface for blockchain intelligence, digital forensics, cryptocurrency tracing, OSINT correlation, darknet intelligence, AI-assisted investigations, and cross-chain entity resolution.

The platform is composed of two major investigative modules:

* **NEMESIS Tracer Engine** — Multi-chain forensic tracing, graph analysis, and transaction intelligence.
* **NEMESIS ID Engine** — Universal entity intelligence, wallet profiling, behavioral analytics, attribution, and knowledge graph construction.

All client requests terminate at the **Cloudflare Edge API Gateway**, where authentication, authorization, caching, observability, telemetry, and request validation are enforced before secure proxying to the FastAPI Intelligence Engine.

---

# Base URLs

* **Production Engine:** `https://nemesis.lionsgate.network`
* **API Gateway Edge:** `https://api.nemesis.lionsgate.network/v1`
* **WebSockets Edge:** `wss://ws.nemesis.lionsgate.network`

---

# Authentication

The NEMESIS API utilizes Zero-Trust authentication architecture. Requests must be authenticated via Bearer tokens (JWT) or Service Account API Keys.

```http
Authorization: Bearer <token>
```
or
```http
X-Nemesis-API-Key: <api_key>
```

---

# Core Workflows

## Initiation

Investigations are initiated by generating a trace operation. A Trace ID is returned asynchronously.

```http
POST /api/trace
```
**Body:**
```json
{
  "address": "0x1234567890abcdef...",
  "chain": "ethereum",
  "max_depth": 3,
  "max_hops": 50
}
```

## Graph Analysis
```http
GET /api/graph/{trace_id}
```
Returns a fully constructed knowledge graph representation in D3.js compatible format for visualization.

## Deep Evidence Analysis
```http
POST /api/deep_evidence
```
Performs advanced forensic analysis using multiple intelligence providers and AI.

Capabilities include: ABI decoding, Contract analysis, Function signature identification, Transaction explanation, Cross-chain correlation, Risk scoring, Behavioral interpretation, AI-generated forensic narrative.

---

# NEMESIS ID Engine

The NEMESIS ID Engine constructs a unified digital identity for blockchain entities. It correlates:
Wallet addresses, Smart contracts, Exchanges, Bridges, Mixers, ENS domains, Darknet identities, OSINT artifacts, Investigation history.

## Search
```http
GET /api/nemesis_id/search
```
Supported query types: Nemesis ID, Wallet Address, Transaction Hash, Trace ID, ENS Domain, Entity Name.

---

# Wallet Intelligence

```http
GET /api/wallet_profile/{address}
```
Returns comprehensive wallet intelligence including: Native balance, Token balances, NFT holdings, Portfolio valuation, Chain activity, Labels, Risk score, Exchange exposure, AML indicators, Sanctions screening, Historical activity.

---

# Deep Blockchain Scraping

```http
GET /api/deep_scrape/{address}
```
Launches the Playwright Intelligence Engine for browser-based acquisition of blockchain explorer data. Collected data includes:
Complete transaction history, Internal transactions, ERC-20/721/1155 transfers, Contract interactions, Gas statistics, Address labels, Explorer metadata.

---

# Darknet Intelligence

```http
GET /api/darknet/search
```
Queries the NEMESIS Darknet Intelligence Repository. Searches include:
Onion services, Threat actor aliases, Cryptocurrency addresses, Email addresses, Usernames, Market listings, Data leaks, Credential dumps, Intelligence reports.

---

# Administrative APIs

Administrative endpoints expose operational capabilities including:

```http
POST /api/login
GET /admin/health
GET /admin/traces
GET /api/admin/cases
POST /api/admin/cases
GET /api/admin/db_stats
GET /api/admin/config
POST /api/admin/config
```

These endpoints require administrative authentication and are intended for internal operational use.

---

# Cloudflare Edge Services

The API is deployed behind Cloudflare Enterprise and integrates with:
Workers, KV, D1, R2, Durable Objects, Queues, Browser Rendering, AI Gateway, Analytics Engine, Zero Trust, WAF, API Shield, Rate Limiting, Smart Placement, Logpush, Observability, Vectorize (planned), Hyperdrive (planned).

NEMESIS API GATEWAY

NEMESIS ENGINE