> ## Documentation Index
> Fetch the complete documentation index at: https://guides.koinx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Generate Your Ethereum Tax Report with KoinX

> Connect your Ethereum to KoinX in a few steps to generate and file your Ethereum taxes accurately.

<Info>
  **Wallet Address**  ·  **\~5 min**  ·  ETH · ERC-20 · DeFi  ·  **100+ countries**
</Info>

## What's covered

<CardGroup cols={2}>
  <Card title="ETH transfers" icon="arrow-right-arrow-left" color="#0066CC">
    Native Ethereum sends and receives.
  </Card>

  <Card title="ERC-20 and DeFi" icon="chart-line" color="#0066CC">
    Token transfers, DeFi interactions, and NFT activity.
  </Card>
</CardGroup>

## Before you start

<CardGroup cols={2}>
  <Card title="Ethereum wallet address" icon="wallet">
    Your public Ethereum address (starts with `0x`). Never your private key or seed phrase.
  </Card>

  <Card title="KoinX account" icon="sparkles" href="https://app.koinx.com/get-started">
    Free account — no credit card needed.
  </Card>
</CardGroup>

***

## Connect Ethereum to KoinX

<Steps>
  <Step title="Open KoinX Integrations">
    Log in to [app.koinx.com](https://app.koinx.com) → **Integrations** → **Add Integration**.
  </Step>

  <Step title="Select Ethereum">
    Search for **Ethereum** in the integrations list and select it.
  </Step>

  <Step title="Enter your public wallet address">
    Paste your public Ethereum wallet address (starts with `0x`) into the address field, then click **Connect**.

    <Warning>
      KoinX only requires your **public wallet address**. Never enter your private key or seed phrase — not here, not on any platform.
    </Warning>
  </Step>

  <Step title="Wait for sync to complete">
    KoinX fetches all on-chain transactions linked to your address. Most wallets sync within a few minutes; very high-activity wallets may take longer.
  </Step>
</Steps>

<Check>
  **Done.** KoinX has your complete Ethereum transaction history. Capital gains calculation and tax report generation are now automatic.
</Check>

Head to [Tax Reports](https://app.koinx.com/tax-report) to generate your Schedule VDA-ready crypto tax report.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does KoinX support Ethereum blockchain?">
    Yes. KoinX supports Ethereum blockchain integration. Add your public wallet address in the Integrations section and KoinX automatically fetches all on-chain transactions, classifies them, and includes them in your crypto tax report.
  </Accordion>

  <Accordion title="Does KoinX need my Ethereum private key or seed phrase?">
    No. KoinX only requires your public wallet address. Your private keys and seed phrases are never requested. If any platform asks for your private key, do not proceed.
  </Accordion>

  <Accordion title="What transaction types does KoinX import from Ethereum?">
    KoinX imports all on-chain activity: ETH transfers, ERC-20 token transfers, DeFi transactions, NFT activity, staking rewards, and any other activity recorded on the Ethereum blockchain.
  </Accordion>

  <Accordion title="Does KoinX import full Ethereum transaction history or only recent transactions?">
    KoinX fetches your complete on-chain transaction history from your Ethereum wallet address. If you have more than 30,000 transactions, contact KoinX support for assisted integration.
  </Accordion>

  <Accordion title="Can I add multiple Ethereum wallets in KoinX?">
    Yes. Add each wallet address separately under the Ethereum integration. All wallets are aggregated in your KoinX portfolio and included in your tax report.
  </Accordion>
</AccordionGroup>

***

## Verify your Ethereum transactions

<Steps>
  <Step title="Navigate to the Ethereum integration">
    In KoinX, go to **Integrations** → **Ethereum**. Your connected wallet address and transaction count are displayed here.
  </Step>

  <Step title="Verify transaction types are present">
    Confirm that deposits, withdrawals, trades, and transfers from your Ethereum wallet are listed. KoinX classifies each transaction type automatically.
  </Step>

  <Step title="Review any unclassified transactions">
    If any transactions are marked unclassified, click on them to assign the correct category. This ensures your tax calculation is accurate.
  </Step>

  <Step title="Confirm portfolio reflects Ethereum holdings">
    Navigate to **Portfolio** to confirm your ETH and ERC-20 assets appear with correct current values and unrealised gains.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="What does a successful Ethereum wallet sync look like in KoinX?">
    After a successful sync, the Ethereum integration page shows your wallet address, a transaction count, and a last-synced timestamp. Your **Portfolio** page reflects your ETH holdings, and the **Transactions** page lists every on-chain activity item with a classification label.
  </Accordion>

  <Accordion title="Some of my Ethereum transactions are showing as unclassified — what do I do?">
    Click on any unclassified transaction and assign the correct category: trade, transfer, income, DeFi, or other. KoinX uses your classification to apply the correct tax treatment. Contact KoinX support if a large number remain unclassified.
  </Accordion>

  <Accordion title="My Ethereum portfolio balance in KoinX doesn't match my actual wallet — why?">
    This usually means a transaction was classified incorrectly or a wallet address was entered with an error. Go to **Integrations** → **Ethereum**, verify the address, and refresh the sync. Contact KoinX support if the mismatch persists.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="My Ethereum transactions aren't showing up after sync">
    **Why this happens:** The wallet address entered was incorrect or the sync is still in progress.

    **Fix:** Go to **Integrations** → **Ethereum** and verify the wallet address shown matches your actual Ethereum wallet (starts with `0x`). If wrong, remove the integration and re-add with the correct address. If correct, wait a few minutes and refresh the page.
  </Accordion>

  <Accordion title="KoinX is only showing some of my Ethereum transactions, not all">
    **Why this happens:** Wallets with more than 30,000 transactions hit KoinX's standard sync limit, or a sync error occurred mid-process.

    **Fix:** Check the transaction count on the Ethereum integration page. If over 30,000 transactions, contact KoinX support for assisted integration. If under the limit, disconnect and reconnect the wallet to trigger a fresh sync.
  </Accordion>

  <Accordion title="My Ethereum wallet sync is taking too long">
    **Why this happens:** Ethereum wallets with high DeFi or NFT activity take longer to process.

    **Fix:** Wait up to 10 minutes for high-activity wallets. If the sync hasn't completed after that, go to **Integrations** → **Ethereum**, remove the wallet, and reconnect. Contact KoinX support if the issue persists.
  </Accordion>

  <Accordion title="KoinX shows a sync error for my Ethereum wallet">
    **Why this happens:** A temporary connection issue between KoinX and the Ethereum node occurred during sync.

    **Fix:** Go to **Integrations** → **Ethereum** and click **Reconnect**. If the error persists, remove the wallet and re-add it.
  </Accordion>

  <Accordion title="DeFi transactions from my Ethereum wallet aren't classified correctly">
    **Why this happens:** Some DeFi protocols use non-standard transaction structures that require re-sync or manual classification.

    **Fix:** Trigger a re-sync from **Integrations** → **Ethereum**. If specific transactions remain unclassified, manually assign the correct category by clicking on the transaction.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="Binance Smart Chain" icon="link" href="/integration/binance-smart-chain">
    Connect your BSC wallet — BEP-20 tokens and DeFi activity.
  </Card>

  <Card title="Polygon" icon="link" href="/integration/polygon-matic">
    Connect your Polygon wallet.
  </Card>

  <Card title="Arbitrum" icon="link" href="/integration/arbitrum">
    Connect your Arbitrum wallet.
  </Card>

  <Card title="Optimism" icon="link" href="/integration/optimism-op">
    Connect your Optimism wallet.
  </Card>
</CardGroup>

<Card title="Ready to generate your Ethereum crypto tax report?" color="#6366f1" icon="rocket" href="https://app.koinx.com/tax-report">
  Turn your Ethereum data into an audit-ready crypto tax report.
</Card>