Hyperliquid → Koinly import: what works, what breaks
Koinly supports Hyperliquid through a public-address API import, with a published limit of 10,000 transactions per wallet. Add Hyperliquid in Koinly, choose API, paste your public address and review the imported activity. Before filing, reconcile the same reporting period against exchange-reported realized PnL, fees and funding. These are separate checks, not interchangeable totals.
- Verified November 7, 2026: Koinly documents public-address import and a 10,000-transaction limit per wallet.
- Hyperliquid reports realized PnL in
closedPnl; funding comes fromuserFunding, separately from fills. - Compare the same wallet, date range and currency before diagnosing a difference. A USD/USDC reference total is not automatically a local-currency tax result.
- Do not import overlapping API and CSV records without checking for duplicates.
- The scanner is a reference data tool; its annual summary does not by itself replace transaction-level records or a completed tax return.
How to import Hyperliquid into Koinly
- Copy the public address of the Hyperliquid account you traded from.
- In Koinly, open Wallets and add Hyperliquid.
- Select API, paste the public address, and start the import. Do not enter a private key or seed phrase.
- Read the limitations in the API setup window and review the Transactions page for missing or incorrectly tagged activity.
- Reconcile the source history before generating the tax report.
These steps and the transaction limit come from Koinly's own integration page. Product behavior can change; check the current setup window for your wallet.
What to check when the totals do not match
| Check | What to compare | What a difference can mean |
|---|---|---|
| History coverage | Earliest/latest timestamp, fill count, account address | A limit, missing date range or different account; an empty API response does not prove no historical activity. |
| Realized PnL | Sum of closing-fill closedPnl for the same period | Different scope, currency conversion or accounting definitions; inspect rows before attributing a defect. |
| Fees | Fee amount and fee token, separately from PnL | A gross-versus-net comparison or different fee treatment. Do not subtract fees twice. |
| Funding | Paid and received amounts from userFunding | Funding is not part of the fills stream. Check whether the comparison includes it. |
| Duplicates | Overlapping API/CSV dates and transaction identifiers | The same source activity may have been imported more than once; verify before removing records. |
Worked example: separate PnL, fees and funding
Illustrative numbers, not a customer result: suppose closing fills report 1,000 USDC of realized PnL, fees total 50 USDC, and funding records show 30 USDC received and 80 USDC paid. The funding net is −50 USDC. If the 1,000 PnL figure excludes both fees and funding, the combined trading result is 1,000 − 50 + 30 − 80 = 900 USDC. A report showing 1,000 and another showing 900 may simply use different definitions. This arithmetic does not determine how any jurisdiction taxes those amounts.
A workable cross-check workflow
- Get your exchange-reported totals per year: realized PnL, fees, net funding — the scanner does this in one step.
- Import Hyperliquid into Koinly (wallet sync).
- Compare Koinly's yearly totals against the exchange totals.
- Investigate any gap larger than rounding: funding dropped? duplicates? spot mixed into perp?
- Only after the gap is explained, generate the tax report.
When to skip Koinly for this venue
If your activity is 100% Hyperliquid perps and you file under capital treatment with a CPA, a clean exchange-reconstructed export may be all you need — one venue, one asset class (USDC-margined), the underlying transaction records and a reconciled summary. Koinly earns its keep when you have many venues to merge. Choose based on your actual shape of activity, not habit — the full tool comparison covers Koinly, Awaken, CoinLedger and the rest side by side.
Get the exchange-reported numbers first
Realized PnL, fees, and funding per year — the reference totals your Koinly import should match.
Scan my walletCommon questions
Does Koinly support Hyperliquid?
Yes. Koinly documents a Hyperliquid public-address API integration. Add Hyperliquid under Wallets, select API, paste your public address and import. Its published limit is 10,000 transactions per wallet; review the limitations shown in your API setup window.
Why doesn't Koinly's Hyperliquid PnL match the exchange's?
A mismatch alone does not identify the cause. Check that both reports cover the same wallet, date range, currency and accounting definition. Then compare fill count, exchange-reported closedPnl, fees and funding separately, and inspect missing history or duplicate imports. This guide does not establish a current defect in Koinly.
How do I reconcile a Koinly import for Hyperliquid?
Get exchange-reported totals per year (realized PnL, fees, funding paid and received), run the Koinly wallet sync, compare the yearly totals, investigate any gap larger than rounding for dropped funding or duplicates, and only then generate the tax report. Note Koinly wallet sync has a roughly 10,000-transaction ceiling — high-frequency traders should request their full archive from Hyperliquid support.