Back to Ccxt

query-address-info — CLI Reference

.agents/skills/query-address-info/references/cli.md

4.5.652.2 KB
Original Source

query-address-info — CLI Reference

Complete reference for every command in scripts/cli.mjs.

Invocation pattern: node <skill-dir>/scripts/cli.mjs <command> '<json_params>' Exit codes: 0 success · 1 usage/upstream error · 3 network failure


positions — Wallet active-position list

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

Parameters

ParamTypeRequiredDescription
addressstringyesWallet address (EVM 0x... or Solana base58)
chainIdstringyes"56" (BSC) · "8453" (Base) · "CT_501" (Solana)
offsetnumberyesPagination offset (start from 0)

Return fields (under .data.list[])

FieldTypeDescription
chainIdstringChain identifier
addressstringQueried wallet address (lowercased)
contractAddressstringToken contract address
binanceTokenIdstringBinance-internal stable token ID
name, symbolstringToken display names
iconstringLogo path — prefix with https://bin.bnbstatic.com
decimalsnumberToken decimals
pricestringCurrent USD price (decimal string)
percentChange24hstring24h price change (%, signed decimal string)
baseCoinPricestringUSD price of the chain native coin
remainQtystringHolding quantity (human-readable, already divided by decimals)
circulatingSupplystringCirculating supply
riskLevel, riskLevelIntstring | null, numberRisk badge ("LOW" = 1, etc.); may be null
lowLiquiditynumber1 = low-liquidity warning

Response envelope (under .data)

FieldTypeDescription
offsetnumberEcho of request offset
listarray | nullPosition list; null when wallet has no tracked holdings
addressStatusanyReserved (currently always null)

Errors

Exit codes: 0 ok · 1 upstream/usage (stderr: reason; stdout: body with business code) · 3 network. Business code: 000000 ok · 100004 rate-limited · 100002 bad param · 000400 unsupported chain / bad address.