New to Claude Skills? Learn how to install them →

ccxt on GitHub

Query Address Info

Free

Get detailed token holdings for any wallet address.

by ccxt43.6k stars on ccxt/ccxt
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Query Address Info does

The Query Address Info skill provides a straightforward way to retrieve the current token holdings of any specified on-chain wallet address. It lists every token held, along with essential details such as the token name, symbol, current price, 24-hour price change percentage, and the quantity held. This skill is particularly useful for developers and analysts who need to monitor wallet activities or assess portfolio compositions on various blockchain networks.

To use this skill, simply provide a wallet address and specify the blockchain it resides on. Supported chains include Binance Smart Chain (BSC), Solana, Base, and Ethereum. The skill will return a comprehensive overview of the wallet's holdings, allowing users to quickly assess the value and performance of their assets. The command structure is designed to be simple yet effective, making it easy to integrate into existing workflows or scripts.

This skill is ideal for those who frequently interact with blockchain data, such as developers building dApps, financial analysts tracking cryptocurrency portfolios, or anyone interested in understanding the composition of a wallet. By automating the retrieval of this information, users can save time and reduce the potential for errors in manual data collection.

However, it is important to note that the skill requires the offset parameter for pagination on every call, including the initial request. This means users must be aware of the pagination rules to effectively retrieve all holdings if there are multiple pages of data. The skill is designed for users who are comfortable with command-line interfaces and have a basic understanding of how to interact with APIs.

When to use it

Use this skill when you need to quickly retrieve the token holdings of a specific wallet address on supported blockchains.

When not to use it

This skill is not suitable for wallets on unsupported chains or for users unfamiliar with command-line operations.

What you can build with it

Check Wallet Holdings

Use the skill to quickly check the current holdings of a specific wallet address.

Monitor Portfolio Changes

Regularly query wallet addresses to monitor changes in token holdings and prices.

Integrate with dApps

Incorporate this skill into decentralized applications to provide users with real-time wallet information.

How to install Query Address Info

View source

1. Install with the skills CLI

npx skills add ccxt/ccxt/query-address-info --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by ccxt

Query Address Info Skill

Overview

This skill queries any on-chain wallet address for token holdings, supporting:

List of all tokens held by a wallet address Current price of each token 24-hour price change percentage Holding quantity

When to Use This Skill

User intentCommand
List a wallet's token holdings with price and 24h changepositions

Supported Chains

ChainchainId
BSC56
SolanaCT_501
Base8453
Ethereum1

How to Call APIs

node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}'

Commands

CommandPurposeRequired argsExample
positionsList wallet token holdings (price + 24h change + quantity)address, chainId, offsetnode <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}'

Rules

  • offset is required on every call — including the first page. Pass 0 to fetch the first page; increment for subsequent pages. Omitting it causes an upstream validation error.
  • Pagination: repeat with increasing offset until data.list is empty or shorter than the page size.
  • Icon URL prefix: icon is a relative path (e.g., /images/web3-data/public/token/logos/xxxx.png). Prepend https://bin.bnbstatic.com to render.
  • Numbers as strings: price, percentChange24h, remainQty are strings — convert to numbers before arithmetic.

Full CLI Reference

See references/cli.md for per-subcommand invocations, parameter tables, return-field tables, and real response samples.

Frequently asked questions about Query Address Info

Similar skills