# Gapup Crypto Wallet Intelligence

> Gapup Crypto Wallet Intelligence is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Analyzes EVM wallet addresses across multiple chains to produce profiles, token flows, P&L estimates, counterparty graphs, and DeFi position snapshots.

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/crypto_wallet_intel
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-crypto-wallet-intelligence-1ec86e22
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_97RuewIKvWjPWAHXibtpB

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 gapup-crypto-wallet-intelligence-1ec86e22 -d '<json body>'
```

Example prompt: Give me a full wallet profile for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — including their persona, any sanctions flags, and their DeFi positions on Aave and Uniswap — looking back 60 days.

## When to prefer this

Use this endpoint when you need detailed on-chain intelligence about an EVM wallet — including sanctions screening, DeFi exposure, token-level cash flows, or counterparty network mapping — across Ethereum, Base, Polygon, BSC, Arbitrum, or Optimism. Prefer it over generic block explorers when structured, USD-denominated, multi-chain analysis is needed in a single call. For multi-chain scans or large lookback windows, use async mode to avoid timeouts.

## Known failure modes

- Invalid wallet address format (not 0x + 40 hex chars) → validation error
- Unsupported chain value → enum validation failure
- period_days out of range (>365 or <1) → parameter error
- Wallet has no activity on the requested chain → empty result set
- Chain 'all' scan timing out → use async:true with job polling
- Insufficient balance or expired API key → 402 / 401 error
- Backend indexer lag for very recent transactions → incomplete data

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

Returns a JSON object keyed by the requested analysis mode: wallet_profile includes persona classification and sanctions flag; token_flows lists ERC-20 inflows/outflows priced in USD; pnl_estimate provides FIFO realized and unrealized gains with a confidence score; counterparties lists the top 20 addresses by volume; defi_positions enumerates active positions on major protocols. All results are scoped to the specified chain and lookback period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "wallet_profile",
    "token_flows",
    "pnl_estimate",
    "counterparties",
    "defi_positions"
   ],
   "type": "string",
   "description": "Analysis mode. wallet_profile=full wallet summary + persona + sanctions flag. token_flows=ERC-20 inflows/outflows per token priced in USD. pnl_estimate=FIFO realized+unrealized P&L with confidence. counterparties=top 20 counterparties by volume. defi_positions=active positions on Aave/Compound/Uniswap/Curve/Lido/etc."
  },
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "polygon",
    "bsc",
    "arbitrum",
    "optimism",
    "all"
   ],
   "type": "string",
   "description": "Chain to analyze. Default \"ethereum\". Use \"all\" to scan all 6 chains (slower, ~30s)."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "EVM-compatible wallet address (0x... 40 hex chars). Works on all supported chains."
  },
  "period_days": {
   "type": "number",
   "maximum": 365,
   "minimum": 1,
   "description": "Lookback window in days for token_flows, pnl_estimate, counterparties, defi_positions. Default 30."
  },
  "min_value_usd": {
   "type": "number",
   "minimum": 0,
   "description": "Minimum USD value filter for token_flows and counterparties. Default $100."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "crypto_wallet_intel",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-crypto-wallet-intelligence-1ec86e22/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)
