{"uid":"cap_Xt62t2Lh0R-eAvae0EpYM","slug":"x402-endpoints-multi-hop-wallet-forensics-fdd6303d","name":"x402-endpoints Multi-Hop Wallet Forensics","description":"Multi-hop wallet forensics for AI agents: traverse an address's ERC-20 counterparty graph across 1-3 hops and get the flow graph (nodes + edges), ranked counterparties (direction, tokens, activity) and detected patterns — flow concentration, circular flows, linked/clustered wallets and high-degree hubs (exchange/mixer/deployer) — plus a signed receipt. Trace where funds move and who is connected. EVM chains.","url":"https://x402-endpoints.onrender.com/crypto/wallet-forensics","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["wallet"],"properties":{"chain":{"type":"string","description":"base | ethereum | optimism | polygon | arbitrum | gnosis (default base)"},"depth":{"type":"integer","description":"Graph hops to traverse: 1, 2 or 3 (default 2)"},"wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EVM wallet address (0x + 40 hex) to investigate"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":{"chain":"base","depth":2,"wallet":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"cached":false,"header":{"available":true,"risk_flags":[],"ofac_listed":false,"token_count":42,"portfolio_value_usd":5200000},"source":"EVM Blockscout ERC-20 transfer graph (multi-hop) + OFAC SDN list","reasons":[{"code":"HIGH_DEGREE_HUB","label":"1 counterparty shows hub-like activity.","weight":0.1}],"patterns":[{"detail":"1 counterparty shows hub-like activity.","weight":0.1,"pattern":"HIGH_DEGREE_HUB","examples":["0xabc..."],"severity":"info"}],"timestamp":"2026-07-02T12:00:00Z","disclaimer":"Best-effort flow forensics from a sampled ERC-20 transfer graph (fan-out and history capped). Heuristic roles. Not legal/financial advice.","graph_edges":[{"to":"0xabc...","hop":1,"from":"0xd8da...6045","degree":21},{"to":"0xdef...","hop":2,"from":"0xabc...","degree":8}],"graph_summary":{"edges_sampled":40,"nodes_sampled":61,"hops_traversed":2,"direct_counterparties":38,"total_direct_transfers":512},"data_freshness":{"as_of":"2026-07-02T12:00:00Z","chain":"base","depth":2,"sources":["EVM Blockscout ERC-20 transfer graph (multi-hop) + OFAC SDN list"],"age_seconds":0,"retrieved_at":"2026-07-02T12:00:00Z","deterministic":true,"fan_out_capped":true},"signed_receipt":{"claims":{"kind":"wallet_forensics","chain":"base","depth":2,"issuer":"x402-endpoints.onrender.com","wallet":"0xd8dA6BF...6045","patterns":["HIGH_DEGREE_HUB"],"issued_at":"2026-07-02T12:00:00Z","direct_counterparties":38},"algorithm":"ed25519","available":true,"signature":"<hex>","public_key":"5b77...9f9d"},"top_counterparties":[{"degree":21,"tokens":["USDC","WETH"],"address":"0xabc...","in_count":12,"direction":"bidirectional","out_count":9,"last_activity":"2026-07-01T10:00:00Z"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OtXY_kMoMUSL3kzvTfP8K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Traverses an EVM wallet's ERC-20 counterparty graph up to 3 hops to reveal fund flows, ranked counterparties, and behavioral patterns like circular flows, clustered wallets, and high-degree hubs.","exampleAgentPrompt":"Can you trace where funds have moved from wallet 0xAbCd1234...5678 on Ethereum — go 3 hops deep and show me the full counterparty graph, any circular flows, and whether it's connected to any exchanges or mixers?","exampleUseCases":null,"resultDescription":"A fund-flow graph (nodes + edges), a ranked list of counterparties with direction, tokens, and activity metrics, detected behavioral patterns (flow concentration, circular flows, linked/clustered wallets, high-degree hub classification as exchange/mixer/deployer), and a cryptographically signed receipt — all for ERC-20 transfers on the specified EVM chain.","failureModes":["Invalid wallet address format (must be 0x + 40 hex chars) returns validation error","Unsupported chain name returns error listing valid options","Depth value outside 1-3 returns validation error","Wallet has no ERC-20 transaction history returns empty graph","Payment not received or insufficient USDC returns 402 Payment Required","Render cold-start latency may cause timeout on first call","Rate limiting or provider downtime may return 503"],"whenToPreferThis":"Choose this endpoint when you need multi-hop counterparty graph traversal with pattern detection (circular flows, mixers, clustered wallets) rather than a simple single-hop balance or transfer list. It is specifically suited for AML investigations, due diligence on unknown wallets, or tracing suspicious fund movements across EVM chains including Base, Ethereum, Optimism, Polygon, Arbitrum, and Gnosis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:48:20.789Z","isFirstParty":false}