Hyperliquid spot trading tax
Hyperliquid's spot order book (HYPE, PURR, and the HIP-1 auctioned tickers) settles like any token trade: buying, selling, and token-to-token swaps are generally taxable events in the US reading. The tax concept is ordinary — the data problem is unusual: spot fills don't arrive under ticker symbols at all.
- Spot fills are taxable disposals on the sell/swap side — same as trading tokens on any exchange. Buying with USDC is a purchase, not a disposal.
- In the API, spot assets appear as index names like
@107, not tickers — importers that don't map the index table either skip them or label them wrong. - TWAP orders produce many child fills — each is its own row; volume-sensitive importers truncate them.
- Spot fills carry
closedPnl: 0— spot has no exchange-computed realized PnL; the basis story is yours to keep. - Transfers between your own Hyperliquid accounts/sub-accounts are not disposals — but they show up in the ledger stream.
The @-index problem
Hyperliquid assigns spot assets numeric identifiers. In userFillsByTime a
spot fill's coin field reads @107-style — the mapping to
tickers lives in a separate metadata call (spotMeta). Consequences for tax
files:
- An importer that doesn't resolve the index table either drops the fills or files them under an unrecognizable asset — your HYPE spot sales can simply vanish.
- Basis tracking breaks silently: the "asset"
@107bought in March isn't matched to the "HYPE" sold in June. - Do a name audit before filing — every
@Nin your export needs its real ticker.
TWAP and high-frequency spot
TWAP orders split into child fills that each land as a separate row — hundreds of fills
for one logical order. For reporting they're all real dispositions of the sold side;
for data hygiene, dedupe on tid+oid and watch for tools that
cap transactions (the
real-wallet case study shows how fast
counts explode).
What to record
- Every spot fill with resolved tickers (map
@Nvia spotMeta), price, size, fee, timestamp. - Your own basis lot tracking — the exchange won't compute realized PnL for spot.
- Ledger movements that prove transfers were internal, not sales.
Get the spot activity the imports drop
The scanner pulls the full fills stream including spot and TWAP children — per-year totals in seconds, free.
Scan my walletCommon questions
Are Hyperliquid spot trades taxable?
Selling or swapping spot assets (HYPE, PURR, HIP-1 tickers) is generally a taxable disposal, same as on any exchange. Buying with USDC is a purchase, not a disposal, and transfers between your own Hyperliquid accounts are internal movements, not sales — though they do appear in the ledger stream.
Why does my Hyperliquid export show coins like @107 instead of tickers?
The API reports spot assets as numeric index names (@107-style) rather than tickers — the mapping lives in the separate spotMeta call. Importers that don't resolve the index table either drop those fills or file them under unrecognizable assets, so your HYPE spot sales can simply vanish. Do a name audit and map every @N to its real ticker before filing.
Does Hyperliquid report realized PnL for spot trades?
No — spot fills carry closedPnl: 0 because the exchange computes realized PnL only for perps. For spot you track your own cost basis lots; the export gives you every fill with resolved ticker, price, size, fee and timestamp to build from.