# Grizzly Base Address Research Tool

> Grizzly Base Address Research Tool is a paid API for AI agents from grizzly-x402.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Looks up on-chain data for a Base blockchain address, returning wallet balances, transaction activity, contract metadata, token info, and risk flags.

## Facts

- Endpoint: GET https://grizzly-x402.onrender.com/base/research?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/grizzly-base-address-research-tool-4fedabac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7OHfF5JbQ_aYHpZqidN1n

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 grizzly-base-address-research-tool-4fedabac
```

Example prompt: Can you research the Base address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and tell me if it's a wallet or contract, what its balances are, and whether there are any risk flags?

## When to prefer this

Choose this endpoint when you need a quick, cheap ($0.01 USDC) on-chain profile of any Base network address — especially when you want wallet vs. contract classification, token balances, USDC transfer history, and contract risk flags in a single call. Prefer it over general blockchain explorers when operating in an autonomous agent context with x402 micropayment support on Base.

## Known failure modes

- Missing or invalid 'address' query parameter returns an error
- Non-Base or malformed 0x address may return empty or error response
- Payment failure via x402 protocol results in 402 response and no data
- Address with no on-chain history may return empty balances and zero counts
- Service downtime on render.com host may cause 503 errors

## How this service works

Pay-per-call data tools for agents, paid in USDC on Base via x402.

## Output

Returns a JSON object containing: the address kind (wallet or contract), current block number, chain identifier (base), ETH and token balances, total transaction count, USDC transfer history within the last 10,000 blocks, token metadata (symbol, risk flags like 'upgradeable_proxy'), and a disclaimer that the data is informational only.

## 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": {
      "address": {
       "type": "string",
       "description": "0x address on Base (wallet or contract)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "kind": {
       "type": "string"
      },
      "block": {
       "type": "integer"
      },
      "chain": {
       "type": "string"
      },
      "token": {
       "type": [
        "object",
        "null"
       ]
      },
      "wallet": {
       "type": "object"
      },
      "address": {
       "type": "string"
      },
      "activity": {
       "type": "object"
      },
      "disclaimer": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "contract",
  "block": 36000000,
  "chain": "base",
  "token": {
   "symbol": "USDC",
   "risk_flags": [
    "upgradeable_proxy"
   ]
  },
  "wallet": {
   "eth": "0",
   "tokens": {
    "USDC": "0"
   },
   "txCount": 1,
   "isContract": true
  },
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "activity": {
   "ethTxCount": 1,
   "windowBlocks": 10000,
   "usdcTransfers": []
  },
  "disclaimer": "Informational only"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grizzly-base-address-research-tool-4fedabac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grizzly-x402.onrender.com](https://www.zero.xyz/host/grizzly-x402.onrender.com/llms.txt)
