# Wallet Relations

> Wallet Relations is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-19).

Returns ranked ERC-20 counterparties for an EVM wallet, including first inbound sender, shared funders, and tokens moved, within a configurable lookback window.

## Facts

- Endpoint: GET https://1gateway.dev/v1/onchain/wallet-related?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wallet-relations-4c321577
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k847QyTt4ogc6mr9EufZF

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 wallet-relations-4c321577
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wallet-relations-4c321577/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)
