Different Available Methods

KoinX doesn’t force you into a single way of connecting your data. Depending on your exchange, wallet, or situation, you’ll have different integration methods available — and each one works differently. This guide explains what each method is, how it syncs your data, and what you should know before choosing one.

---

​

Quick Comparison

---

​

Direct Connect

Direct Connect lets you link your exchange account to KoinX through a secure login flow. You sign into your exchange through KoinX’s interface, grant read-only access, and KoinX pulls your transaction data automatically.

​

How it works:

• KoinX redirects you to your exchange’s login page
• You authenticate with your exchange credentials (these are never shared with KoinX)
• The exchange grants KoinX read-only access to your transaction data
• KoinX syncs your data automatically going forward

​

What to know:

• This is the simplest setup — no API keys, no file downloads
• KoinX can only read your data — it cannot place trades, make withdrawals, or modify anything on your exchange
• If you revoke access on your exchange’s end, KoinX will stop syncing new data (but keeps what it already imported)

---

​

API Integration

API integration uses a read-only API key that you generate on your exchange and enter into KoinX. This gives KoinX permission to fetch your transaction data directly from the exchange.

​

How it works:

• You log into your exchange and create a new API key with read-only permissions
• You copy the API Key and Secret Key into KoinX’s integration setup screen. Some exchanges (like Bitget) also have a Password/Passphrase field.
• Click Import Now to connect
• KoinX connects to your exchange and pulls your transaction history

​

What to know:

• Never enable withdrawal permissions on API keys you give to KoinX — read-only is all that’s needed
• Some exchanges have API lookback limits (e.g., Bitget only provides the last 2 years of data) — older transactions won’t come through. Use a File Upload to backfill the gap.
• Some exchanges (like Bitget) offer a Tax API Key option that’s simpler — it removes the passphrase requirement
• If your exchange rotates or expires API keys, you’ll need to generate a new one and update it in KoinX

---

​

File Upload

File Upload is a manual process where you download your transaction history from your exchange (as a CSV or similar file) and upload it directly to KoinX.

​

How it works:

• You log into your exchange and download your transaction history file
• In KoinX, go to Integrations → Add Integration, search your exchange, and select it
• You’ll see an upload area: “Click or drag file to this area to upload”
• The page shows which files are supported (e.g., for Binance: Transaction History, P2P Orders, Dual Investment History)
• Drag your file in and click Submit
• A document counter shows how many files you’ve uploaded (e.g., “0 document uploaded”)

​

What to know:

• This is a one-time import per file — it doesn’t auto-sync. For new transactions, upload a new file or switch to API
• Different exchanges export files in different formats — KoinX knows the format for most major exchanges and shows supported file types on the upload page
• Never open or edit the CSV before uploading — opening in Excel or Google Sheets can corrupt date formats, which causes import failures
• Some exchanges (like Binance) export .zip files — extract the CSV inside before uploading

---

​

Blockchain / Public Address

For on-chain wallets (MetaMask, Phantom, Ledger, Trust Wallet, etc.) and blockchain-level data, you simply paste your wallet’s public address and KoinX reads your transaction history directly from the blockchain.

​

How it works:

• Go to Integrations → Add Integration and select the blockchain (Ethereum, BSC, Polygon, etc.)
• You’ll see a field labelled “Public Address or Blockchain Domain” (marked with a red asterisk — it’s mandatory)
• Paste your wallet’s public address (e.g., starts with 0x... for Ethereum) or a blockchain domain like an ENS name
• Click Submit
• KoinX scans the blockchain and imports all transactions associated with that address

​

What to know:

• No API keys or files needed — blockchain data is publicly accessible
• KoinX only needs your public address — never share your private key or seed phrase with anyone, ever
• All ERC-20 token transfers, DeFi activity, and NFT transactions on Ethereum will be imported
• KoinX supports up to 30,000 transactions per wallet address — contact support if you have more
• Complex DeFi interactions (liquidity pools, yield farming, flash loans) may need manual review after import

---

​

Custom File

Custom File is for situations where your exchange isn’t in KoinX’s supported list, or you need to add transactions from an unsupported source (P2P trades, OTC deals, defunct exchanges). How it works:

• Go to Integrations → Add Integration → Custom File
• Click Download Template File to get KoinX’s spreadsheet template
• Fill it in with your transaction data following the exact format (date, type, label, coins, amounts, fees)
• Upload the completed file in the upload area (“Files Supported: KoinX Custom File”)
• Click Submit

What to know:

• The template has a specific format — follow it exactly, or the upload will fail
• Only 3 columns are mandatory: Date and Time (UTC), Type, and Label
• This is the most manual method, but it’s the universal fallback when nothing else works
• KoinX also offers a paid service where their team creates the custom file for you

---

​

Common Issues / Edge Cases

Can I use multiple integration types for the same exchange?

Yes, but be careful. The most common use case is connecting via API for ongoing sync and uploading a CSV file to backfill older transactions the API can’t reach. KoinX handles deduplication for the overlap period. Avoid having two active API connections for the same exchange.

My exchange shows multiple options when I search

Some exchanges have separate integrations for different products (e.g., Binance, Binance Smart Chain, Binance Futures). Make sure you’re selecting the right one for the data you want to import.

I connected via Direct Connect but some transaction types are missing

Direct Connect access depends on what the exchange exposes. Some exchanges don’t share certain transaction types (like staking rewards or funding fees) through their integration. Use a File Upload to fill in the gaps.

---

​

Frequently Asked Questions