{"uid":"cap_7_zXx07DopFrHtgN0aWvi","slug":"api-x402node-dev-5a67f7e4","name":"USDC Counterparty Graph on Base","description":"USDC counterparty graph on Base: POST an address, maps who it sends/receives USDC to/from over N days (hop 1), optionally expands the top counterparties one more hop (hop 2) to reveal clusters and indirect links. Returns labeled nodes (CEX, DEX, bridge, sanctioned/mixer/scam) and weighted edges (tx count, USDC volume). For AI agent due diligence, AML graph analysis, sybil/cluster detection and source-of-funds mapping. Not financial advice.","url":"https://api.x402node.dev/wallet/counterparty-graph","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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"days":{"type":"string","description":"Days (optional)"},"hops":{"type":"string","description":"Hops (optional)"},"address":{"type":"string","description":"EVM/chain address (required)"},"toAddress":{"type":"string","description":"ToAddress (optional)"},"fromAddress":{"type":"string","description":"FromAddress (optional)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"days":30,"hops":2,"address":"0x1234567890123456789012345678901234567890"},"response":{"hops":2,"meta":{"note":"USDC transfer counterparty graph (last N days). Nodes capped at 60, edges at 100; hub addresses (CEX/bridge/DEX) are not hop-2 expanded. labeled:false = not in curated label set, not a clean signal. Absence of red flags is not proof of safety. Not financial advice.","chain":"base","source":"x402node.dev","rpc_calls":2},"root":"0x1234567890123456789012345678901234567890","_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","edges":[],"nodes":[{"tag":null,"name":null,"in_usd":0,"address":"0x1234567890123456789012345678901234567890","is_root":true,"labeled":false,"out_usd":0,"category":null,"in_count":0,"out_count":0,"total_usd":0,"total_count":0}],"flagged":[],"red_flags":[],"edge_count":0,"node_count":1,"window_days":30,"hop2_expanded":[],"labeled_count":0}},"exampleRequest":{"days":30,"hops":2,"address":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hrlvn9ZRVuyIuYFlpSHLu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Maps the on-chain USDC send/receive counterparty network for a Base address over N days, with up to 2 hops, returning labeled nodes and weighted edges for AML, sybil, and due diligence analysis.","exampleAgentPrompt":"Can you pull the USDC counterparty graph for Base address 0xAbc123...def over the last 30 days, expanding two hops so I can see indirect links and flag any sanctioned or mixer-connected wallets?","exampleUseCases":null,"resultDescription":"A graph object with labeled nodes (tagged as CEX, DEX, bridge, sanctioned, mixer, scam, or unlabeled) and weighted directed edges representing USDC flows (transaction count and total USDC volume) between the queried address and its counterparties up to 2 hops away, enabling cluster detection and source-of-funds tracing.","failureModes":["Invalid or malformed Base address returns an error","Lookback window too large may result in timeout or truncated results","Address with no USDC activity returns an empty graph","Payment failure (x402) results in 402 response and no data","Hop 2 expansion on highly active addresses may be slow or rate-limited"],"whenToPreferThis":"Use this endpoint when you need on-chain USDC relationship mapping specifically on Base L2, especially for AML screening, due diligence, sybil cluster detection, or source-of-funds tracing. Prefer this over generic block explorers when you need structured graph output with risk labels and weighted edge data ready for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:44:04.778Z","isFirstParty":false}