{"uid":"cap_YUQmH62uCz67FQ-8GGTiF","slug":"limitguard-wallet-balance-check-bb002f22","name":"LimitGuard Wallet Balance Check","description":"ERC-8004 agent wallet balance check. Returns USDC balance and transaction count for AI agent wallets.","url":"https://limitguard.ai/v1/wallet/balance","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["agent_id"],"properties":{"agent_id":{"type":"string","description":"ERC-8004 agent identifier"}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}},"sandbox":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"curl":{"type":"string"},"note":{"type":"string"}}},"recovery":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"curl":{"type":"string"}}},"documentation_url":{"type":"string"}}},"responseSchema":{"example":{"balance_usdc":150.5,"transaction_count":42}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-0IIPIF1yKEyzUC_N7hmS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the USDC balance and transaction count for an ERC-8004 AI agent wallet by agent identifier.","exampleAgentPrompt":"What's the current USDC balance and transaction count for my AI agent with ID 'agent_abc123'?","exampleUseCases":[{"title":"Verify agent funds before payment","prompt":"Before my orchestrator agent sends payment to the fulfillment agent, can you check if agent ID 'agent_fulfill_99' has enough USDC to cover a $50 transaction?"},{"title":"Audit agent spending activity","prompt":"How many transactions has my trading agent 'agent_trade_7x' made so far, and what's its current USDC balance? I want to see if it's been too active."},{"title":"Check wallet before onboarding agent","prompt":"I'm about to onboard a new sub-agent with ID 'agent_ops_delta' into my workflow — can you quickly pull its USDC balance and transaction history so I know what I'm working with?"}],"resultDescription":"Returns a JSON object containing the agent wallet's USDC balance (e.g. 150.5 USDC) and the total number of transactions recorded for that agent (e.g. 42 transactions).","failureModes":["Unknown or invalid agent_id returns 404 or empty result","Agent wallet not yet registered on ERC-8004 returns error","Insufficient payment (x402) blocks the request","Network or upstream blockchain read errors return 5xx","Malformed agent_id format returns 400 validation error"],"whenToPreferThis":"Use this endpoint when you need to programmatically check the USDC balance or transaction activity of a specific ERC-8004-compliant AI agent wallet — especially before authorizing inter-agent payments or verifying an agent has sufficient funds. Prefer this over general blockchain explorers when you need structured, agent-identity-aware data in a single fast call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:41.421Z","isFirstParty":false}