Get Finance $2.00 / 1,000 calls

Crypto wallet on-chain status (best effort)

What this tool does

Check the best-effort on-chain status of a crypto wallet: whether the address has activity, its native balance and whether it can receive native funds.

Important: 'can_receive' is best-effort. A valid address can receive native funds, but off-chain rules (exchange deposit addresses disabled, token pause/blacklist, account flags) cannot be verified from the address alone. Supported chains: Bitcoin (mempool.space), Ethereum (public RPC), Ripple (XRPL) and Stellar (Horizon).

Common uses

  • Checking if a wallet address has been used before.
  • Reading the native balance of a public address.
  • Detecting whether an EVM address is a contract.

Input data

Parameter Required Example Description
address Yes 1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck Enter the wallet address you want to inspect. Example: '1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck'.
coin No Bitcoin Optional. Select the coin or leave it empty to auto-detect it from the address format. Supported: Bitcoin, Ethereum, Ripple, Stellar. Example: 'Bitcoin'.

Output data

Field Description
valid True when the address format is valid for the selected coin.
detected_coin Coin used for the lookup (explicit or auto-detected from the address).
supported True when the coin has an on-chain status provider in this tool.
exists True when the account/address has on-chain activity or balance.
active Best-effort activity indicator (transactions, balance or contract).
balance Native balance (BTC, ETH, XRP or XLM).
balance_unit Unit of the reported balance.
tx_count Transaction count or account sequence when available.
can_receive Best-effort: whether the address can receive native funds. Off-chain rules cannot be verified.
receive_reason Reason for the can_receive value (valid_address, invalid_address, unsupported_coin, provider_error...).
is_contract True when the EVM address is a contract (null for non-EVM chains).
provider Provider used for the on-chain lookup.
checked_at ISO timestamp of the lookup.