playbooks

home / skills / bankrbot / claude-plugins / sdk-balance-queries

sdk-balance-queries skill

/x402-sdk-dev/skills/sdk-balance-queries

This skill helps you query multi-chain token balances and portfolio values using Bankr SDK, returning wallet contents and NFT holdings.

npx playbooks add skill bankrbot/claude-plugins --skill sdk-balance-queries

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.6 KB
---
name: Bankr x402 SDK - Balance Queries
description: This skill should be used when the user asks "what are my balances", "how much ETH do I have", "check my wallet", "show my tokens", "portfolio value", "what tokens do I own", "NFT holdings", "how much USDC", "get token balances", "wallet contents", or any question about token balances, wallet contents, portfolio values, or NFT holdings across chains using the Bankr SDK.
version: 1.1.0
---

# SDK Balance Queries

Query multi-chain token balances and portfolio data using natural language prompts.

## Operations

| Operation | Example Prompt | Notes |
|-----------|----------------|-------|
| Single token balance | "How much USDC do I have?" | Fastest query type |
| Multi-token balance | "Show my ETH, USDC, and DEGEN balances" | Single chain |
| All tokens on chain | "What tokens do I have on Base?" | Lists all holdings |
| Multi-chain balances | "Show my balances across all chains" | Slower, queries all |
| Portfolio value | "What's my total portfolio value in USD?" | USD conversion |
| Token value | "How much is my DEGEN worth?" | Single token USD |
| NFT holdings | "Show me my NFT collections" | Lists collections |
| NFT floor prices | "What's the floor price of my NFTs?" | External API calls |

## Prompt Patterns

```
# Token Balances
"What are my token balances?"
"How much [TOKEN] do I have?"
"Show my [TOKEN] balance on [CHAIN]"
"What's my balance of token 0x..."

# Multi-Chain
"Show my balances across all chains"
"What are my balances on Base and Ethereum?"
"Compare my USDC holdings across all chains"

# Portfolio Value
"What's my total portfolio value in USD?"
"How much is my [TOKEN] worth in USD?"
"What's the total value of my Base holdings?"

# NFTs
"Show me my NFT collections"
"How many Pudgy Penguins do I own?"
"What's the floor price of my NFTs?"
```

## Usage

```typescript
import { BankrClient } from "@bankr/sdk";

const client = new BankrClient({
  privateKey: process.env.BANKR_PRIVATE_KEY as `0x${string}`,
});

const result = await client.promptAndWait({
  prompt: "What are my token balances on Base?",
});

console.log(result.response);
// "You have 150.5 USDC, 0.25 ETH, 1000 DEGEN on Base..."
```

## Supported Chains

| Chain | Notes |
|-------|-------|
| Base | Default chain, fastest responses |
| Ethereum | Mainnet ERC20 and NFTs |
| Polygon | L2 tokens and NFTs |
| Solana | SPL tokens and NFTs |

Specify chain in prompt: "on Base", "on Ethereum", "on Polygon", "on Solana"

## Related Skills

- **sdk-wallet-operations**: Client setup and configuration
- **sdk-capabilities**: Full list of supported operations

Overview

This skill lets you query multi-chain token balances, portfolio values, and NFT holdings using the Bankr x402 SDK. It translates natural-language prompts into balance and valuation queries across Base, Ethereum, Polygon, and Solana. Use it to get single-token balances, full-chain inventories, cross-chain aggregates, or NFT collection summaries quickly.

How this skill works

The skill sends your natural-language prompt to the Bankr client which inspects on-chain token and NFT positions for the provided wallet. It can target a single chain (fastest), multiple chains, or all supported chains and returns token amounts, USD conversions, and NFT collection lists and floor values when available. For multi-chain or NFT floor-price queries the skill calls additional APIs and may take longer to return results.

When to use it

  • Ask for a specific token balance: "How much ETH do I have?"
  • Request all tokens on a chain: "What tokens do I have on Base?"
  • Compare holdings across chains: "Show my balances across all chains"
  • Get portfolio valuation: "What's my total portfolio value in USD?"
  • Inspect NFT holdings or floor prices: "Show my NFT collections"

Best practices

  • Include the chain name when you need a specific chain (e.g., "on Base", "on Ethereum") to get faster, targeted results.
  • For precise token queries include symbol or contract address (e.g., "USDC" or token 0x...).
  • Ask multi-chain queries only when necessary; they require more time and external API calls.
  • Provide the correct wallet key or client context via BankrClient setup before prompting.
  • Expect NFT floor prices to require external market lookups and potentially slightly older pricing data.

Example use cases

  • Quick check: "How much USDC do I have on Base?" returns token amount and USD value.
  • Portfolio snapshot: "What's my total portfolio value in USD?" aggregates tokens and NFTs across specified chains.
  • Cross-chain comparison: "Compare my USDC holdings across Base and Polygon" shows per-chain balances.
  • NFT audit: "Show my Bored Ape Yacht Club holdings and floor prices" lists collection holdings and floor USD values.
  • Developer testing: use client.promptAndWait to simulate user prompts during integration.

FAQ

How do I specify which chain to query?

Include the chain name in your prompt (for example, "on Base", "on Ethereum", "on Polygon", or "on Solana").

Can I get USD valuations for tokens and NFTs?

Yes. Portfolio and token-value prompts return USD conversions; NFT floor prices use external market APIs and may take longer.

What if I want all balances across chains?

Ask "Show my balances across all chains." The skill will query each supported chain but will be slower than a single-chain request.