Show the USD price of one or more tokens.
wallet-cli sunswap price [<token>] [options]
Prices come from the SunSwap market data service, which holds mainnet data only — on Nile or Shasta the command fails with unsupported_network_capability. Give either a token symbol as the positional argument or a comma-separated list of contract addresses with --address — one or the other, never both.
A symbol is resolved locally, not by the service: TRX and WTRX are built in, and anything else is looked up in the official token address book for the network. The user layer of that book is per-account and this command takes no account, so a symbol added with token add does not resolve here; pass its address instead.
A price of 0 is a real answer. The service returns it for any address it has not indexed — an unlisted token, an impersonation, or a plain wallet address — so zero means "not indexed", not "worthless".
The text Symbol column is filled from the SunSwap catalogue and is display only: a symbol is what a contract calls itself, and an impersonation of USDT is listed as USDT too. JSON deliberately omits it, so a caller keys on the address. If the catalogue lookup fails the column shows —, a note is added to meta.warnings, and the command still exits 0 with the prices intact.
| Option | Description |
|---|---|
--address <addresses> |
Comma-separated token contract addresses; mutually exclusive with the token argument |
Plus the global options. No --account: this command reads no wallet, and the flag is rejected with invalid_option.
wallet-cli sunswap price TRX --network tron| Symbol | Address | Price (USD) | Quoted at (UTC) |
| ------ | ---------------------------------- | ----------- | ---------------- |
| TRX | T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb | $0.3350 | 2026-10-08 04:34 |wallet-cli sunswap price TRX --network tron -o json{"schema":"wallet-cli.result.v1","success":true,"command":"sunswap.price","data":{"prices":[{"address":"T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb","priceUsd":"0.335046040886","quotedAt":"2026-10-08 04:34"}]},"meta":{"durationMs":1427,"warnings":[]},"chain":{"family":"tron","network":"tron:728126428","chainId":"728126428"}}Several tokens by address:
wallet-cli sunswap price --address T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb,TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7,TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4 --network tron| Symbol | Address | Price (USD) | Quoted at (UTC) |
| ------ | ---------------------------------- | ------------- | ---------------- |
| WIN | TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7 | $0.00005557 | 2026-10-08 04:34 |
| TRX | T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb | $0.3350 | 2026-10-08 04:34 |
| BTT | TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4 | $0.0000003632 | 2026-10-08 04:34 |A price at or above a cent shows four decimals; below a cent it switches to four significant digits, truncated, so a sub-cent token does not collapse to $0.0000.
| Field | Type | Meaning |
|---|---|---|
prices[].address |
string | The token contract address, as the service keyed it |
prices[].priceUsd |
string | USD price, the service's exact digits; "0" means "not indexed" |
prices[].quotedAt |
string | UTC minute the service answered. Not a freshness claim about the price |
Rows come back in the service's order, which need not match the order given; match on address. Duplicate addresses are deduplicated before the request, so there may be fewer rows than addresses.
0 success · 1 execution failure (provider_error, provider_rate_limited — with details.retryAfterSeconds when the service sent a usable Retry-After, timeout) · 2 usage error (missing_option — neither the token argument nor --address; invalid_option — both, or --account; unsupported_token — the symbol does not resolve on this network; invalid_address; unsupported_network_capability).