# Botsmith Onchain Address Intel

> Botsmith Onchain Address Intel is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns comprehensive on-chain intelligence for any EVM address including type, balance, scam flags, ENS name, transaction counts, and contract metadata across Base, Ethereum, and Optimism.

## Facts

- Endpoint: GET https://x402.botsmith.dev/onchain
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/botsmith-onchain-address-intel-1a76b195
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6mBcQbXvcgc7P8wBZ7guB

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 botsmith-onchain-address-intel-1a76b195
```

Example prompt: Before I interact with 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum, can you run an onchain intel check on it — tell me if it's a contract or wallet, whether it's flagged as a scam, its ENS name, and how active it is?

## When to prefer this

Use this endpoint when an AI agent needs to perform due-diligence on an unknown EVM address before interacting with it — especially when you need a single unified call covering type detection, balance, scam flags, ENS, activity metrics, and contract metadata across Base, Ethereum, or Optimism. Prefer this over separate block explorer queries when you need all signals in one low-cost ($0.004) call.

## Known failure modes

- Invalid address format (must be 0x-prefixed 40-hex-char address) returns validation error
- Unsupported chain value (must be base, ethereum, or optimism) returns error
- Address not found or no on-chain activity may return nulls for optional fields
- Payment failure or insufficient USDC balance blocks the call
- Rate limiting or upstream block explorer API downtime causes transient errors

## How this service works

Onchain Address Intel ($0.004/call): On-chain intel for any EVM address in one call: contract-or-wallet, native balance, scam/reputation flags, transaction and transfer counts, ENS name, and for contracts the verification status, name, proxy type and deployer. Base, Ethereum and Optimism. Ideal for agent due-diligence before interacting with an address.

## Output

A JSON object containing: address type (contract or EOA), native token balance, ENS name (or null), scam/reputation flags, transaction count, transfer count, and for contracts: verification status, contract name, proxy type, deployer address, creation tx, and token metadata (symbol, name, type).

## 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",
      "chain"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "optimism"
       ],
       "type": "string",
       "default": "base",
       "description": "Which chain to look up (default base)"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address to investigate"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "chain",
      "type",
      "nativeBalance",
      "ensName",
      "risk",
      "activity",
      "contract",
      "topTokens"
     ],
     "properties": {
      "risk": {
       "type": "object",
       "required": [
        "isScam",
        "reputation"
       ],
       "properties": {
        "isScam": {
         "type": "boolean",
         "description": "Flagged as a scam by the explorer"
        },
        "reputation": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": false
      },
      "type": {
       "enum": [
        "contract",
        "eoa"
       ],
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "address": {
       "type": "string"
      },
      "ensName": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "activity": {
       "type": "object",
       "required": [
        "txCount",
        "transferCount"
       ],
       "properties": {
        "txCount": {
         "anyOf": [
          {
           "type": "integer",
           "maximum": 9007199254740991,
           "minimum": -9007199254740991
          },
          {
        
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/botsmith-onchain-address-intel-1a76b195/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)