> ## 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.

# Blockchain and Wallet - Deep Dive

> Learn how to connect on-chain wallets and domains to KoinX so DeFi, NFT and token transfers are captured correctly in your portfolio and crypto tax calculations.

<Card icon="sparkles" title="AI Summary">
  * Paste your address under the relevant blockchain integration (Ethereum, BSC, Polygon, etc.)
  * KoinX scans the blockchain and imports ERC-20 transfers, DeFi activity, NFT transactions, and native token transfers
  * Supports up to **30,000 transactions** per wallet address — contact support if you have more
  * Each wallet address is added **separately** — even if they're all in the same MetaMask
  * You can also use **blockchain domain names** (like ENS) instead of the raw address
</Card>

***

## How to Connect a Blockchain Wallet

<Steps>
  <Step title="Click Integrations in the left sidebar, then click Add Integration." />

  <Step title="Search for the blockchain or wallet">
    Example - Metamask or Trust Wallet or Ethereum Blockchain.

    Select it from the results. You'll see the integration page with fields: **Add Wallet Name** (auto-filled, e.g., "Ethereum-2") and **Public Address or Blockchain Domain** (marked with a red asterisk — this is mandatory).
  </Step>

  <Step title="Paste your public address">
    Example - This starts with `0x...` for Ethereum or a blockchain domain like an ENS name.
  </Step>

  <Step title="Click Submit.">
    KoinX scans the blockchain and starts importing your transactions. Large wallets with high activity may take a few minutes to sync completely.
  </Step>
</Steps>

<Warning>
  Your public wallet address is like a bank account number — it's safe to share.

  Your private key or seed phrase is like your PIN — **never** share it with anyone, including KoinX.

  KoinX will never ask for private keys or seed phrases.
</Warning>

***

## What Gets Imported

For Ethereum (and similar EVM chains), KoinX imports:

* **ERC-20 token transfers** — all token sends and receives
* **DeFi activity** — swaps, liquidity pool interactions, staking, yield farming
* **NFT transactions** — mints, buys, sells, transfers
* **Native token transfers** — ETH sends/receives, internal transactions

The specifics vary by blockchain. Each chain's integration page shows exactly what's supported.

***

## Multiple Wallets

If you have multiple wallet addresses — even within the same MetaMask or hardware wallet — you need to add **each address separately**.

For example, if your MetaMask has 3 Ethereum addresses, add each one as a separate Ethereum integration. KoinX can't derive multiple addresses from a single entry.

### Multi-chain wallets

If the same wallet address is used across multiple chains (e.g., the same `0x...` address on Ethereum, BSC, and Polygon), you need to add it under **each blockchain separately**. Go to Add Integration, select Ethereum and paste the address, then repeat for BSC, then Polygon.

***

## The 30,000 Transaction Limit

KoinX by default has a capping of **30,000 transactions** per wallet address. This is done to prevent misuse of the system.

If your wallet has more than this (common for DeFi power users, MEV bots, or very active traders), contact KoinX support and we'll be able assist you with the integration.

You can check your approximate transaction count on a block explorer (like Etherscan) before adding your wallet.

***

## Reviewing Imported Transactions

After connecting your wallet:

1. Go to the **Transactions** page.
2. Filter by the blockchain integration you just added.
3. Check that deposits, withdrawals, trades, and transfers are visible.
4. Look for any flagged or warning transactions — these typically need manual categorisation (common with complex DeFi interactions).

<Note>
  DeFi transactions are inherently more complex than exchange trades. Expect to spend some time reviewing and categorising swaps, LP entries/exits, staking deposits, and bridge transactions.

  KoinX does its best to auto-categorise, but manual review improves accuracy.
</Note>

***

## Common Issues / Edge Cases

<Accordion title="Missing transactions">
  Ensure you entered the **correct wallet address**. Even one wrong character means a completely different wallet. Copy-paste directly from your wallet app or block explorer.
</Accordion>

<Accordion title="Incorrect balances or gains">
  Some DeFi protocols may require a re-sync. Go to your integration and refresh it. If balances still look wrong, check if you have activity on other chains that you haven't added yet.
</Accordion>

<Accordion title="Bridge transactions showing as taxable events">
  Cross-chain bridge transactions (moving tokens from Ethereum to Polygon, for example) sometimes appear as separate send/receive events. You may need to manually tag these as transfers rather than trades to avoid incorrect tax calculations.
</Accordion>

<Accordion title="Spam tokens appearing in your wallet">
  Blockchain wallets often receive unsolicited spam tokens. KoinX has spam detection, but if spam tokens appear in your transactions, use the **Mark as Spam** option (available under the three-dot menu on any transaction).
</Accordion>

<Accordion title="Syncing takes a long time">
  Large wallets with thousands of transactions take longer to sync. This is normal. Give it a few minutes. If it still hasn't completed after 10+ minutes, try disconnecting and re-adding the wallet.
</Accordion>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Does connecting my wallet share my private keys?">
    Never. KoinX only reads your **public wallet address** — it's like sharing your UPI ID, not your PIN. Your private keys and seed phrase stay with you. KoinX will never ask for them.
  </Accordion>

  <Accordion title="What if my wallet has more than 30,000 transactions?">
    Contact KoinX support. They'll assist you with the integration for high-volume wallets. The 30,000 limit exists for performance reasons, not as a hard block.
  </Accordion>

  <Accordion title="Do I need to add each chain separately for the same address?">
    Yes. If your 0x... address is active on Ethereum, BSC, and Polygon, add it three times — once under each blockchain integration. KoinX scans each chain independently.
  </Accordion>

  <Accordion title="Can I use an ENS name instead of my wallet address?" />
</AccordionGroup>