Skip to main content

Documentation Index

Fetch the complete documentation index at: https://uncoded.ch/docs/llms.txt

Use this file to discover all available pages before exploring further.

unCoded’s Tax Export gives you a clean dataset of your closed trades formatted for tax reporting. It does NOT file your taxes. You (or your accountant) take the dataset and use it to prepare your return. This page is the operator’s tax-export playbook.

​
What unCoded does for your taxes

✅ Exports closed-trade history

Every closed round-trip with timestamps, prices, quantities, P&L. Comprehensive.

✅ USD→EUR currency conversion

Each trade’s USD-quoted prices are converted to EUR using ECB-published exchange rates (via the Frankfurter API) on the relevant date. Useful for EU operators reporting in EUR.

✅ Multiple output formats

CSV (spreadsheet-friendly) and JSON (programmatic). Your accountant or tax software can ingest either.

✅ Symbol and mode tags

Each trade includes the symbol and the mode that ran it. Useful for categorization in your tax filing.

​
What unCoded does NOT do for your taxes

  • ❌ Does not file your taxes. Reports are exported for you; filing is your responsibility.
  • ❌ Does not interpret your jurisdiction’s tax rules. Crypto tax treatment varies by jurisdiction.
  • ❌ Does not track wash sales or holding-period categorization. Long-term vs short-term capital gains rules vary; the export doesn’t pre-categorize.
  • ❌ Does not handle deposit/withdrawal events. The export covers your closed trades, not balance changes from deposits or withdrawals.
  • ❌ Does not consolidate across multiple venues automatically. If you trade on Binance and Bybit, you export from each separately and consolidate yourself or hand to accountant.
  • ❌ Does not include pre-unCoded trades. Trades made before you started using unCoded aren’t in the unCoded database; pull those from your venue’s transaction history.

​
What’s in the export

For each closed trade in the selected period:
  • Trade ID — auto-incrementing identifier.
  • Symbol — BTCUSDT, ETHUSD, etc.
  • Mode — which mode ran the trade.
  • Buy time — when the entry filled.
  • Sell time — when the position closed.
Both in your operator’s configured timezone.
  • Buy price (USD, 8-decimal precision).
  • Sell price (USD, 8-decimal precision).
  • Quantity (base asset units).
  • Total USD value (price × quantity).
  • Profit (USD) — realized gain/loss in USD.
  • Profit percentage — return as a percent of position size.
  • Buy price (EUR) at the ECB rate on the buy date.
  • Sell price (EUR) at the ECB rate on the sell date.
  • Profit (EUR) computed from the EUR-quoted prices.
Useful for EU operators required to report in EUR.

​
The tax-export workflow

1

Open the Dashboard's Tax Report panel

Navigate to “Tax Report” or equivalent in your Dashboard.
2

Select the period

Common selections:
  • Calendar year (Jan 1 – Dec 31).
  • Specific quarter.
  • Specific month (for ongoing tracking).
3

Choose format — CSV for spreadsheet, JSON for programmatic

CSV is most operator-friendly. JSON if you have custom tax software that ingests structured data.
4

Generate and download

The export takes a few seconds for a year of trades. Download to your local archive.
5

Verify against Telegram running totals

Cross-check the report’s net P&L against your Telegram running total at year-end. They should match.If they don’t: investigate. Usually a database-restore boundary or manual close not reflected.
6

Archive in your records

Save to your tax-records folder. Cloud drive (Dropbox, Google Drive, etc.) with versioning is ideal — you can verify which export was used to file in case of audit.
7

Hand to accountant or import to tax software

Most accountants accept CSV. Most tax software can import CSV or JSON.

​
Multi-venue tax handling

If you trade on multiple venues (Binance + Bybit, etc.), each venue produces its own export:
Generate one Tax Report per venue. Each represents trades on that specific venue.Don’t try to merge into one composite report — your accountant typically wants per-venue records for cleanest filing.
If you use sub-accounts on a venue, each sub-account has its own trade history. Most venues let you scope the export to a specific sub-account.Keep per-sub-account records for the most granular tax reporting.
For your own records (separate from filing), maintain an annual spreadsheet that totals across all venues and sub-accounts. Useful for high-level review.

​
Common tax considerations (jurisdiction-dependent)

Tax treatment of cryptocurrency varies dramatically by jurisdiction. This page provides operational guidance, not tax advice. Consult an accountant familiar with your jurisdiction’s crypto tax rules.That said, common considerations operators should know about:
Most jurisdictions tax realized gains (when a position closes) rather than unrealized (paper gains on open positions). The unCoded Tax Export shows realized only.Open positions at year-end are not in the export — they’re not yet taxable.
Some jurisdictions (US, Germany after 1-year holding period) distinguish short-term vs long-term capital gains. Different tax rates apply.The Tax Export shows entry and exit times — your accountant uses these to categorize. unCoded does not pre-categorize.For unCoded operators: most modes hold for hours to weeks. Short-term treatment is the dominant category.
Different jurisdictions allow different cost-basis methods. The Tax Export provides per-trade buy and sell prices; how to assign costs across overlapping positions is a tax-software decision.For most operators with simple BasicMode-style trading on one symbol per pair, FIFO is the default. Check your jurisdiction.
In many jurisdictions, swapping one crypto for another (e.g., BTC for ETH) is a taxable event. The Tax Export shows these as paired trades.For unCoded operators with USDT-quoted strategies, this isn’t typically a concern — your trades are USDT in/out.
Moving crypto between exchanges (e.g., BTC from Binance to Bybit) is typically NOT a taxable event — same asset, different custodian.The Tax Export does NOT include transfer events. If your accountant needs them, pull from the venue’s deposit/withdrawal history separately.
Trading fees are typically deducted from the realized P&L (treated as cost). The unCoded Tax Export’s realized P&L is net of fees — fees are already subtracted.Check with your accountant if your jurisdiction wants fees broken out separately.

​
Working with an accountant

  • ✅ Hire a crypto-aware accountant — generalist accountants may not understand the specifics.
  • ✅ Provide annual exports proactively — don’t wait for tax season.
  • ✅ Provide context — “I run an automated trading bot called unCoded; here are 12 monthly Tax Reports.”
  • ✅ Provide venue documentation — your venue’s account statements complement unCoded’s exports.
  • ✅ Document your strategy/setup briefly — accountants benefit from understanding what you’re doing.
  • ✅ Maintain a year-round dialogue — quarterly check-ins are easier than year-end scrambles.
  • ✅ Save the accountant’s filed returns — for your records and audit defense.
  • ✅ Plan tax obligations into your reserves — set aside reserve capital to cover quarterly tax payments.

​
Best practices

  • ✅ Monthly export to your tax archive (not just annually).
  • ✅ Cross-check against Telegram running totals monthly.
  • ✅ Per-venue, per-sub-account exports for cleanest record keeping.
  • ✅ Cloud-backup your tax archive — versioned cloud drives ideal.
  • ✅ Year-end cross-check across all sources — Telegram, Dashboard, monthly archives, full-year report.
  • ✅ Send to accountant well before deadline — 1+ month of buffer is comfortable.
  • ✅ Consult crypto-aware accountant in your jurisdiction for filing.
  • ✅ Keep accountant-filed returns for 7+ years — most jurisdictions’ audit window.
  • ✅ Reserve capital for tax payments — quarterly liquidity planning.
  • ✅ Don’t try to interpret jurisdiction rules yourself — that’s what professionals are for.

​
What’s next

Daily operations

The monthly tax-export rhythm fits into the broader operator routine.

Dashboard module

Where the Tax Report panel lives.

Reserves

Plan tax-payment liquidity into reserve sizing.

Pricing

The license fee structure and your year-end accounting.

Support

For tax-export issues that need help.

FAQ

Common operator questions including tax topics.
Last modified on May 3, 2026