for ChatGPT, Claude, Perplexity…
TROUBLESHOOTING

Hyperliquid → Koinly import: what works, what breaks

· 7 min read · Not tax advice

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.

Key facts
  • 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 from userFunding, 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

  1. Copy the public address of the Hyperliquid account you traded from.
  2. In Koinly, open Wallets and add Hyperliquid.
  3. Select API, paste the public address, and start the import. Do not enter a private key or seed phrase.
  4. Read the limitations in the API setup window and review the Transactions page for missing or incorrectly tagged activity.
  5. 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

CheckWhat to compareWhat a difference can mean
History coverageEarliest/latest timestamp, fill count, account addressA limit, missing date range or different account; an empty API response does not prove no historical activity.
Realized PnLSum of closing-fill closedPnl for the same periodDifferent scope, currency conversion or accounting definitions; inspect rows before attributing a defect.
FeesFee amount and fee token, separately from PnLA gross-versus-net comparison or different fee treatment. Do not subtract fees twice.
FundingPaid and received amounts from userFundingFunding is not part of the fills stream. Check whether the comparison includes it.
DuplicatesOverlapping API/CSV dates and transaction identifiersThe same source activity may have been imported more than once; verify before removing records.
Evidence boundary. Koinly's documentation verifies the setup and transaction cap. The checks below are a reconciliation method, not a claim that today's Koinly importer drops funding or reconstructs PnL incorrectly. We have not run a controlled, current Koinly-versus-source test for this revision.

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

  1. Get your exchange-reported totals per year: realized PnL, fees, net funding — the scanner does this in one step.
  2. Import Hyperliquid into Koinly (wallet sync).
  3. Compare Koinly's yearly totals against the exchange totals.
  4. Investigate any gap larger than rounding: funding dropped? duplicates? spot mixed into perp?
  5. Only after the gap is explained, generate the tax report.
Transaction caps apply on both sides. Koinly's wallet sync has a ~10,000-transaction ceiling, and each API call returns at most 2,000 fills. High-frequency traders should request their full archive from Hyperliquid support and import that instead of relying on API sync alone.

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 wallet

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

Primary sources

Check the linked sources for the rules, integration limits and API definitions discussed on this page. A general source does not settle every classification question or verify every third-party integration behavior.

  1. Koinly — Hyperliquid integration and limitations Public-address API setup, transaction review steps, and the documented 10,000-transaction limit per wallet. Checked November 7, 2026.
  2. Koinly Help Center — API sync limitations Where to find integration-specific limitations and how incomplete source history can cause missing transactions or balance errors.
  3. Hyperliquid docs — Info endpoint Official read-only query definitions, returned fields and documented history limits for fills, funding and ledger activity.
  4. Hyperliquid docs — Funding Official funding mechanics and payment direction; separate these flows from fill-level records.

How this page was produced