Skip to content

Queries

Every x/tokenization gRPC query with its LCD REST path and bb CLI command. One page per query.

The x/tokenization module exposes 16 read-only queries. Each is reachable three ways: the bb query tokenization CLI, the LCD REST endpoint under https://lcd.bitbadges.io, and gRPC. Every query page shows the CLI command, the REST path, and the response shape.

For indexed, paginated, or historical data (activity, metadata, claims, search) use the BitBadges API. Chain queries return current state only.

Collections and Balances

QueryCLIWhat it returns
GetCollectioncollection [id]The full TokenCollection record.
GetCollectionStatscollection-stats [id]Holder count and circulating supply.
GetBalancebalance [id] [address]An address's UserBalanceStore: balances, approvals, flags, permissions.
GetBalanceForTokenbalance-for-token [id] [address] [token-id] [time]The amount of one token ID owned at one time.
GetWrappableBalanceswrappable-balances [denom] [address]Maximum amount an address can wrap into a denom.

Address Lists and Dynamic Stores

QueryCLIWhat it returns
GetAddressListaddress-list [id]An address list, including reserved IDs.
GetDynamicStoredynamic-store [store-id]Store config: default, kill switch, metadata.
GetDynamicStoreValuedynamic-store-value [store-id] [address]The boolean stored for one address.

Approval Trackers and Challenges

QueryCLIWhat it returns
GetApprovalTrackerapprovals-trackers ...Cumulative transfers and amounts for an approval tracker.
GetChallengeTrackernum-used-for-merkle-challenge ...Times a Merkle leaf has been used.
GetETHSignatureTrackernum-used-for-eth-signature-challenge ...Times an ETH signature has been used.
GetVotevote ...One voter's vote on a voting challenge.
GetVotesvotes ...Every vote on a voting challenge.

Protocol

QueryCLIWhat it returns
ParamsparamsModule parameters.
IsAddressReservedProtocolis-address-reserved-protocol [address]Whether an address is reserved.
GetAllReservedProtocolAddressesall-reserved-protocol-addressesEvery reserved protocol address.

Conventions

  • approvalLevel is collection, incoming, or outgoing.
  • approverAddress is empty for collection. In a REST path, an empty segment produces //, which the LCD accepts.
  • Numbers are strings. Uint values up to 18446744073709551615 are common for open-ended ranges.
  • Add --node https://rpc.bitbadges.io:443 (or your node) to CLI commands when running off-box.

Edit this page on GitHub