Cómo importar su historial de operaciones de WEEX en Cryptact (para la declaración fiscal de criptomonedas en Japón)

En resumen: actualmente WEEX no está integrada automáticamente en Cryptact (no aparece en la lista de exchanges compatibles de Cryptact, por lo que no existe sincronización automática mediante API ni importación automática de archivos). Para utilizar su historial de operaciones de criptomonedas de WEEX en el cálculo de pérdidas y ganancias de Cryptact, debe completar el «archivo personalizado» genérico de Cryptact — una plantilla CSV/Excel de 10 columnas — con sus operaciones de WEEX y subirlo. Esta guía explica (1) cómo obtener el historial de operaciones de WEEX, (2) el formato exacto del archivo personalizado de Cryptact, (3) la correspondencia entre los campos de WEEX y las columnas de Cryptact, (4) ejemplos prácticos (todos hipotéticos) y (5) la consideración fiscal de estas ganancias. Esto es solo información y no asesoramiento fiscal. Confirme su tratamiento concreto con un profesional fiscal autorizado (税理士) o con la Agencia Tributaria Nacional de Japón.

Las especificaciones de Cryptact y WEEX que aparecen aquí se comprobaron directamente en la documentación pública de cada empresa (consulte la fecha al final de esta página y los hechos del libro mayor). Las especificaciones pueden cambiar: vuelva a consultar siempre las páginas oficiales actuales antes de trabajar. No existe ninguna asociación entre WEEX y Cryptact. Cryptact se menciona de forma objetiva como una herramienta japonesa de cálculo fiscal ampliamente utilizada.

Por qué utilizar el «archivo personalizado»

Para los exchanges compatibles, Cryptact puede obtener el historial mediante sincronización con una clave API o importación automática de archivos. Sin embargo, WEEX no aparece en la lista de exchanges compatibles de Cryptact (la página de WEEX de Cryptact devuelve un error o no muestra ninguna entrada; comprobado el 19-07-2026). Para los exchanges no compatibles y para las operaciones con derivados o margen, el método documentado oficialmente por Cryptact es su archivo personalizado genérico, que debe rellenar usted mismo. WEEX encaja plenamente en el caso de «exchange no compatible», por lo que el archivo personalizado es la vía adecuada.

El proceso (3 pasos)

1. Obtenga el historial de operaciones de WEEX (desde las pantallas de historial de la aplicación o la web, o mediante la API).
2. Adáptelo al archivo personalizado de Cryptact de 10 columnas (utilizando las tablas de correspondencia siguientes).
3. Suba el archivo a Cryptact como archivo personalizado.

Paso 1: Obtenga el historial de operaciones de WEEX

Las opciones realistas dependen del volumen. En el momento de esta investigación no pudimos confirmar que WEEX ofreciera una función oficial de exportación del historial de operaciones a CSV con un solo clic (no encontramos ningún artículo al respecto en el Centro de ayuda; esta investigación no verificó si había un botón de exportación en las pantallas de trading tras iniciar sesión). En la práctica, quedan estas opciones:

• Método A: registrarlo manualmente desde las pantallas de historial de la aplicación o la web (mejor para volúmenes pequeños). Utilice las pantallas de Order History, Trade History y Asset (fondos) History de WEEX para consultar la fecha y hora de cada ejecución, el símbolo, el lado, la cantidad, el precio y la comisión, y escríbalos en el archivo personalizado.
• Método B: obtenerlo mediante WEEX OpenAPI (mejor para grandes volúmenes o automatización). WEEX lanzó su OpenAPI (beta) en marzo de 2026; puede consultar su historial con una clave de solo lectura y transformarlo en el archivo personalizado. Los principales endpoints aparecen a continuación.

Endpoints del historial de WEEX OpenAPI (solo lectura)

La autenticación utiliza encabezados firmados (ACCESS-KEY / ACCESS-SIGN / ACCESS-PASSPHRASE / ACCESS-TIMESTAMP). Los endpoints del historial requieren el permiso USER_DATA (lectura), por lo que basta una clave API de solo lectura (sin permiso de trading) para obtener el historial.

Las ejecuciones de futuros están disponibles durante los últimos 365 días, en intervalos de hasta 7 días por solicitud; el libro mayor de ingresos permite hasta 100 días por solicitud. Todas las marcas de tiempo se devuelven en milisegundos UTC (la conversión a JST se explica más abajo).

Paso 2: Formato del archivo personalizado de Cryptact (10 columnas)

El archivo personalizado de Cryptact tiene 10 columnas (A–J), según el artículo oficial de ayuda de Cryptact «Cómo crear un archivo personalizado» (se pueden descargar ejemplos de Excel y CSV en japonés e inglés). Todas las columnas, excepto «Comment», son obligatorias.

Reglas clave de Cryptact (sígalas exactamente):

• El formato de la marca de tiempo es YYYY/MM/DD HH:mm:ss.
• La comisión debe introducirse incluso cuando sea 0 (una celda Fee vacía provoca un error de carga).
• Referencia automática del precio: solo puede dejar Price en blanco y permitir que Cryptact complete el precio de mercado cuando Base sea una moneda compatible con Cryptact y Counter sea una moneda fiat (por ejemplo, JPY). Si la base no es compatible o la contramoneda es una criptomoneda (por ejemplo, USDT), debe introducir el precio manualmente.
• No introduzca los caracteres ' " \ en Comment (la carga fallará).
• Abrir o editar el CSV directamente puede dañarlo (mojibake). Edítelo siguiendo las instrucciones de ayuda de Cryptact. Para valores con 15 o más decimales, utilice el archivo de ejemplo específico de Cryptact.

Paso 3: Correspondencia entre los campos de WEEX y las columnas de Cryptact

WEEX es un exchange centrado principalmente en futuros (derivados). En Cryptact, los futuros (margen) y el spot se registran de forma diferente, así que utilice la correspondencia aplicable. Las filas marcadas [ASSUMPTION] / [JUDGED] no aparecen en las especificaciones originales: son inferencias o recomendaciones de esta guía; verifíquelas antes de basarse en ellas.

Correspondencia (1): operaciones en spot

Fuente: WEEX «Get Trade History» GET /api/v3/myTrades (o la pantalla de historial de operaciones). Para el símbolo BTCUSDT, sepárelo en Base = BTC, Counter = USDT.

Correspondencia (2): futuros/derivados (margen)

Cryptact recomienda oficialmente para los derivados un método centrado únicamente en el cambio de margen/garantía. Los futuros de WEEX tienen margen en USDT, así que registre el cambio neto del PnL realizado (USDT): las ganancias como BONUS y las pérdidas como LOSS (una liquidación o cierre forzoso que reduzca el margen también es LOSS). Obtenga el dato de «Get Trade Details» de WEEX, realizedPnl, o de «Get Account Income», income.

[CRITERIO / notas] La tabla anterior utiliza el método recomendado por Cryptact de «solo variación del margen». Si registra el cambio neto de la garantía después de comisiones y financiación, Fee puede ser «0». Si desea desglosar las comisiones y la financiación por separado, utilice el desglose de incomeType de «Get Account Income» (position_close_long / position_funding / order_fill_fee_income, etc.); para la mayoría de usuarios, sin embargo, basta el método sencillo de variación del margen. Cryptact también documenta una opción avanzada: añadir las columnas DerivType = fx/future/option/cfd y DerivDetails al archivo personalizado en inglés. No obstante, ese método no refleja por sí solo el cambio en la garantía cripto, por lo que en la mayoría de casos es preferible el método sencillo anterior.

Ejemplos prácticos (todas las cifras son hipotéticas)

Estos ejemplos solo ilustran el formato; no son operaciones ni precios reales.

Ejemplo 1: Compra de BTC en spot (hipotético)

«El 15-01-2026 (JST), se compraron 0,01 BTC en BTC/USDT a un precio de 95.000 USDT, con una comisión de 0,0951 USDT (hipotético).»

Ejemplo 2: Venta de BTC en spot (hipotético)

«El 03-02-2026 (JST), se vendieron 0,01 BTC en BTC/USDT a 98.000 USDT, con una comisión de 0,098 USDT (hipotético).»

Ejemplo 3: PnL realizado en futuros: ganancia (hipotético)

«En una liquidación de futuros de BTCUSDT, el margen en USDT aumentó en +30 USDT de PnL realizado (hipotético).»

Ejemplo 4: PnL realizado en futuros: pérdida (hipotético)

«En otra liquidación, el margen en USDT disminuyó en −18 USDT de PnL realizado, incluida la liquidación forzosa (hipotético).»

Preste atención a la conversión de UTC → JST

La API de WEEX devuelve todas las marcas de tiempo en UTC. La hora estándar de Japón (JST) está 9 horas por delante de UTC. El archivo personalizado de Cryptact no muestra una zona horaria explícita en la columna Timestamp, pero como Cryptact calcula sobre la base de JST, la opción más segura es convertir las horas UTC de WEEX a JST (+9 h) para que las filas de WEEX coincidan con el resto de sus datos de Japón (esta es la recomendación de esta guía, ya que la especificación no lo indica expresamente). Por ejemplo, una ejecución a las 2026-02-09 18:00:00 UTC corresponde a 2026/02/10 03:00:00 JST. El historial de los exchanges extranjeros suele basarse en UTC y la fecha puede cambiar un día al cruzar el año (31 de diciembre / 1 de enero), así que tenga especial cuidado con las operaciones de fin de año.

Consideración fiscal (resumen factual)

Para un residente en Japón, los beneficios de las criptomonedas suelen clasificarse como «ingresos varios» (雑所得) y tributan mediante tributación global (総合課税): se suman a otros ingresos, como el salario, y se aplican tipos progresivos (con el impuesto de residencia, el tipo máximo puede alcanzar aproximadamente el 55%). Operar en un exchange extranjero no elimina la obligación tributaria. A diferencia de los exchanges nacionales, las plataformas extranjeras no emiten un informe anual de transacciones y utilizan marcas de tiempo UTC, por lo que es aún más importante conservar sus propios registros; por eso es tan importante contar con un historial preciso.

• Los registros importan: conservar la fecha y hora, el símbolo, la cantidad, el precio, la comisión y el PnL realizado de cada operación facilita enormemente la temporada de declaraciones (normalmente de mediados de febrero a mediados de marzo).
• Uso de una herramienta de cálculo: Cryptact (株式会社pafin) es una de las herramientas japonesas para calcular pérdidas y ganancias cripto, con más de 200.000 usuarios, según la empresa. Esta guía la menciona de forma objetiva; no existe asociación ni respaldo por parte de WEEX. También existen otras herramientas: elija libremente.
• La decisión final corresponde a un profesional: el tratamiento individual (clasificación, gastos deducibles y gestión de pérdidas) varía según el caso. Confírmelo siempre con un profesional fiscal autorizado (税理士) o con la Agencia Tributaria Nacional. Esto no es asesoramiento fiscal.
• Abrir una cuenta de WEEX

Sobre operar en WEEX (futuros como prioridad)

WEEX es un exchange de criptomonedas que ofrece principalmente futuros (derivados). Los futuros y el apalancamiento amplifican tanto las ganancias como las pérdidas, y un movimiento brusco puede provocar una liquidación (cierre forzoso) que materializa una pérdida. Comprenda la mecánica y los riesgos antes de operar. La recuperación del historial y el cálculo del PnL siguen los pasos anteriores.

Preguntas frecuentes

¿Cryptact admite WEEX automáticamente?

En el momento de esta comprobación (19-07-2026), WEEX no aparecía en la lista de exchanges compatibles de Cryptact. Por tanto, en lugar de sincronización automática mediante API o importación automática de archivos, debe importar los datos mediante el «archivo personalizado» genérico que usted rellena.

¿Tiene WEEX una exportación del historial de operaciones a CSV con un solo clic?

Esta investigación no pudo confirmar que WEEX ofreciera un exportador oficial de CSV con un solo clic. En la práctica, puede (1) registrar los datos manualmente desde las pantallas de historial de la aplicación o la web (volúmenes pequeños) o (2) obtenerlos mediante la WEEX OpenAPI con una clave de solo lectura. Compruebe las pantallas actuales tras iniciar sesión para ver si existe un botón de exportación.

¿Cómo registro el PnL de futuros (apalancamiento)?

Según el método recomendado por Cryptact, céntrese únicamente en el cambio del margen en USDT: registre las ganancias como BONUS y las pérdidas como LOSS (incluida la liquidación), con Base = USDT, Counter = JPY y Price en blanco (consulte la Correspondencia (2)).

¿Tengo que convertir las horas a JST?

Las horas de la API de WEEX están en UTC. Como Cryptact calcula sobre la base de JST, la opción más segura es convertirlas a JST (+9 h). Preste especial atención al cambio de año, cuando la fecha puede desplazarse un día.

¿Qué hago si no conozco la moneda de la comisión?

La API del historial de operaciones spot de WEEX puede no devolver la moneda de la comisión. Compruebe en la aplicación en qué moneda se cobró la comisión (la moneda recibida, WXT, etc.) e introdúzcala en FeeCcy. Introduzca «0» en Fee incluso cuando no haya comisión.

Este contenido tiene únicamente fines informativos y no constituye asesoramiento fiscal ni de inversión. Confirme el tratamiento fiscal con un profesional fiscal autorizado (税理士) o con la Agencia Tributaria Nacional de Japón. No existe asociación entre WEEX y Cryptact (株式会社pafin); el nombre de Cryptact y las cifras se citan de forma objetiva. Las especificaciones se basan en la documentación oficial de cada empresa (comprobada el 19-07-2026) y pueden cambiar; vuelva a verificarlas antes de trabajar. Los futuros y el apalancamiento conllevan el riesgo de pérdidas amplificadas.