Historial de transacciones TRC20: cómo exportarlo a CSV para la contabilidad con Tronscan y la API

En resumen: el historial de transacciones TRC20 se guarda en la blockchain de TRON y cualquiera puede consultarlo con la dirección de la billetera. Para la contabilidad se exporta de dos formas: con el botón de exportar a CSV en la página de la dirección en Tronscan, que es rápido pero tiene límites de volumen y periodo, o con la API de TronGrid, que permite descargar todas las transferencias de USDT de cualquier periodo, página por página. Las comisiones en TRX y la energía quemada conviene exportarlas aparte: en la lista de transferencias del token normalmente no aparecen.

Para qué exportar el historial de transferencias de USDT

La billetera muestra las últimas operaciones, pero no sirve como registro contable: no tiene filtros por periodo, contraparte ni comisiones, y si cambias de aplicación el historial «desaparece» de la interfaz. En la blockchain se queda para siempre, así que exportar es solo una forma de llevar los datos a un formato cómodo.

Normalmente necesitas exportarlo en cuatro situaciones:

• Conciliación con tu contable o un informe para un socio: cuánto USDT entró y salió en el mes.
• Cálculo del gasto en comisiones de red: cuánto TRX se quemó y cuánta energía consumieron las transferencias.
• Revisión de un pago en disputa: encontrar el hash, la hora y la dirección del remitente en una fecha concreta.
• Preparación de datos para la declaración de impuestos. Cómo tratar cada operación depende de las leyes de tu país y de tu asesor; este artículo no es asesoramiento fiscal.

Qué incluye el historial de una dirección y qué no

Una dirección de TRON tiene varios tipos de registros, y cada exportación los guarda por separado:

• Transferencias de TRX: transacciones normales de la moneda nativa.
• Transferencias de tokens TRC-20 (USDT y otros): llamadas a un contrato inteligente que generan el evento Transfer. Son las que Tronscan muestra en la pestaña de transferencias de tokens.
• Operaciones de servicio: congelación de TRX, delegación de energía, votación, cambio de permissions, approve.
• Comisiones: cuánto bandwidth y energía se consumió y cuánto TRX se quemó si faltaban recursos propios. Son campos del recibo (receipt) de cada transacción, no operaciones aparte.

Un detalle importante para la contabilidad: una transacción fallida con estado REVERT u OUT_OF_ENERGY no mueve USDT, así que no aparece en la lista de transferencias del token. Pero el TRX se quemó igualmente y debe figurar en los gastos de comisiones.

Cómo exportar el historial de transacciones TRC20 de Tronscan a CSV

Es la vía más sencilla y no requiere programar. Sirve si tienes pocas operaciones y necesitas un informe puntual.

• Abre tronscan.org y pega la dirección de la billetera en el buscador. No hacen falta claves ni frase semilla: el historial es público.
• Ve a la pestaña de transferencias (Transfers) y elige la sección de tokens TRC-20.
• Filtra por el token USDT. Comprueba la dirección del contrato: el USDT auténtico en TRON es TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t.
• Elige el periodo. Para la contabilidad es más cómodo exportar por meses naturales.
• Pulsa el botón de descarga (Export / Download CSV). Tronscan puede pedirte un captcha.
• Abre el archivo en Excel o Google Sheets. Si los caracteres o los números se ven mal, impórtalo con Datos → Desde texto/CSV, codificación UTF-8 y separador coma.

Conviene conocer los límites de antemano. Tronscan limita el volumen y el periodo de cada exportación, y su interfaz cambia con el tiempo. Si el historial es largo, exporta mes a mes y comprueba que el número de filas coincide con el de operaciones en la página. La exportación de transferencias del token normalmente no trae columna de comisión, así que esa se obtiene aparte.

Cómo obtener el historial de transacciones TRC20 por API

Si tienes cientos o miles de operaciones, o necesitas el informe con regularidad, la API resulta más práctica. TronGrid tiene un endpoint específico para transferencias TRC-20 por dirección:

GET https://api.trongrid.io/v1/accounts/<dirección>/transactions/trc20?contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&limit=200

Parámetros útiles para la contabilidad:

• contract_address deja solo USDT y descarta los tokens spam.
• limit fija los registros por página; según la documentación, el máximo es 200.
• fingerprint es la marca de la página siguiente, tomada del campo meta.fingerprint de la respuesta anterior. Sigue pidiendo páginas mientras llegue.
• min_timestamp y max_timestamp marcan los límites del periodo en milisegundos.
• only_confirmed=true devuelve solo transacciones confirmadas, para que en el informe no entre nada sin asentar.
• only_to u only_from devuelven solo las entrantes o solo las salientes.

Cada registro incluye transaction_id (el hash), block_timestamp, from, to, value y token_info con el número de decimales. Para el informe haz tres conversiones: divide value entre 10 elevado a decimals (USDT tiene seis, es decir, 1 000 000 en value equivale a 1 USDT); pasa la hora de milisegundos UTC a tu zona horaria; y determina la dirección comparando from y to con tu propia dirección.

Sin clave de API se aplican límites estrictos de peticiones. La clave gratuita se obtiene en el panel de TronGrid y se envía en la cabecera TRON-PRO-API-KEY. La clave solo da acceso de lectura a datos públicos y no tiene relación con tus fondos.

Cómo añadir las comisiones al informe: energía y TRX quemados

El endpoint de transferencias TRC-20 no devuelve la comisión. Se obtiene por el hash de cada transacción con el método gettransactioninfobyid. La respuesta trae el campo fee, con los TRX quemados en SUN (1 TRX = 1 000 000 SUN), y el recibo receipt: energy_usage_total es la energía total de la transacción, energy_fee son los SUN quemados por la energía que faltaba, y net_usage y net_fee, lo mismo para el bandwidth.

Referencias para comprobar las cifras: una transferencia de USDT a una dirección que ya tiene USDT gasta unos 64 500–65 000 de energía; a una dirección vacía, aproximadamente el doble, unos 131 000. Sin energía propia ni alquilada, la red quema unos 6,5 TRX, y unos 13 TRX si la dirección está vacía. Si en tu exportación transferencias iguales muestran un consumo claramente distinto, revisa si ese día el contrato tenía un multiplicador de energía dinámica más alto.

Cómo limpiar la exportación antes de la contabilidad

• Elimina las transferencias entrantes de cero o de importes mínimos desde direcciones parecidas: son restos de un ataque de envenenamiento de direcciones, no pagos reales.
• Deja solo el contrato TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. Los tokens llamados USDT con otro contrato son falsificaciones.
• Quita duplicados por hash: en la exportación por páginas, un registro puede aparecer dos veces en el borde entre páginas.
• Separa las transferencias entre tus propias billeteras de las externas; si no, el volumen se contará dos veces.
• Conserva el hash en cada fila: con él podrás verificar cualquier operación en Tronscan años después.
• Para depósitos y retiros de un exchange, descarga también el extracto del propio exchange. En la red solo se ven las direcciones de sus billeteras calientes, y las operaciones internas nunca llegan a la blockchain.

Qué hacer con la cifra de gasto en comisiones

Una exportación con fee y energy_usage_total muestra cuánto pagas realmente a la red. Si en el informe hay muchas filas con TRX quemados, tus transferencias salieron sin energía. Para transferencias frecuentes, el alquiler lo resuelve: la energía se delega a tu dirección por un plazo y nunca compartes claves ni acceso a la billetera.

La blockchain ya lleva la contabilidad por ti. Tu tarea es extraer bien los datos: transferencias por un lado, comisiones por otro y el hash en cada fila.