Ethereum: ETH, comisiones de gas y tokens ERC-20 explicados
Ethereum es una blockchain pública que ejecuta smart contracts y liquida dos tipos de valor: ETH, su moneda nativa, y tokens creados con estándares como ERC-20. Cada transacción paga gas en ETH, y los bloques se producen en slots fijos de 12 segundos con proof of stake.
Para aceptar pagos en Ethereum necesitas una dirección, una forma de detectar depósitos y, para los pagos salientes, ETH que cubra el gas. La API de Chaingateway ofrece las tres cosas por REST, así que no hay un nodo que sincronizar ni web3.js en tu código. Esta página explica cómo funcionan el gas, los tokens y la finalidad.
Para la integración en sí, la API de Ethereum de Chaingateway envía y recibe ETH y tokens ERC-20. Ejecutar tu propio nodo se compara en la página del nodo Ethereum.
¿Qué liquida Ethereum: ETH o tokens?
Ambos. Ethereum liquida el propio ETH y los tokens que viven dentro de smart contracts en la misma cadena. ERC-20 es el estándar de tokens detrás de USDT, USDC, DAI y miles de activos más. EIP-20 define una interfaz de contrato común (balanceOf, transfer, approve) que permite a cualquier wallet o exchange trabajar con cualquier token compatible de la misma manera.
ERC-721 y ERC-1155 extienden el mismo modelo de contrato a activos no fungibles y multitoken. Nuestra guía del estándar de tokens ERC-20 trata el formato con más detalle, y la guía de la dirección ERC-20 explica en qué se diferencian una dirección y un contrato de token.
¿Quién paga el gas en una transacción de Ethereum?
Paga la dirección que envía, en ETH, y nunca el destinatario. Una transferencia simple de ETH cuesta un valor fijo de 21 000 unidades de gas. Una transferencia ERC-20 ejecuta código de contrato, así que cuesta un múltiplo de eso, y el múltiplo varía según el token.
Desde la actualización London (EIP-1559), el precio por unidad de gas se divide en una comisión base que la red quema y una propina de prioridad para quien propone el bloque. Ambas suben cuando la red está ocupada. La documentación de gas de ethereum.org da un ejemplo resuelto: con una comisión base de 10 gwei y una propina de 2 gwei, una transferencia simple cuesta 21 000 x 12 gwei, es decir, 252 000 gwei o 0,000252 ETH.
Una wallet que tiene tokens pero no ETH no puede enviarlos, porque el contrato del token no puede pagar su propia ejecución. Recibir no cuesta nada al destinatario. El gas importa cuando los fondos vuelven a salir, por ejemplo cuando una wallet de tesorería barre los depósitos de las direcciones de clientes.
En la API de Chaingateway, el límite de gas, el precio del gas y los topes de comisión de EIP-1559 (maxFeePerGas, maxPriorityFeePerGas) son campos opcionales de una petición de transacción. Si los omites, la API los fija al construir y emitir tu transacción. Pásalos cuando quieras fijar la comisión.
¿Cuánto tarda una transacción de Ethereum en ser final?
Unos 13 minutos, aunque la inclusión en un bloque suele tardar de segundos a un minuto. Ethereum funciona con proof of stake desde The Merge. Según ethereum.org, el tiempo se divide en slots de 12 segundos y épocas de 32 slots, y en cada slot se elige a un validador para proponer un bloque.
Un bloque se finaliza cuando dos tercios del ETH en staking han votado por él a lo largo de dos checkpoints, lo que lleva unas dos épocas, cerca de 12,8 minutos. La finalidad significa que el bloque no puede revertirse salvo que un atacante destruya al menos un tercio de todo el ETH en staking.
La mayoría de las aplicaciones acreditan los depósitos de importe habitual tras la inclusión más unos pocos bloques, y reservan la espera completa para importes grandes. El webhook de depósito te da el evento on-chain. Dónde se pone la línea para acreditar es una decisión de política en tu propio código.
Enviar y recibir Ethereum por REST
Webhooks
Registra una URL de callback y recibe una notificación HTTPS, firmada con una cabecera X-Signature, cuando se liquida un depósito. La entrega no tiene reintento automático integrado: las notificaciones fallidas las lista GET /api/v2/ethereum/webhooks/notifications/failed y se pueden reenviar con una sola llamada.
Transacciones sencillas
Envía ETH y tokens ERC-20 con el límite de gas, el precio del gas y el nonce como campos opcionales de la petición. Indica el destinatario, el token y el importe, y la API completa el resto, o fija tú los campos de comisión cuando quieras controlarlos.
Gestión segura de direcciones
El formato de la dirección se valida en cada petición, y las claves existentes entran por POST /api/v2/ethereum/addresses/import, protegidas con contraseña y almacenadas cifradas. La arquitectura es non-custodial.
Consultas decodificadas
Las transacciones se devuelven como JSON legible mediante GET /api/v2/ethereum/transactions/{txid}/decoded, así que tu aplicación lee campos estructurados en lugar de analizar la salida en bruto del contrato.
Empieza en tres pasos
Crea una cuenta y copia tu clave de API del dashboard. La prueba de 7 días empieza sin tarjeta de crédito ni KYC.
Llama a GET /api/account para confirmar que la clave funciona, y después crea una dirección o importa una existente en POST /api/v2/ethereum/addresses/import.
Añade la cabecera X-Network: testnet, fondea la dirección desde un faucet público de Sepolia y envía una transferencia ERC-20 de prueba. Registra un webhook y después quita la cabecera: el mismo código funciona en mainnet.
¿Funciona la misma petición en Polygon y Arbitrum?
Sí, con otra ruta. El patrón de petición ERC-20 que usa Ethereum se repite en las demás cadenas EVM que cubre la API. /api/v2/polygon/transactions/erc20 y /api/v2/arbitrum/transactions/erc20 aceptan los mismos campos que la ruta de Ethereum, y BNB Smart Chain usa /api/v2/bsc/transactions/bep20.
El código escrito para Ethereum pasa a Polygon o Arbitrum cambiando la ruta, algo útil cuando el gas de la mainnet hace inviable una transferencia pequeña. La lista completa de cadenas está en la vista general de la API blockchain.
Fuentes
- Gas and fees (ethereum.org)
- Proof-of-stake y Gasper (ethereum.org)
- EIP-1559: Fee market change
- ERC-20: Token Standard
Comprobado el 5 de noviembre de 2026.
Preguntas frecuentes
¿Listo para construir en Ethereum?
Crea una cuenta en app.chaingateway.io/register y envía una transferencia ERC-20 en Sepolia durante la prueba. La referencia completa de endpoints está en la documentación de la API de Ethereum, y los planes y límites tienen su propia página.
Revisado por Maurice Sobiera Cómo escribimos estas páginas