Skip to main content

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.

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

​
How to Connect a Blockchain Wallet

1

Click Integrations in the left sidebar, then click Add Integration.

2

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).
3

Paste your public address

Example - This starts with 0x... for Ethereum or a blockchain domain like an ENS name.
4

Click Submit.

KoinX scans the blockchain and starts importing your transactions. Large wallets with high activity may take a few minutes to sync completely.
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.

​
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).
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.

​
Common Issues / Edge Cases

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

​
Frequently Asked Questions

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.
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.
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.
Last modified on March 13, 2026