How to Import Your WEEX Trade History into Cryptact (for Japan Crypto Tax Filing)

Bottom line: WEEX is currently not an auto-integrated exchange on Cryptact (it is not on Cryptact's supported-exchange list, so there is no API auto-sync or automatic file import for it). To use your WEEX cryptocurrency trade history for profit-and-loss calculation in Cryptact, you fill in Cryptact's generic "custom file" — a 10-column CSV/Excel template — with your WEEX trades and upload it. This guide covers (1) how to get your trade history out of WEEX, (2) the exact Cryptact custom-file format, (3) the WEEX-field-to-Cryptact-column mapping, (4) worked examples (all hypothetical), and (5) where these gains sit for tax. This is information only, not tax advice. Confirm your specific treatment with a licensed tax professional (税理士) or Japan's National Tax Agency.

The Cryptact and WEEX specifications here were checked directly against each company's public documentation (see the date at the end of this page and the facts ledger). Specs can change — always re-check the current official pages before you work. There is no partnership between WEEX and Cryptact. Cryptact is named factually, as one widely used Japanese tax-calculation tool.

Why the "custom file" route

For supported exchanges, Cryptact can pull history via API-key sync or automatic file import. But WEEX is not on Cryptact's supported-exchange list (Cryptact's WEEX page returns an error / no entry, checked 2026-07-19). For unsupported exchanges — and for derivatives / margin trades — Cryptact's officially documented method is its generic custom file, which you fill in yourself. WEEX falls squarely into the "unsupported exchange" case, so the custom file is the route.

The workflow (3 steps)

1. Get your trade history out of WEEX (the app/web history screens, or the API).
2. Reshape it into Cryptact's 10-column custom file (using the mapping tables below).
3. Upload it to Cryptact as a custom file.

Step 1: Get your trade history out of WEEX

Your realistic options depend on volume. As of this research, we could not confirm an official one-click "export trade history to CSV" feature in WEEX (no such article was found in the Help Center; the presence or absence of an export button on the logged-in trading screens was not verified in this research). In practice, that leaves:

• Method A — record manually from the app/web history screens (best for small volumes). Use WEEX's Order History / Trade History / Asset (funds) history screens to read off each fill's date-time, symbol, side, quantity, price and fee, and type them into the custom file.
• Method B — pull via the WEEX OpenAPI (better for large volumes / automation). WEEX launched its OpenAPI (beta) in March 2026; you can read your history with a read-only key and reshape it into the custom file. The main endpoints are below.

WEEX OpenAPI history endpoints (read-only)

Authentication uses signed headers (ACCESS-KEY / ACCESS-SIGN / ACCESS-PASSPHRASE / ACCESS-TIMESTAMP). The history endpoints are USER_DATA (read) permission, so a read-only API key (no trade permission) is enough to fetch history.

Futures fills are available for the last 365 days, in windows of up to 7 days per request; the income ledger allows up to 100 days per request. All timestamps are returned in UTC milliseconds (JST conversion is covered below).

Step 2: The Cryptact custom-file format (10 columns)

Cryptact's custom file has 10 columns (A–J), per Cryptact's official help article "How to create a custom file" (Japanese/English Excel and CSV samples are downloadable). All columns except "Comment" are required.

Cryptact's key rules (follow exactly):

• Timestamp format is YYYY/MM/DD HH:mm:ss.
• Fee must be entered even when it is 0 (a blank Fee cell causes an upload error).
• Price auto-reference: only when Base is a Cryptact-supported coin AND Counter is a fiat currency (e.g. JPY) can you leave Price blank and let Cryptact fill in the market price. If the base is unsupported, or the counter is a crypto (e.g. USDT), you must enter the Price yourself.
• Do not put the characters ' " \ in the Comment (the upload will fail).
• Opening/editing the CSV directly can corrupt it (mojibake). Edit it per Cryptact's help instructions. For values with 15+ decimal places, use Cryptact's dedicated sample file.

Step 3: WEEX field → Cryptact column mapping

WEEX is a futures-first (derivatives) exchange. Futures (margin) and spot are recorded differently in Cryptact, so use whichever mapping applies. Rows marked [ASSUMPTION] / [JUDGED] are not stated in the source specs — they are this guide's inference/recommendation; verify before relying on them.

Mapping (1): Spot trades

Source: WEEX "Get Trade History" GET /api/v3/myTrades (or the trade-history screen). For symbol BTCUSDT, split it into Base = BTC, Counter = USDT.

Mapping (2): Futures / derivatives (margin)

Cryptact officially recommends a "focus only on the change in margin/collateral" method for derivatives. WEEX futures are USDT-margined, so record the net change in realized PnL (USDT) — gains as BONUS, losses as LOSS (a liquidation / forced close that reduces margin is also LOSS). Source it from WEEX "Get Trade Details" realizedPnl, or "Get Account Income" income.

[JUDGED / notes] The table above is Cryptact's recommended "margin-delta only" method. If you record the net collateral change (after fees and funding), Fee can be "0". If you want to itemize fees and funding separately, use the incomeType breakdown from "Get Account Income" (position_close_long / position_funding / order_fill_fee_income, etc.) — but for most users the simple margin-delta method is enough. Cryptact also documents an advanced option (add DerivType = fx/future/option/cfd and DerivDetails columns to the English custom file), but that method does not by itself reflect the collateral-crypto change, so the simple method above is preferable in most cases.

Worked examples (all figures are hypothetical)

These illustrate the format only — they are not real trades or prices.

Example 1: Spot buy of BTC (hypothetical)

"On 2026-01-15 (JST), bought 0.01 BTC on BTC/USDT at a price of 95,000 USDT, fee 0.0951 USDT (hypothetical)."

Example 2: Spot sell of BTC (hypothetical)

"On 2026-02-03 (JST), sold 0.01 BTC on BTC/USDT at 98,000 USDT, fee 0.098 USDT (hypothetical)."

Example 3: Futures realized PnL — gain (hypothetical)

"On a BTCUSDT futures settlement, USDT margin increased by +30 USDT realized PnL (hypothetical)."

Example 4: Futures realized PnL — loss (hypothetical)

"On another settlement, USDT margin decreased by −18 USDT realized PnL, incl. liquidation (hypothetical)."

Watch the UTC → JST conversion

WEEX's API returns all timestamps in UTC. Japan Standard Time (JST) is 9 hours ahead of UTC. Cryptact's custom file does not print an explicit timezone for its Timestamp column, but because Cryptact calculates on a JST basis, converting WEEX's UTC times to JST (+9h) is the safe choice so your WEEX rows line up with the rest of your Japan data (this is this guide's recommendation, since the spec does not state it explicitly). For example, a fill at UTC 2026-02-09 18:00:00 is 2026/02/10 03:00:00 in JST. Overseas-exchange history is usually UTC-based, and the date can shift by a day across the year boundary (Dec 31 / Jan 1), so take extra care with year-end trades.

Where this sits for tax (factual summary)

For a Japan resident, profit from cryptocurrency is generally classified as "miscellaneous income" (雑所得) and taxed under comprehensive taxation (総合課税) — added to other income such as salary at progressive rates (which, with resident tax, can reach roughly 55% at the top). Trading on an overseas exchange does not remove it from taxation. Unlike domestic exchanges, overseas venues do not issue an annual transaction statement and use UTC timestamps, so the need to keep your own records is higher — which is exactly why accurate history matters.

• Records matter: keeping each trade's date-time, symbol, quantity, price, fee and realized PnL makes the filing season (typically mid-February to mid-March) far easier.
• Using a calculation tool: Cryptact (株式会社pafin) is one of Japan's crypto profit-and-loss tools, with 200,000+ users (per the company). This guide references it factually; there is no partnership or endorsement with WEEX. Other tools exist too — choose at your own discretion.
• Final judgment is a professional's: individual treatment (classification, deductible costs, loss handling) varies by case. Always confirm with a licensed tax professional (税理士) or the National Tax Agency. This is not tax advice.
• Open a WEEX account

About trading on WEEX (futures-first)

WEEX is a cryptocurrency exchange offering futures (derivatives) first. Futures and leverage amplify both gains and losses, and a sharp move can trigger liquidation (forced close) that realizes a loss. Understand the mechanics and risks before trading. History retrieval and P&L calculation follow the steps above.

FAQ

Is WEEX auto-supported on Cryptact?

As of this check (2026-07-19), WEEX is not on Cryptact's supported-exchange list. So instead of API auto-sync or automatic file import, you import via the generic "custom file" you fill in yourself.

Does WEEX have a one-click CSV export of trade history?

This research could not confirm an official one-click CSV export in WEEX. In practice you either (1) record manually from the app/web history screens (small volumes) or (2) pull via the WEEX OpenAPI with a read-only key. Check the current logged-in screens for whether an export button exists.

How do I record futures (leverage) P&L?

Using Cryptact's recommended method, focus only on the change in USDT margin: gains as BONUS, losses as LOSS (including liquidation), with Base = USDT, Counter = JPY, and Price left blank (see Mapping (2)).

Do I need to convert times to JST?

WEEX API times are UTC. Since Cryptact calculates on a JST basis, converting to JST (+9h) is the safe choice. Take extra care around the year boundary, where the date can shift by a day.

What if I don't know the fee currency?

WEEX's spot trade-history API may not return the fee currency. Check in the app which currency the fee was charged in (the received currency, or WXT, etc.) and enter it in FeeCcy. Enter "0" for Fee even when there is no fee.

This content is for information only and is not tax or investment advice. Confirm tax treatment with a licensed tax professional (税理士) or Japan's National Tax Agency. There is no partnership between WEEX and Cryptact (株式会社pafin); Cryptact's name and figures are cited factually. Specs are based on each company's official documentation (checked 2026-07-19) and can change — re-check before you work. Futures and leverage carry the risk of amplified losses.