# Base Address Profile & Onchain Intelligence Lookup

> Base Address Profile & Onchain Intelligence Lookup is a paid API for AI agents from x402-data-api.bodhinindustries.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Profiles a Base chain address (EOA or contract) returning ETH/USDC/WETH balances, nonce, contract type flags, ERC-20/721 detection, and proxy implementation — all computed live from raw chain data.

## Facts

- Endpoint: GET https://x402-data-api.bodhinindustries.workers.dev/address
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-address-profile-onchain-intelligence-lookup-37a48159
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ck1_cFHfzzgxswqTFQw3f

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 base-address-profile-onchain-intelligence-lookup-37a48159
```

Example prompt: Can you profile the Base address 0x4200000000000000000000000000000000000006 — tell me its ETH balance, whether it's a contract or EOA, if it's an ERC-20, its USDC holdings, and whether it's ever been used, using the latest block?

## When to prefer this

Use this endpoint when you need authoritative, first-party onchain data about a Base address without relying on third-party indexers or APIs. Ideal for wallet due diligence, contract type detection, token holding verification, or building onchain intelligence pipelines. Prefer over Etherscan or similar services when you need guaranteed freshness, no API-key dependency, and raw chain-computed results at a specific block height.

## Known failure modes

- Invalid or malformed address returns an error response
- Non-existent or zero-activity address returns everUsed: false with zero balances
- Invalid block number returns an error or falls back to latest
- Rate limiting or payment failure returns HTTP 402 (x402 payment required)
- Network or RPC issues may cause timeouts on live chain reads

## How this service works

Self-computed Base onchain toolkit for AI agents: ERC-20 safety scan, manipulation-resistant TWAP price oracle, gas/fee oracle, calldata decoder, token/address/contract intel, wallet approval-risk audit, and batch token triage — all computed live from raw Base chain, no third-party data.

## Output

Returns a JSON object with the address's ETH balance (in wei and decimal ETH), USDC and WETH token balances, transaction nonce, whether it's an EOA or contract, ERC-20/ERC-721 interface detection, proxy implementation address, bytecode size and code hash, activity flags (e.g. active, holds_usdc, unused), and the Base block height at which the snapshot was taken. All data is computed directly from the Base chain — no third-party data sources used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "block": {
   "type": "string",
   "description": "'latest' (default) or a decimal block number for a point-in-time snapshot."
  },
  "address": {
   "type": "string",
   "description": "Base address to profile (EOA or contract)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "eth": {
   "type": "object",
   "properties": {
    "wei": {
     "type": "string",
     "description": "balance in wei"
    },
    "balance": {
     "type": "string",
     "description": "balance in ETH (decimal string)"
    }
   }
  },
  "type": {
   "type": "string",
   "description": "eoa | contract"
  },
  "block": {
   "type": "integer",
   "description": "Base block height"
  },
  "flags": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "e.g. eoa, contract, active, unused, holds_usdc"
  },
  "nonce": {
   "type": "integer",
   "description": "eth_getTransactionCount (txs sent from address)"
  },
  "address": {
   "type": "string",
   "description": "address profiled"
  },
  "balances": {
   "type": "object",
   "properties": {
    "usdc": {
     "type": "number",
     "description": "USDC held"
    },
    "weth": {
     "type": "number",
     "description": "WETH held"
    }
   }
  },
  "contract": {
   "type": "object",
   "properties": {
    "isErc20": {
     "type": "boolean",
     "description": "ERC-20 interface"
    },
    "codeHash": {
     "type": "string",
     "description": "keccak256"
    },
    "codeSize": {
     "type": "integer",
     "description": "bytecode size"
    },
    "isErc721": {
     "type": "boolean",
     "description": "ERC-721 interface"
    },
    "proxyImplementation": {
     "type": "string",
     "description": "EIP-1167 impl or null"
    }
   }
  },
  "everUsed": {
   "type": "boolean",
   "description": "nonce>0 or contract or holds value"
  },
  "computedAt": {
   "type": "string",
   "description": "ISO-8601 timestamp"
  },
  "isContract": {
   "type": "boolean",
   "description": "has bytecode"
  },
  "thirdPartyDataUsed": {
   "type": "boolean",
   "description": "always false"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-address-profile-onchain-intelligence-lookup-37a48159/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api.bodhinindustries.workers.dev](https://www.zero.xyz/host/x402-data-api.bodhinindustries.workers.dev/llms.txt)