{"uid":"cap_k847QyTt4ogc6mr9EufZF","slug":"wallet-relations-4c321577","name":"Wallet Relations","description":"Use when an agent must see who an EVM wallet deals with: counterparties ranked by ERC-20 transfers, earliest inbound sender, wallets the same EOA funder also paid, tokens moved. Input: address, chain (base default, ethereum, arbitrum, monad), hours (1-24, Arbitrum 1-6, Monad 1-2; default 6), limit. Output: JSON counterparties with own labels (contract/EOA, known token), first and shared funder. ERC-20 only. Example: ?address=0x92256Af59E7B98f9f25e445A869b1170DE476c26","url":"https://1gateway.dev/v1/onchain/wallet-related?utm_source=zero.xyz","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":{"chain":{"enum":["base","ethereum","arbitrum","monad"],"type":"string","description":"EVM chain (default base)"},"hours":{"type":"integer","maximum":24,"minimum":1,"description":"Look-back in hours (default 6; max 24, Arbitrum max 6, Monad max 2 and default 2)"},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Counterparty rows (default 15)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet (or contract) on the chosen chain (example: Uniswap v3 WETH/USDC pool on Base, a busy contra…"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["chain","chainId","wallet","window","summary","firstFunderInWindow"],"properties":{"chain":{"type":"string"},"wallet":{"type":"object","additionalProperties":true},"window":{"type":"object","additionalProperties":true},"chainId":{"type":"integer"},"summary":{"type":"object","additionalProperties":true},"firstFunderInWindow":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p9ylg_UTeABrLlMQsuVIj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked ERC-20 counterparties for an EVM wallet, including first inbound sender, shared funders, and tokens moved, within a configurable lookback window.","exampleAgentPrompt":"Who has wallet 0xd0b53D9277642d899DF5C87A3966A349A798F224 been dealing with on Base over the last 6 hours — show me the top 15 counterparties by ERC-20 transfers, their labels, and whether they share the same funder?","exampleUseCases":[{"title":"Due diligence on a suspicious wallet","prompt":"Can you pull the top 20 counterparties for 0xAbc123...789 on Ethereum over the last 24 hours and tell me if any of them are known contracts, who first sent funds to this wallet, and whether any other wallets share the same original funder?"},{"title":"Token flow mapping for a DeFi address","prompt":"Map out the ERC-20 token relationships for this Base wallet 0xd0b53D9277642d899DF5C87A3966A349A798F224 — I want to see which tokens it's been moving, who the main counterparties are, and what their labels are, over the past 12 hours."},{"title":"Investigating shared funders on Arbitrum","prompt":"For wallet 0xFeed9...2211 on Arbitrum, look back 6 hours and tell me which other wallets were funded by the same original source — I'm trying to find coordinated activity."}],"resultDescription":"A JSON object containing: the queried wallet's metadata (address, nonce, isContract), the lookback window used, a summary of activity, the first inbound sender within the window, any shared funder EOA, an array of ranked counterparties (each with address, label, type, known token, and transfer count), an array of ERC-20 tokens moved (symbol, address, transfer count, known issuer), and RPC diagnostics.","failureModes":["Quiet wallet with no ERC-20 transfers returns empty counterparties array (not an error)","Invalid address format returns a validation error (must match ^0x[0-9a-fA-F]{40}$)","Hours exceeding chain maximum (e.g. >6 for Arbitrum, >2 for Monad) may be clamped or rejected","Unsupported chain value returns an enum validation error","Limit outside 1-50 range returns a validation error","Network or RPC timeout may cause intermittent failures for high-traffic contracts"],"whenToPreferThis":"Use this endpoint when an agent needs a relationship map of an EVM wallet — specifically who it has exchanged ERC-20 tokens with, ranked by volume, along with funder provenance and counterparty type labels. Prefer this over generic balance or transaction endpoints when the goal is counterparty intelligence, shared-funder detection, or mapping token flow relationships across Base, Ethereum, Arbitrum, or Monad chains within a short lookback window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T23:33:32.629Z","isFirstParty":false,"canonicalSlug":"wallet-relations-4c321577"}