Dirección ERC20: formato, balanceOf y creación por API
Una dirección ERC20 es la dirección de cuenta de 42 caracteres, con prefijo 0x, que Ethereum usa para cada wallet. Pasa a ser una dirección ERC-20 cuando la cuenta guarda tokens que siguen el estándar ERC-20. La misma cadena sirve en Polygon y Arbitrum por ser compatibles con EVM, pero los tokens y saldos son propios de cada cadena.
Llamar a balanceOf(address) en el contrato del token devuelve un saldo ERC-20. Por REST, GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} devuelve la misma cifra ya decodificada. Para recibir tokens, comparte la dirección. Para enviarlos, necesitas su clave y algo de ETH para pagar el gas.
Esta página trata el formato de la dirección, balanceOf, la misma dirección en Polygon y Arbitrum, y la creación de direcciones por REST.
¿Qué es el estándar ERC-20?
ERC-20 es la interfaz estándar de Ethereum para tokens fungibles. EIP-20 define seis funciones, totalSupply, balanceOf, transfer, transferFrom, approve y allowance, además de los eventos Transfer y Approval. Cualquier contrato que las implemente es un token compatible. Así, wallets y exchanges pueden dar soporte a un token nuevo sin trabajo a medida para cada uno.
El resumen de ERC-20 de ethereum.org recorre la misma interfaz con ejemplos. La mecánica completa está en nuestro artículo sobre el estándar de tokens ERC20. Esta página se queda del lado de la dirección: qué es una dirección ERC-20 y cómo trabajar con ella en código.
¿Qué aspecto tiene una dirección ERC-20?
Una dirección ERC-20 es la dirección de Ethereum de siempre, por ejemplo 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed. Son 0x más 40 caracteres hexadecimales, 42 en total. La documentación de cuentas de ethereum.org la describe como los últimos 20 bytes del hash Keccak-256 de la clave pública de la cuenta.
El nombre solo aparece según el contexto. Una dirección pasa a ser una «dirección ERC-20» cuando se habla de los tokens que guarda. Nada en la cadena indica que pueda contener tokens, y la misma dirección sirve para ETH, para todos los tokens ERC-20 y para NFT.
- El prefijo 0x indica que el valor es hexadecimal.
- Los 40 caracteres hexadecimales son 20 bytes: los últimos 20 bytes del hash Keccak-256 de la clave pública.
- 42 caracteres en total. La mezcla de mayúsculas y minúsculas es el checksum EIP-55.
¿Cómo lee balanceOf el saldo de un token ERC-20?
balanceOf(address) es la función de solo lectura que devuelve el saldo de tokens de una dirección. El saldo no se guarda en la dirección. Vive dentro del smart contract del token, en una tabla indexada por dirección, y balanceOf la consulta.
Llamarla directamente implica codificar un eth_call de JSON-RPC contra el contrato del token y decodificar el hexadecimal devuelto. El resultado es un entero en la unidad mínima del token, así que también debes leer decimals(). Muchas stablecoins usan 6 decimales y otras 18, y equivocarse aquí es una fuente habitual de errores por un factor de un millón.
La API de Chaingateway se encarga de la codificación y de los decimales. Los endpoints de saldo devuelven números simples, de modo que un problema de RPC en bruto se convierte en una respuesta REST normal.
¿Es válida la misma dirección ERC-20 en Polygon y Arbitrum?
Sí. Polygon y Arbitrum son compatibles con EVM, así que sus direcciones usan el mismo formato 0x. Una dirección derivada de la misma clave privada es la misma cadena en Ethereum, Polygon y Arbitrum.
Los tokens de esa dirección no se comparten. Un contrato de token desplegado en Ethereum no existe en Polygon hasta que alguien lo despliega allí o puentea el activo. Los saldos son, por tanto, propios de cada cadena, aunque la dirección no lo sea. Los tokens en Polygon siguen la misma interfaz ERC-20, por eso una sola ruta de código puede servir a las tres cadenas.
ERC-721 y ERC-721A: otro estándar, el mismo formato de dirección
ERC-721 es el estándar de tokens no fungibles de Ethereum. Cada ID de token es único, a diferencia de los saldos intercambiables de ERC-20. EIP-721 especifica la interfaz.
ERC-721A es una implementación de la misma interfaz optimizada en gas, habitual en colecciones que se acuñan por lotes. Cambia cómo guarda los datos el contrato por dentro, no el aspecto de la dirección de quien los posee. Ambos estándares usan la misma dirección 0x para la propiedad. El artículo sobre el estándar de tokens ERC721 trata a fondo el lado de los NFT.
Crear y leer direcciones ERC-20 por REST
Seis rutas cubren el ciclo de vida de las direcciones en una integración de pagos.
| Endpoint | Qué hace |
|---|---|
POST /api/v2/ethereum/addresses | Genera una nueva dirección de Ethereum |
POST /api/v2/ethereum/addresses/import | Importa una clave privada para que la API pueda firmar por esa dirección |
GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} | Saldo de un token ERC-20, ya decodificado |
GET /api/v2/ethereum/balances/{address}/erc20 | Todos los saldos de tokens de la wallet |
POST /api/v2/ethereum/webhooks | Registra un webhook para los depósitos ERC-20 a la dirección |
POST /api/v2/ethereum/transactions/erc20 | Envía un token ERC-20 desde la dirección |
La misma forma de petición vale con /polygon/ o /arbitrum/ en lugar de /ethereum/ en la ruta, porque las tres cadenas comparten el formato de dirección y la interfaz ERC-20.
Leer un saldo ERC-20 sin eth_call
La dirección de contrato de abajo es USDT en la mainnet de Ethereum. Añade X-Network: testnet para consultar un token de testnet.
curl https://app.chaingateway.io/api/v2/ethereum/balances/0xYourAddress/erc20/0xdAC17F958D2ee523a2206206994597C13D831ec7 \
-H "Authorization: Bearer YOUR_API_KEY"¿Cómo valido una dirección ERC-20 antes de enviar?
Primero compara la cadena con ^0x[a-fA-F0-9]{40}$, que rechaza longitudes incorrectas y caracteres sueltos. Si la dirección mezcla mayúsculas y minúsculas, verifica también el checksum EIP-55. Una sola letra errónea hace que falle.
Una comprobación de formato no te dice qué red espera el destinatario, porque la misma dirección es válida en todas las cadenas EVM. Pide la red de forma explícita. No aceptes nunca la dirección de un contrato de token como destino. El validador de direcciones ejecuta las comprobaciones de formato y checksum en el navegador para una dirección concreta.
Fuentes
- EIP-20: Token Standard
- ERC-20 token standard (ethereum.org)
- Ethereum accounts (ethereum.org)
- ERC-55: Mixed-case checksum address encoding
Comprobado el 5 de noviembre de 2026.
¿Necesitas saldos ERC-20 sin decodificar a mano las llamadas a balanceOf? Crea una cuenta gratuita y consulta una dirección de testnet por REST. Prueba de 7 días, sin tarjeta, sin KYC.
Preguntas frecuentes: direcciones ERC-20
¿Listo para construir en Ethereum, Polygon o Arbitrum?
Crea una cuenta y consulta hoy un saldo ERC-20 de testnet. Prueba de 7 días, sin tarjeta, sin KYC. La referencia completa está en la documentación de la API de Ethereum. Para cubrir las siete cadenas, usa la API blockchain multicadena.
Revisado por Maurice Sobiera Cómo escribimos estas páginas