Hyperliquid trade journal

Hyperliquid Trade Journal — Auto-Import Your Trades

Hyperliquid is an on-chain exchange for perpetual futures and spot that runs on its own blockchain. Every account's fills are public by wallet address, so there is no API key to create: paste your address and Trnd Tools imports your perps and spot trades across every market in one pass, with fees attached.

Start journaling free

Free for up to 10 trades a month. Includes 30 days of Pro, no card required.

How the Hyperliquid sync works

Four steps, about a minute. An address can only be read - nothing can trade or withdraw with it.

1
Copy your Hyperliquid wallet address
Copy the address of the account you trade from - your main account or a sub-account - from your wallet or the top of Hyperliquid's Portfolio page. Do not use an API wallet's address (Hyperliquid also calls these agent wallets): its own docs warn that one returns no fills.
2
Paste it into Trnd Tools
Open the journal, choose Hyperliquid in Connect Exchange, paste the address and tick the confirmation that it is your public address. There is no key, secret or passphrase, and the form refuses anything shaped like a private key.
3
Choose a ledger
Pick which ledger the trades should land in - one per account or strategy, or a single ledger for everything. Each connection can be imported into a different ledger.
4
Import
Click Sync now. Trnd Tools reads the address's fills across every market, builds closed positions from them and files them in a ledger named after the connection. From then on new trades are pulled in automatically every hour.

Perps and spot come back together in one pass, so there are no trading pairs to list by hand.
Each sub-account has its own address. Add each one you trade from as its own connection, in the same ledger or separate ones.
Perpetual fills are journaled under the base asset - a BTC perpetual becomes a BTC trade with direction LONG or SHORT.
Tokens and markets that are not in the Trnd Tools asset list are skipped and counted in the import summary rather than imported under the wrong name.

Why your Hyperliquid address is enough

There is no secret to protect. The address is public already - anyone can look up its fills - and it cannot be used to trade or withdraw. It is still stored in Supabase Vault like a key, used only to read your trade history, and deleted when you remove the connection.

What gets imported from Hyperliquid

The importer reads fills and writes closed trades. Here is exactly what ends up in the journal.

Fills become closed trades

Exchanges report individual fills; the journal records trades. Fills are walked in time order per symbol using average cost, and one closed trade is written each time your exposure returns to flat - so a position you scaled into over five orders is one trade, not five rows.

Entry, exit, quantity and direction

Each trade gets its average entry price, average exit price, quantity and a LONG or SHORT direction, so shorts on perpetuals are recorded correctly.

Fees and net P&L

Fee costs reported with each fill are summed into the trade's trading fee, and both gross and net P&L are stored along with the P&L percentage on the entry value.

Open and close timestamps

The first fill's time becomes the open time and the last fill's time becomes the exit time, which is what drives hold-time stats and the daily profit calendar.

No duplicates on re-import

Every imported trade carries an id derived from its exchange fill ids. Importing again skips trades that already exist, so you can sync as often as you like.

Open positions show as open trades

A position still open on the exchange appears in your open trades with its entry, size and fees so far, and becomes a closed trade once it is flat. Balances are read only to check the connection and find the pairs you hold, and deposits and withdrawals only to track the money you have put into the account.

Or import a Hyperliquid CSV

If you would rather not connect at all, Hyperliquid's Portfolio page has a Trade History tab with an Export as CSV button. Hyperliquid limits how much fill history it serves - its API docs say the 10,000 most recent fills - so an account that trades often should export regularly.

1Download a trade or order history export from the exchange.
2Upload it in the journal's CSV import. The mapper reads the header row and suggests which column is the symbol, open and exit time, entry and exit price, quantity, direction and fees.
3Map any symbols the journal does not recognise to an asset from the list, or leave them out.
4Import. The same de-duplication as the exchange sync applies, so the CSV and API paths can be mixed on one ledger.

What the journal does with your Hyperliquid trades

Once the trades are in, the stats are computed for you - the same analytics whether trades were imported or typed in.

Win rate and profit factor

Win rate, profit factor, average profit per trade, biggest winner, biggest loser, total fees and average hold time - computed from the imported trades, not typed in.

Daily profit calendar

A calendar of green and red days so you can see whether losses cluster on certain days or after certain sessions.

Monthly reports

Net profit, trade count, win rate and profit factor summarised per month, so you can measure improvement over time rather than trade by trade.

Review every trade

Every imported trade sits in your history with entry, exit, fees and P&L, and you can add notes, a setup and an execution type after the fact.

The journal is free for up to 10 manually entered trades a month, with the same stats, calendar and reports. Exchange sync and CSV import are Pro features at $19/mo or $149/yr, and every new account starts with 30 days of Pro. See full pricing.

Hyperliquid trade journal FAQ

Does Trnd Tools need my Hyperliquid private key?

No - and never paste a private key or seed phrase into any website. Hyperliquid publishes every account's fills by wallet address, so the address is all the sync reads. The connect form only accepts a public address (0x followed by 40 characters) and refuses anything shaped like a private key. Nobody can place orders or move funds with an address.

Why did my Hyperliquid import find no trades?

Usually because the address belongs to an API wallet (an agent wallet) rather than to the account itself. Hyperliquid's documentation notes that an agent wallet's address returns an empty result. Remove the connection and add the address of the main account or sub-account that holds your positions.

How far back does the Hyperliquid import go?

The first sync asks for up to 12 months, and Hyperliquid's API documents that only your 10,000 most recent fills are available, whichever limit you reach first. After that a background job checks every hour and only reads fills newer than the last one it saw, so nothing is imported twice.

Is the Hyperliquid sync included in the free plan?

No. The free plan is manual entry for up to 10 trades a month with the same stats, calendar and reports. Exchange sync and CSV import are Pro features ($19/mo or $149/yr). Every new account gets 30 days of Pro on signup, so you can connect Hyperliquid and import before deciding.

Stop tracking Hyperliquid trades by hand

Create a free account, connect Hyperliquid during your 30 days of Pro, and see your real win rate and profit factor from the trades you have already made. Free for up to 10 trades a month after that.