How to export your Lighter trade history
updated november 2026 · ~5 min · basisproof research · not tax advice
There is no export button
Lighter's app shows your recent positions and fills, but offers no CSV download anywhere — no tax section, no history export, no statements. Whatever a filing needs has to be assembled from the venue's public data endpoints.
That puts Lighter in the same bucket as every non-custodial venue, with one twist: the obvious endpoint is not just incomplete — it can be silently misleading about where your record begins.
The API window — and the mid-position trap
The public trade endpoint serves a rolling window of roughly three weeks. Query it for 'my history' and you get the tail of it, with no error and no warning that anything is missing.
Worse, the window can open inside an open position: the first returned row carries position_size_before, and a non-zero value is hard proof the record starts mid-trade — meaning the fills that opened that position, and the fills before them, are all outside the window. An export built on this endpoint alone isn't short a few rows; it can be short the entire opening leg of what you still hold.
The explorer's account logs roll on a similar window, so they don't rescue the deep history either.
Where the complete record actually lives
Fills and funding: the venue publishes its full trade history as public parquet archives — every fill since the account's first day, in the same data the venue itself uses. This is the source of truth the ~3-week endpoint is a window onto.
Deposits and withdrawals: collateral moves through the zkLighter contract on Ethereum L1. These are contract events, not rows in the trade API — and deposits can arrive relayed through third-party contracts, which only appear when you read the event's credited-account field rather than scanning for direct transfers.
A tax-grade export needs all of it joined: fills with their fees (zero for most accounts — this venue has no maker-rebate stream), hourly funding, the L1 collateral ledger, and the position chain that ties each close to the opens that fed it.
The honest state of tooling
No tax-software importer supports Lighter today — unlike Hyperliquid, there is no partial sync producing a misleadingly complete-looking result. The record has to be built first.
Our free check does the assembly: it pulls your fills from the venue's public archive, replays them through the position chain (each fill's position_size_before must equal the running position), scans L1 for the collateral flows, and reconciles the terminal account value — printing measured disagreement rather than hiding it. A lot-level CSV pipeline exists for Hyperliquid and is being ported to Lighter; today the deliverable is the verified record itself.
Common questions
?Does Lighter have a CSV export?
No — the app has no export button, no tax section, no statements. Your data is only reachable through public endpoints and the venue's published archives.
?How far back does the Lighter API go?
The public trade endpoint serves a rolling window of roughly three weeks, and it can begin mid-position — check position_size_before on the first row; non-zero means the window opened inside an existing trade. The complete history lives in the venue's public parquet archives.
?Can I just export what the API gives me?
You can, but treat it as a sample, not a record: it silently drops everything older than the window, including the opens behind positions you still hold. Filing on it means your basis and realized PnL are computed on a truncated record.
?Where do Lighter deposits and withdrawals show up?
On Ethereum L1 — they're zkLighter contract events, not rows in the trading API. Deposits relayed through third-party contracts only appear via the event's credited-account field, so a naive scan of direct transfers misses them.
?Can Koinly or CoinTracker import Lighter?
Not today — no importer supports the venue. The practical path is building the record from public data and importing it as a file your tool accepts.
?What does a complete Lighter export need to contain?
Fills with signed fees, hourly funding, the L1 deposit/withdrawal ledger, and the position chain linking closes to opens — then a reconciliation against terminal account value so you know the rows are complete, not just present.
Sources & method
See where your record actually starts — free
The Lighter trade API serves a rolling ~3-week window — and it can begin mid-position. The free gap check measures where that window starts against where your account actually did. Seconds, not minutes.
Measure my gap