Query Address Info Skill

SkillDev tools

Lets your agent look up all tokens held by a crypto wallet, with prices and 24h changes.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Query Address Info Skill skill

About this capability

Snapshot of a single wallet's token holdings on a specific chain — list of every token currently held with name, symbol, current price, 24h price change, and holding quantity. Use when the user provides an explicit wallet address (or says "my wallet") and wants the current portfolio: "what does 0x..

What this skill tells your AI

The instructions your AI receives, as published by ccxt/ccxt in .agents/skills/query-address-info/SKILL.md and read by ahel’s review.

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.

Signals

GitHub stars
44k
Forks
9k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
query-address-info
Source
github.com/ccxt/ccxt