Crypto wallet on-chain status (best effort)
Qué hace esta herramienta
Consulta el estado on-chain best-effort de una billetera cripto: si la dirección tiene actividad, su saldo nativo y si puede recibir fondos nativos.
Importante: 'can_receive' es best-effort. Una dirección válida puede recibir fondos nativos, pero las reglas off-chain (direcciones de depósito de exchanges desactivadas, pause/blacklist de tokens, flags de cuenta) no se pueden verificar solo con la dirección. Cadenas soportadas: Bitcoin (mempool.space), Ethereum (RPC público), Ripple (XRPL) y Stellar (Horizon).
Usos habituales
- Comprobar si una dirección se ha usado antes.
- Leer el saldo nativo de una dirección pública.
- Detectar si una dirección EVM es un contrato.
Datos que recibe
| Parámetro | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|
address | Sí | 1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck | Introduce la dirección de la billetera que quieres consultar. Ejemplo: '1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck'. |
coin | No | Bitcoin | Opcional. Selecciona la moneda o déjalo vacío para autodetectarla desde el formato de la dirección. Soportadas: Bitcoin, Ethereum, Ripple, Stellar. Ejemplo: 'Bitcoin'. |
Datos que devuelve
| Campo | Descripción |
|---|---|
valid | True cuando el formato de la dirección es válido para la moneda seleccionada. |
detected_coin | Moneda usada para la consulta (explícita o autodetectada desde la dirección). |
supported | True cuando la moneda tiene proveedor de estado on-chain en esta herramienta. |
exists | True cuando la cuenta/dirección tiene actividad o saldo on-chain. |
active | Indicador de actividad best-effort (transacciones, saldo o contrato). |
balance | Saldo nativo (BTC, ETH, XRP o XLM). |
balance_unit | Unidad del saldo reportado. |
tx_count | Número de transacciones o secuencia de cuenta cuando está disponible. |
can_receive | Best-effort: si la dirección puede recibir fondos nativos. Las reglas off-chain no se pueden verificar. |
receive_reason | Motivo del valor can_receive (valid_address, invalid_address, unsupported_coin, provider_error...). |
is_contract | True cuando la dirección EVM es un contrato (null para cadenas no EVM). |
provider | Proveedor usado para la consulta on-chain. |
checked_at | Timestamp ISO de la consulta. |