guides/lighter tax

Koinly + Lighter: there is no sync

updated november 2026 · ~4 min · basisproof research · not tax advice

The direct answer

Koinly does not support Lighter. There is no venue integration, no wallet-type mapping, no sync to configure — unlike Hyperliquid, where an importer at least reaches a truncated API, on Lighter there is nothing to connect at all.

A fair caveat up front: integrations get updated constantly. Treat this page as a checklist for what you're seeing today, not a permanent verdict — but 'today' means no sync exists, and the workaround below is the only path that produces a complete record.

What a wallet import actually sees

If you add your Ethereum address to Koinly, it indexes your L1 activity — including the zkLighter contract calls. What arrives is the collateral boundary only: deposits appear as sends to a contract, withdrawals as receives from it.

Everything that matters for tax lives inside the rollup and is invisible to that import: fills, hourly funding, realized PnL, the positions behind them. A Koinly report built on the L1 legs alone shows money entering and leaving a contract address — none of the taxable events in between.

Why the L1-only record is worse than nothing

Partial data that looks complete is the dangerous kind. A wallet import produces a clean-looking transaction list — rows, dates, amounts — while containing none of the trading that generated the gains. Depending on how the contract legs get classified, the same import can also mislabel collateral movements as disposals or income.

Filing on it doesn't produce a slightly wrong number; it produces a number built on a different set of facts. The margin is invisible precisely because the missing part leaves no gap in the list — there are simply no fills to notice.

What actually works

Build the record first, then hand Koinly a file. The complete fill history is published by the venue as public parquet archives — the trade API only serves a ~3-week rolling window, so it cannot be the source. Deposits and withdrawals come from zkLighter contract events on L1, including deposits relayed through third-party contracts that a plain transfer scan misses.

Our free check does the assembly and the proof: fills replayed through the position chain (each fill's position_size_before must match the running position), L1 collateral flows scanned, terminal account value reconciled — with measured disagreement printed, not smoothed over. The verified totals are then the honest input for whatever import file your tool accepts.

Common questions

?Does Koinly support Lighter?

Not today — there is no venue integration at all, so there is no sync to debug. An Ethereum wallet import only sees the zkLighter contract deposits and withdrawals on L1, never the fills or funding inside the rollup.

?If I import my ETH wallet, won't Koinly catch the Lighter activity?

It catches the boundary, not the activity: sends to and receives from the zkLighter contract. The trading — every close, every funding payment, the PnL itself — happens inside the rollup and never reaches L1 as readable events for an importer.

?Can I export from Lighter and import into Koinly manually?

Lighter has no export button, so there is no official file to import. The workable path is reconstructing the record from public data (the venue's fill archives plus L1 contract events) and producing an import file from that.

?Is this specific to Koinly?

No — CoinTracker, CoinTracking, TokenTax and the rest are in the same position: no Lighter integration exists today. The venue is too new for the import pipelines these tools rely on.

?When will Koinly add Lighter?

That's Koinly's roadmap, not something to plan a filing around. What is available now is the public data itself — complete fills in the venue's published archives and the L1 collateral trail — which is enough to build the record independently of any importer.

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