USDT Balance - peaq

Use this service to query USDT balances for any EVM address on peaq EVM. The call is read-only and does not require the address to exist in the local registry.

Service Reference

Service	Type	Purpose
`/peaq_tether_node/usdt/balance`	`peaq_ros2_interfaces/srv/TetherGetUsdtBalance`	Return USDT balance for an address

Launch Prerequisites

Start peaq_tether_node once, then call services as needed.

To start and stop the node, follow the steps in Service Index.
In any new terminal where you run ros2 commands, make sure you’ve sourced your ROS/workspace environment and set the same ROS_DOMAIN_ID as the node:

# source /opt/ros/<your_ros_distro>/setup.bash
# source <path to your peaq-robotics-ros2 clone>/install/setup.bash
export ROS_DOMAIN_ID="${ROS_DOMAIN_ID:-94}"

Check Balance

export ROS_DOMAIN_ID="${ROS_DOMAIN_ID:-94}"
ros2 service call /peaq_tether_node/usdt/balance \
  peaq_ros2_interfaces/srv/TetherGetUsdtBalance \
  "{address: '0x...'}"

Response fields:

balance_raw: base-10 string (uint256)
balance_formatted: formatted using configured decimals (default 6 for peaq USDT)

Quote the USDT contract address in the config YAML. Unquoted 0x... values parse as numbers and break the string parameter.

⌘I