# OBOL Bitcoin Address Forensics (x402)

> OBOL Bitcoin Address Forensics (x402) is a paid API for AI agents from obol-x402.fly.dev, paid per call via x402, $0.1/call, status down (last checked 2026-09-16).

Returns Bitcoin address forensics including money-graph role, whale/exchange fingerprinting, Satoshi-era provenance, and anomaly detection — Ed25519-signed, paid per-call via USDC on Base.

## Facts

- Endpoint: GET https://obol-x402.fly.dev/v1/btc/address/%7Baddress%7D
- Price: $0.1/call
- Payment: x402
- Status: down
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/obol-bitcoin-address-forensics-x402-abc325d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YlmetgGUMY3YpIJagZ1mn

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 obol-bitcoin-address-forensics-x402-abc325d2
```

Example prompt: Can you run a full Bitcoin forensic analysis on address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh — I want to know its money-graph role, whether it's linked to a whale or exchange, and if it has any Satoshi-era provenance?

## When to prefer this

Choose this endpoint when you need deep Bitcoin-specific forensic intelligence unavailable from standard RPC nodes — especially money-graph role classification, whale/exchange fingerprinting, Satoshi-era provenance, or broadcast-fee timing anomalies. It is uniquely suited for agents operating custody, compliance, or trading workflows that require signed, independently verifiable verdicts on BTC addresses before taking action.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error response
- Payment not received or insufficient USDC balance results in 402 Payment Required
- Address with no on-chain history may return limited or null forensic signals
- Network latency or upstream node issues may cause delayed or failed responses
- Non-Bitcoin addresses (EVM, etc.) submitted to this endpoint will fail — use sibling EVM endpoints instead

## How this service works

Pre-trade safety for AI agents on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB and Robinhood Chain. Is this token a rug — and can I sell it again? Signed verdicts before you buy, approve, send or sign: token rug/honeypot check with buy-sell tax, honeypot sell-simulation, pre-sign calldata guard (unlimited-approve / setApprovalForAll / drain-in-multicall), wallet risk with sanctions screening, tx preflight, and a launch feed with safety overlays. Plus unique Bitcoin forensics no RPC gives you: money-graph role, whale and exchange fingerprinting, Satoshi-era provenance, validation-gated block anomalies, and broadcast-fee timing. Every response Ed25519-signed and independently verifiable. Pay-per-call USDC on Base — no keys, no accounts, no signup. Free: /catalog, /llms.txt, and a preview for every paid SKU.

## Output

A JSON object containing Bitcoin address forensic signals: money-graph role classification, whale and exchange fingerprints, Satoshi-era provenance flags, validation-gated block anomalies, broadcast-fee timing analysis, an as_of timestamp, and an Ed25519 signature for independent verification. The ok field indicates request success.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "as_of": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/obol-bitcoin-address-forensics-x402-abc325d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from obol-x402.fly.dev](https://www.zero.xyz/host/obol-x402.fly.dev/llms.txt)