# GrokBot Wallet Research API

> GrokBot Wallet Research API is a paid API for AI agents from grokbot-dashboard.a3migos.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Fetches live on-chain data for a Base mainnet address including ETH/USDC balances with USD quotes, gas info, nonce, contract detection, and recent USDC transfer activity

## Facts

- Endpoint: GET https://grokbot-dashboard.a3migos.workers.dev/api/research?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/grokbot-wallet-research-api-6ef96164
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fGOcurnNrORD8DUcKPEWt

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 grokbot-wallet-research-api-6ef96164
```

Example prompt: Can you look up the wallet 0x3687c765a3e56d4c2cf5edc71456946fbea8c9ce on Base mainnet and tell me its ETH and USDC balances in USD, the current nonce, whether it's a contract, and any recent USDC activity in the last hour?

## When to prefer this

Choose this endpoint when you need a comprehensive, real-time on-chain snapshot of any Base mainnet address in a single call — covering balances, USD values, gas, nonce, contract detection, and recent USDC flows. Prefer it over general block explorers when you need structured JSON output suitable for agent pipelines. Best for due diligence, monitoring, or pre-transaction checks on Base addresses. Not suitable for historical data, non-Base chains, or tokens other than ETH and USDC.

## Known failure modes

- 400 error returned for invalid address format (non-0x or wrong length), payment is NOT settled in this case
- RPC or CoinGecko unavailability may cause errors or null fields for gas/market data
- Stale or delayed block data if Base RPC is lagging
- USDC log window limited to 1 hour — no historical data beyond that
- Payment required (x402, $0.01 USDC on Base) before data is returned; missing payment results in 402

## How this service works

Base wallet research API: for any Base mainnet address returns ETH and USDC balances with USD values (CoinGecko/Coinbase quotes), EOA vs smart contract, nonce (tx count), current gas base fee, ERC-20 token holdings, and recent USDC inflows/outflows with a counterparty count. Read live from public Base RPCs at request time. Paid per call with x402 (USDC on Base); invalid input returns 400 and is not charged. Data only, not financial advice.

## Output

Returns a JSON object with the queried address, current Base block number, chain info (id 8453), ETH and USDC balances with USD equivalents and total USD value (via CoinGecko), current base-fee gas data, nonce (total tx count), a boolean indicating if the address is a contract, and a recent 1-hour window of USDC transfer activity including inflow/outflow amounts and unique counterparty count. Data is sourced live from public Base RPC and free market data at request time.

## 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",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Base mainnet address to research"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "product",
      "address",
      "block",
      "balances",
      "version"
     ],
     "properties": {
      "gas": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "baseFeeWei": {
         "type": [
          "string",
          "null"
         ]
        },
        "baseFeeGwei": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      },
      "block": {
       "type": "integer"
      },
      "chain": {
       "type": "object",
       "properties": {
        "id": {
         "type": "integer"
        },
        "name": {
         "type": "string"
        }
       }
      },
      "nonce": {
       "type": "integer"
      },
      "notes": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "market": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "ethUsd": {
         "type": [
          "number",
          "null"
         ]
        },
        "source": {
         "type": [
          "string",
          "null"
         ]
        },
        "fetchedAt": {
         "type": [
          "string",
          "null"
         ]
        },
        "ethUsd24hChange": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      },
      "tokens": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "name": {
          "type": [
           "string",
           "null"
          ]
         },
         "symbol": {
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "block": 52796144,
  "chain": {
   "id": 8453,
   "name": "Base mainnet"
  },
  "nonce": 0,
  "address": "0x3687c765a3e56d4c2cf5edc71456946fbea8c9ce",
  "product": "grokbot.wallet-summary",
  "sources": [
   "eth_getBalance",
   "eth_getTransactionCount",
   "eth_getCode",
   "USDC.balanceOf",
   "eth_getLogs"
  ],
  "version": 1,
  "balances": {
   "eth": 0,
   "usdc": 5.88
  },
  "isContract": false,
  "recentActivity": {
   "source": "eth_getLogs",
   "usdcIn": 0,
   "window": "1h",
   "usdcOut": 0,
   "transfers": 0,
   "counterparties": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grokbot-wallet-research-api-6ef96164/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grokbot-dashboard.a3migos.workers.dev](https://www.zero.xyz/host/grokbot-dashboard.a3migos.workers.dev/llms.txt)