Skip to content

wallet-cli exchange show

Show one exchange pair.

Synopsis

wallet-cli exchange show <id> [options]

Description

Reports a pair's creator, creation time, and both tokens with their reserves. Read-only, no account needed.

No price is shown. The ratio of the reserves is a quoted rate that holds only in the limit of a zero-size trade; anything with volume settles further along the curve and returns less. Printing it would invite reading it as an executable price. To price a specific amount against the current reserves, run exchange trade --dry-run.

Unlike exchange list, this command resolves each side's name and precision, so reserves print as whole tokens here and the json carries firstTokenLabel / firstTokenDecimals and their second* counterparts alongside the raw balances. The same pair therefore reads 66.72 here and 6,672 in the list.

pair and the first* / second* fields follow the order the chain stored them, which is the order the creator supplied — TRX is not normalized to either side. Text folds the two sides into a Reserves block in that same order.

Options

Option Description
<id> Required. Exchange pair id

Plus the global options.

Examples

wallet-cli exchange show 12 --network tron:3448148188
Exchange id 12
  Creator       TQkXm4vN...5Zt7Uw
  Created time  2026-08-02 09:15:00 UTC
  Reserves
    TRX                   10,000
    MyToken (id 1000123)  500,000
wallet-cli exchange show 12 --network tron:3448148188 -o json
{"schema":"wallet-cli.result.v1","success":true,"command":"exchange.show","data":{"kind":"exchange-show","exchangeId":12,"pair":"TRX:1000123","creatorAddress":"TQkXm4vN...","createTime":1785662100000,"firstTokenId":"_","firstTokenBalance":"10000000000","firstTokenLabel":"TRX","firstTokenDecimals":6,"secondTokenId":"1000123","secondTokenBalance":"500000000000","secondTokenLabel":"MyToken","secondTokenDecimals":6},"meta":{"durationMs":24,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

Output

data.kind is exchange-show.

Field Type Meaning
exchangeId number Pair id
pair string The two sides as tokenA:tokenB, in stored order; TRX is spelled TRX here
creatorAddress string Creator, base58 — the only account that may inject or withdraw
createTime number Creation time, ms since epoch
firstTokenId / secondTokenId string On-chain token ids, in stored order; TRX is "_" — it can be either side
firstTokenBalance / secondTokenBalance string Reserves, raw amounts in each token's smallest unit. Strings: reserves reach int64 and would lose precision as JSON numbers
firstTokenLabel / secondTokenLabel string Token name, or TRX
firstTokenDecimals / secondTokenDecimals number Decimal places used to render the whole-token figures in text

Exit status

0 success · 1 execution failure (exchange_not_found — no such pair, rpc_error) · 2 usage error (invalid_value — id not a number).

See also

exchange list · exchange trade · exchange inject