{"uid":"cap_fGOcurnNrORD8DUcKPEWt","slug":"grokbot-wallet-research-api-6ef96164","name":"GrokBot Wallet Research API","description":"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.","url":"https://grokbot-dashboard.a3migos.workers.dev/api/research?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":["string","null"]},"balance":{"type":"number"},"contract":{"type":"string"}}}},"address":{"type":"string"},"payment":{"type":"object","properties":{"payTo":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"price":{"type":"string"},"network":{"type":"string"}},"description":"Payment terms this response was paid with"},"product":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"version":{"type":"integer"},"balances":{"type":"object","properties":{"eth":{"type":"number"},"usdc":{"type":"number"},"ethUsd":{"type":["number","null"]},"usdcUsd":{"type":["number","null"]},"totalUsd":{"type":["number","null"]}}},"isContract":{"type":"boolean"},"generatedAt":{"type":"string","format":"date-time"},"recentActivity":{"type":["object","null"],"properties":{"ethIn":{"type":"number"},"ethOut":{"type":"number"},"latest":{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"asset":{"type":["string","null"]},"block":{"type":"integer"},"value":{"type":["number","null"]},"direction":{"enum":["in","out"],"type":"string"}}}},"source":{"type":"string"},"usdcIn":{"type":"number"},"window":{"enum":["1h","7d"],"type":"string"},"usdcOut":{"type":"number"},"transfers":{"type":"integer"},"truncated":{"type":"boolean"},"counterparties":{"type":"integer"}}}}}}}}},"responseSchema":{"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}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lfUUAR6SQhnrZesMfYws0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"DeFi due diligence on counterparty","prompt":"Before I send funds, can you research the Base address 0xABC1234567890abcdef1234567890abcdef123456 — I want to know its ETH and USDC balances in USD, whether it's a smart contract, and if it's been sending or receiving USDC recently?"},{"title":"Monitor suspicious wallet activity","prompt":"Check address 0xDEF9876543210fedcba9876543210fedcba987654 on Base for me — I want to see its current USDC balance, how many transactions it's made, and how many different counterparties it's been trading USDC with lately."},{"title":"Snapshot own wallet before a transaction","prompt":"Can you pull a live snapshot of my Base wallet 0x1111aaaa2222bbbb3333cccc4444dddd5555eeee — show me my ETH and USDC in USD terms, the current base fee gas cost, and my transaction count?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:41:55.092Z","isFirstParty":false,"canonicalSlug":"grokbot-wallet-research-api-6ef96164"}