Hyperliquid CSV export: trades, funding and annual totals
Scan your public trading address, review the available records, then export three CSV files. The preview is free; a one-time $19 unlock downloads your annual summary, fills ledger and funding history. No wallet connection or signup is required. You can inspect free synthetic samples before paying.
- Preview and sample files: free. Live-data CSV download: $19 one-time unlock.
- Three files: UTC-year summary, individual fills, and individual funding entries. Funding is a separate stream from trades.
- Coverage is bounded by the source API. The documented fills limit is 2,000 per response, latest 10,000 available; pagination is not a full-history guarantee.
- These are reference exports, not native Koinly/TurboTax templates or a completed Form 8949.
See what you receive before you scan
These files contain fabricated BTC examples, a placeholder address and a fixed export date. They use the same CSV formatting functions as live exports. They are not customer results.
- Download sample annual summary CSV
- Download sample fills ledger CSV
- Download sample funding history CSV
How to export your own wallet
- Open the scanner and enter the public address of the account you traded from. Include subaccounts separately if relevant.
- Run the scan. Large histories take longer; data availability depends on the API.
- Compare the available period with your records. Check PnL, fees and funding separately.
- If the available data meets your needs, unlock the CSV downloads for $19 once and save all three files.
- Keep your own raw records and verify the importer requirements before using a file in tax software.
What is in each CSV?
| File | Useful fields | Use |
|---|---|---|
| Annual summary | UTC year, realized PnL, fees, funding received, funding paid, fill and liquidation counts | Reconciliation overview; does not replace transaction-level records. |
| Fills ledger | UTC timestamp, market, direction, side, price, size, closedPnl, fee, fee token, trade ID, order ID, event hash | Inspect individual executions and possible duplicates. One order can have multiple fills. |
| Funding history | UTC timestamp, market, signed USDC amount, rate, position size, sample count | Keep receipts and payments separately; negative amounts are payments in this export. |
Identifiers are preserved as text. Do not let a spreadsheet round large order or trade IDs. Fee amounts retain their token label; a non-USDC fee must not be silently treated as USDC.
Coverage checks before you rely on the export
- Date range: check the earliest and latest fills. An empty result cannot establish that older activity never happened.
- Retention: the official Info API documentation states a latest-10,000-fill availability limit. A prior case study is not a current retention guarantee.
- Duplicates: compare trade ID, order ID, timestamp, market and event hash. An order ID alone does not identify a unique fill.
- Tax year: the summary uses calendar years in UTC. A local fiscal year or timezone may require regrouping the underlying ledgers.
- Activity scope: the scanner is not a full valuation of spot cost basis, vaults, staking, transfers or HyperEVM activity.
Developer route: get JSON from the Info API
Send a read-only POST request to https://api.hyperliquid.xyz/info with type: userFillsByTime, your public user address and millisecond startTime/endTime. Retrieve funding separately with userFunding. The response is JSON; converting it to CSV and validating coverage is your responsibility.
Preserve time, coin, closedPnl, fee, feeToken, tid and oid. See API history and pagination limits. Paginating within an available window does not bypass source retention.
Using the data with tax software
For a wallet sync, follow the Koinly import and reconciliation guide. For a filing workflow, read the TurboTax guide. Avoid adding a second copy of trades already imported by API. A summary total is not an automatic one-to-one replacement for tax-form rows.
Common questions
How do I export Hyperliquid trade history to CSV?
Paste your public trading address into the scanner, review the available history, then unlock three CSV downloads: annual summary, fills ledger and funding ledger. The preview and synthetic sample files are free; live-data CSV exports cost $19 once. Developers can also query the public Info API and convert the JSON themselves.
Is Hyperliquid CSV export free?
The wallet scan, on-screen preview and synthetic CSV samples are free. Downloading your scanned data through this site requires a one-time $19 unlock. Querying the public API yourself is a separate route and does not require buying this export.
Does pagination recover all my Hyperliquid trades?
No completeness guarantee follows from pagination. Hyperliquid currently documents at most 2,000 fills per response and availability of only the latest 10,000 fills. Check the earliest and latest timestamps against your own records, especially for older or high-frequency activity.
Can I upload these files directly to Koinly or TurboTax?
These are reference CSVs for reconciliation and accountant review, not a promise of a native import template or completed tax form. Check the destination software’s current schema and mapping. Keep the fills and funding ledgers as well as the annual summary.