# Sleuth AI On-Chain Investigation API

> Sleuth AI On-Chain Investigation API is a paid API for AI agents from x402.sleuthagent.ai, paid per call via x402, $0.099/call, status unknown (last checked 2026-09-15).

Runs AI-powered on-chain blockchain investigations tracing wallet flows, token holders, and transaction paths, paid per-call via x402 USDC on Base.

## Facts

- Endpoint: POST https://x402.sleuthagent.ai/api/v1/run-investigation
- Price: $0.099/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sleuth-ai-on-chain-investigation-api-04791c6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DTbRqOGgPUKDZX_dofv2P

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sleuth-ai-on-chain-investigation-api-04791c6f -d '<json body>'
```

Example prompt: Can you investigate where the funds from wallet 0xabc123… went? I want to know how many hops it took and where the money ended up — trace it all the way to any exchange deposits.

## When to prefer this

Choose this endpoint when you need AI-driven, multi-hop on-chain investigation with natural language narrative output — especially for tracing illicit fund flows, analyzing token holder concentration, or following complex DeFi transaction paths. Prefer this over generic blockchain explorers when you need synthesized analysis rather than raw transaction data, and when pay-per-call pricing (no subscription) is acceptable.

## Known failure modes

- Insufficient USDC balance or failed x402 payment causes request rejection before investigation runs
- Wallet address not found or not indexed on supported chains returns empty nodes
- Complex multi-hop traces may time out for very deep transaction graphs
- Unsupported chain or token type may return no data
- Malformed or invalid address input returns an error response

## How this service works

Pay-per-call on-chain investigation API (x402, USDC on Base).

## Output

Returns a structured JSON response containing a natural-language narrative summary of the investigation (e.g. hop-by-hop trace), plus a nodes array with tabular data rows such as top holders (wallet address, balance, % of supply), the tool used, column names, row counts, and a unique request_id for the call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "auto",
    "base",
    "ethereum",
    "arbitrum",
    "polygon",
    "bsc",
    "robinhood",
    "solana",
    "bnb",
    "robinhoodchain"
   ],
   "type": "string",
   "default": "auto"
  },
  "query": {
   "type": "string",
   "maxLength": 2000,
   "minLength": 1
  },
  "conversation_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "nodes": [
    {
     "id": "base_sleuth:obs0",
     "rows": [
      [
       "0x1111111111111111111111111111111111111111",
       "12,400,000",
       "41.2%"
      ],
      [
       "0x2222222222222222222222222222222222222222",
       "6,900,000",
       "22.9%"
      ]
     ],
     "tool": "data_miner",
     "title": "Top holders",
     "columns": [
      "wallet",
      "balance",
      "pct_supply"
     ],
     "summary": "Largest current holders by balance.",
     "row_count": 2,
     "truncated": false
    }
   ]
  },
  "response": "The $2M left 0xabc… in three hops, ending at a Binance deposit…",
  "request_id": "req_9f8e7d6c5b4a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sleuth-ai-on-chain-investigation-api-04791c6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.sleuthagent.ai](https://www.zero.xyz/host/x402.sleuthagent.ai/llms.txt)