Bankr X402 Sdk Balance Queries
- 402 installs
- 80 repo stars
- Updated March 24, 2026
- bankrbot/claude-plugins
bankr x402 sdk - balance queries is a Claude skill that documents multi-chain wallet balance, portfolio USD, and NFT holding queries via @bankr/sdk natural-language prompts for developers who need agents to verify funds
About
bankr x402 sdk - balance queries is a BankrBot Claude skill (version 1.1.0) for querying multi-chain token balances, portfolio USD valuations, and NFT holdings through the @bankr/sdk TypeScript client. Developers send natural-language prompts to BankrClient.promptAndWait—such as "How much USDC do I have?" or "Show my balances across all chains"—and receive wallet inventory responses without signing on-chain transactions. The skill documents eight query operation types spanning single-token checks, per-chain token lists, multi-chain aggregates, USD conversions, and NFT floor-price lookups across Base, Ethereum, Polygon, and Solana. Balance queries are read-only and fastest on a single chain; multi-chain and NFT floor-price calls may take longer. Reach for this skill when building payment-gating agents, portfolio dashboards, or pre-flight balance checks that prevent insufficient-fund failures before swaps or transfers.
- x402 SDK balance endpoints
- Pre-payment funds checks
- Agent-safe balance formatting
- Error handling for stale reads
Bankr X402 Sdk Balance Queries by the numbers
- 402 all-time installs (skills.sh)
- Ranked #1,079 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/bankrbot/claude-plugins --skill bankr-x402-sdk---balance-queriesAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 402 |
|---|---|
| repo stars | ★ 80 |
| Last updated | March 24, 2026 |
| Repository | bankrbot/claude-plugins ↗ |
How do you query multi-chain wallet balances with Bankr SDK?
Query wallet and account balances through the Bankr x402 SDK so agents can gate payments, show funds, and avoid insufficient-balance failures.
Who is it for?
Developers integrating @bankr/sdk agents that must display wallet funds or verify USDC before x402 micropayments.
Skip if: Developers executing token swaps or transfers who need transaction-building skills instead of read-only balance lookups.
When should I use this skill?
User asks about wallet balances, portfolio value, token holdings, NFT collections, or insufficient funds with Bankr SDK.
What you get
Natural-language balance responses, portfolio USD valuations, NFT holding summaries, and TypeScript BankrClient integration snippets.
- BankrClient balance query snippets
- Multi-chain prompt pattern reference
- Portfolio and NFT query examples
By the numbers
- Skill version 1.1.0 documents 8 balance query operation types
- Supports 4 chains: Base, Ethereum, Polygon, and Solana
Files
Safety & Access Control
Comprehensive safety guidance for using the Bankr API and CLI.
API Key Types
Bankr uses a single key format (bk_...) with capability flags:
| Flag | Controls | Default |
|---|---|---|
agentApiEnabled | /agent/* endpoints | false |
llmGatewayEnabled | LLM Gateway at llm.bankr.bot | false |
readOnly | Restricts agent to read-only tools | false |
Manage flags at bankr.bot/api.
Read-Only API Keys
When readOnly: true, all write tools are filtered from the agent session:
Allowed: Balances, prices, analytics, portfolio, research Blocked: Swaps, transfers, NFT purchases, staking, orders, token launches, leverage, Polymarket bets, claims
The /agent/sign and /agent/submit endpoints return 403 for read-only keys.
IP Whitelisting
Set allowedIps on your API key to restrict usage to specific IPs. Requests from non-whitelisted IPs are rejected with 403.
- Empty array = all IPs allowed (default)
- Non-empty array = only listed IPs can use the key
Dedicated Agent Wallet
When building autonomous agents, create a separate Bankr account rather than using your personal wallet:
- Limited exposure — compromised key only exposes agent wallet funds
- Clear accounting — agent transactions isolated from personal activity
- Independent controls — apply stricter access controls without affecting personal use
- Easy revocation — disable agent account without disrupting primary wallet
Recommended Funding
| Chain | Gas Buffer | Trading Capital |
|---|---|---|
| Base | 0.01-0.05 ETH | As needed |
| Polygon | 5-10 MATIC | As needed |
| Ethereum | 0.05-0.1 ETH | As needed |
| Solana | 0.1-0.5 SOL | As needed |
Rate Limits
| Tier | Daily Limit |
|---|---|
| Standard | 100 messages/day |
| Bankr Club | 1,000 messages/day |
| Custom | Set per API key |
Reset window is 24 hours from first message (rolling), not midnight.
Key Management
- Store keys in environment variables (
BANKR_API_KEY,BANKR_LLM_KEY), never in source code - Add
~/.bankr/and.envto.gitignore - Rotate keys periodically at bankr.bot/api
- Revoke immediately if compromised
- Use separate keys for Agent API vs LLM Gateway if needed
Transaction Safety
- Test first — small amounts on Base/Polygon before scaling
- Verify recipients — double-check addresses before transfers
- Gas buffer — keep enough native tokens for gas
- Immediate execution —
/agent/submitexecutes with no confirmation prompt - Understand calldata — verify trusted source for arbitrary transactions
Pre-Deployment Checklist
- Use a dedicated agent wallet, not your personal account
- Fund with limited amounts appropriate to purpose
- Set read-only if agent only queries data
- Configure IP whitelisting for server-side agents
- Store keys in environment variables
- Test with small amounts first
- Implement error handling for rate limits (429) and access control (403)
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k
Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198kHow it compares
Pick balance queries for read-only wallet inventories; use bankr x402 sdk token swaps or transaction builder skills when prompts must return signable transactions.
FAQ
Which chains does Bankr balance queries support?
bankr x402 sdk - balance queries documents four supported chains: Base (default, fastest), Ethereum, Polygon, and Solana. Specify the chain in prompts with phrases like "on Base" or "on Ethereum" for targeted lookups.
Do Bankr balance queries create on-chain transactions?
bankr x402 sdk - balance queries are read-only lookups via BankrClient.promptAndWait. Balance and portfolio prompts return natural-language responses without transaction metadata arrays that require wallet signing.
What balance query types does the skill cover?
bankr x402 sdk - balance queries documents eight operation types: single-token balance, multi-token balance, all tokens on a chain, multi-chain balances, portfolio USD value, single-token USD value, NFT holdings, and NFT floor prices.