Connect TradingView to Hyperliquid: Perps + Spot Automation Guide 2026
Quick Summary
Hyperliquid is the first decentralised exchange in the TV-Hub lineup: you trade from your own wallet, so there is no account application and, depending on where you live, no KYC queue to sit through. Connect it to TradingView in about 10 minutes. You authorise an API wallet that can trade but never withdraw, paste its private key and your wallet address into TV-Hub, and your alerts run perps and spot around the clock. Approve the TV-Hub builder fee and the connection costs you no subscription at all. Works with the TradingView free plan through email alerts.
The First DEX in the TV-Hub Lineup
Every other exchange TV-Hub connects to is a company holding your coins. Hyperliquid is not. It is a decentralised exchange running on its own chain, with a real on-chain order book, and your funds sit in a wallet you control rather than in an account someone opened for you.
That changes the first ten minutes more than anything else on this page. There is no sign-up form, no document upload, no waiting for approval. You connect a wallet and you are trading. Depending on your jurisdiction, that can spare you the KYC round entirely — the exchange-side identity checks that stand between a new account and its first order elsewhere.
What that means in practice
- Self-custody: no deposit into someone else's account, no withdrawal request to get out
- No account to be locked: your wallet is the account
- Depth without the custodian: an order book with real liquidity, not an AMM with slippage
- An API wallet that cannot withdraw: automation without handing over control
Two caveats worth stating plainly. Hyperliquid restricts access from some regions itself, so check its own terms before you build on it, and local rules on trading and on tax apply to you whether or not an exchange asks for your passport. Nothing here is legal or tax advice.
Trading From a Wallet, by Hand
Hyperliquid is fast, deep and fully on-chain. It is also the exchange where manual trading hurts the most: every entry, every stop, every take-profit is a wallet interaction, and the setup you saw on TradingView has usually moved by the time you have confirmed it.
TV-Hub closes that gap. Your TradingView alert carries a small JSON command, TV-Hub signs the order with an API wallet you authorised once, and the position is on the book seconds later. No coding, no browser extension left open, no wallet popup at 3am.
This guide covers:
- Authorising a Hyperliquid API wallet that cannot withdraw
- Connecting perps and spot with a single key
- Using TV-Hub for free with the builder fee
- Symbol formats, minimum order size and the mistakes that cost a trade
Quick Start: Connect in 10 Minutes
Hyperliquid has no API key in the usual sense. You create an API wallet (Hyperliquid calls it an agent wallet), keep its private key, and authorise it from the wallet you deposit with. That wallet can place and cancel orders. It can never move your funds.
No Hyperliquid account yet?
Create your Hyperliquid account through our partner link for a 4% discount on Hyperliquid's trading fees. Already have one? You can still add the code TVHUB on the referrals page while your account is under 10,000 USDC of traded volume.
Step 1: Create Your TV-Hub Account (2 minutes)
Sign up for the free 7-day trial. No credit card. Verify your email, log in, and you land on the dashboard with Hyperliquid in the sidebar.
Step 2: Authorise a Hyperliquid API Wallet (3 minutes)
Open the Hyperliquid API page, or find it under More → API:
- Type a name for the wallet, for example "tvhub"
- Click Generate, then Authorize API Wallet
- In the dialog, click MAX for the longest life Hyperliquid allows: 180 days
- Copy the private key shown in the red box
- Click Authorize and sign in your wallet
Two things that bite here:
- Copy the private key before you authorise. Hyperliquid shows it once and never again. A wallet whose key you did not keep is dead weight, and you can only generate a new one.
- Give the wallet a name. Hyperliquid does not list unnamed API wallets, so we cannot read back when one expires and cannot warn you before it stops trading.
Step 3: Copy Your Main Wallet Address (1 minute)
Open the account menu in the top right corner of Hyperliquid and copy the address. This is the address you deposit to, not the API wallet address from the dialog above. The two sit close together in the interface and mixing them up is the single most common setup mistake.
Step 4: Connect Hyperliquid in TV-Hub (2 minutes)
- In TV-Hub, go to Settings → API Keys and click Add API Key
- Select Hyperliquid from the exchange dropdown
- Main wallet address: the address from step 3
- API wallet private key: the key from step 2
- Name it something you will recognise later, for example "HL Main"
- Approve the builder fee to trade for free, or dismiss the offer, then Save
One key covers both markets. You do not add Hyperliquid twice for perps and spot: the exchange field in each trade command decides which market a signal hits.
Step 5: Build Your First Trade Command (1 minute)
The visual builder writes the JSON for you: pick the pair, the direction, the size, optionally a stop loss and targets, then copy the result. A perpetual entry looks like this:
{
"token": "your-access-key",
"exchange": "hyperliquid",
"pair": "BTC",
"apiKey": "HL Main",
"isBuy": true,
"isMarket": true,
"units": 25,
"unitsType": "percentBalance",
"leverage": 5,
"marginType": "ISOLATED"
}
And the same idea on spot:
{
"token": "your-access-key",
"exchange": "hyperliquid-spot",
"pair": "HYPE/USDC",
"apiKey": "HL Main",
"isBuy": true,
"isMarket": true,
"units": 50,
"unitsType": "percentBalance"
}
Step 6: Create Your TradingView Alert and Test (1 minute)
- Open your chart, right-click and choose Add Alert
- Paste the JSON into the Message field
- Enable Webhook URL and enter
https://alerts.tv-hub.org - Click Create
- Back in TV-Hub, use Execute Now with a small size to confirm the whole chain works
TradingView Free Plan User?
Webhooks are a paid TradingView feature, but you do not need them. Tick Send Email in the alert instead and TV-Hub processes it exactly the same way. Set up email-based automation
Want to try it without risking anything first? Tick Demo Account on the key and TV-Hub routes everything to the Hyperliquid testnet, perps and spot alike.
Start Your Free Trial Now
Test your Hyperliquid automation on the testnet first. 7-day free trial, no credit card required.
Start Free Trial View DocumentationTrade Without a Subscription
Hyperliquid lets you route a small share of your trading fee to a "builder". Approve TV-Hub as your builder and this key is free to use: no subscription, no trial clock, nothing to prove.
The rate is 0.01% per fill on perps and 0.03% on spot, on top of Hyperliquid's own fees. You sign an upper limit of 0.03% once, which is what lets a single signature cover both markets, and you only ever pay when a fill actually happens. For taker fills, Hyperliquid's fee plus the builder fee still lands at or below the same trade on Bybit.
How to approve
- In the add-key form, click Connect wallet and approve before saving
- Or later, from the key list, with the Approve button on the Hyperliquid row
- Sign with your main wallet, through the browser extension or a QR code. The API wallet cannot sign this
- Revoke it on Hyperliquid whenever you like. The key then falls back to the trial or your subscription
The approval belongs to your wallet address, not to the API wallet. When Hyperliquid retires an API wallet after 180 days and you create a new one, the approval simply stays.
Perps and Spot From One Key
Two exchange identifiers, one set of credentials:
hyperliquid— perpetuals, USDC-collateralised, leverage per symbol from roughly 3× to 40×hyperliquid-spot— spot pairs against USDC, USDH, USDT0 and USDE
Both carry the full feature set you expect from TV-Hub: multiple take-profits, DCA and order meshes, scaled orders, limit-order chasing and math expressions on stop and target levels. Two differences are worth knowing before you build a strategy around them.
Spot has no stop loss
Hyperliquid has not enabled trigger orders on its spot market. A signal that carries a stop loss still opens the position, the stop-loss part is refused, and the refusal is written to your activity log. TV-Hub does not emulate a stop client-side, so a spot position opened that way is open and unprotected. Take profit is unaffected: on spot it is a resting limit sell rather than a trigger. If your strategy depends on a hard stop, trade it on perps.
Margin type is case-sensitive
Hyperliquid expects the exact string "ISOLATED" or "CROSS". Every other exchange normalises the value, so lowercase works there; here it does not. Leaving the field out defaults to isolated. Some markets are isolated-only and refuse cross outright.
One pot of collateral
On a Hyperliquid unified account, the same USDC backs both spot and perps, and both adapters report it. Two strategies sizing 50% of balance on the two markets therefore commit 100% of your account, not half of it. If you run bots on both, switch the account to Manual mode, which Hyperliquid itself recommends for automated trading, or size one side in absolute units.
Symbols: Paste the TradingView Ticker
Hyperliquid names a perpetual by the bare coin (BTC, HYPE) and a spot pair with a slash (HYPE/USDC). The Trade Command Builder fills that in for you, but you do not have to be precise: TV-Hub maps the symbol before anything reaches the exchange.
On a perp signal, the trailing .P from a TradingView ticker is dropped, a / or - separator settles where the coin name ends, and a trailing USDC, USDT or USD is stripped. So HYPE, HYPE.P, HYPEUSDC.P, HYPE-USDC and HYPEUSD all reach the same perpetual. On spot, a dash becomes a slash, a glued quote asset is split off, and a bare coin gets /USDC appended.
The market comes from the exchange field, never from the symbol
HYPE/USDC sent with "exchange": "hyperliquid" trades the HYPE perpetual, because that identifier is the perp market. Pick the identifier for the market you want; the symbol only has to name the asset.
When nothing matches, the error names every form that was tried, and if the symbol exists on the other Hyperliquid market it tells you which identifier to use instead.
Advanced Automation Features
Limit order chasing
A limit order that rests at the touch and follows the book instead of sitting behind it. On Hyperliquid the chase posts post-only, so a chased entry stays on the maker side of the book while it waits. updateCurrentLimitOrder also lets a later signal snap the nearest open limit back to the current best bid or ask.
DCA and scaled orders
Split an entry across a ladder of limit orders, evenly or weighted towards one end. Both markets support it. Keep the minimum order value in mind: 10 USDC per order, which is the value of each rung, not of the whole ladder.
Multiple take-profits
Several targets with individual sizes, plus a stop that can be moved to break-even once the position is in profit. On perps this is fully server-side.
Copy trading and Telegram
Signals you run on Hyperliquid can fan out to followers through copy trading, and every fill can land in your Telegram. See the Hyperliquid reference for the full feature matrix.
Best Practices
- Name your API wallet: it is the only way we can show you its expiry date
- Diary the 180 days: the wallet stops trading on that date whether you use it or not
- Test on the testnet first: tick Demo Account and run the strategy for a day before it touches real collateral
- Approve the builder fee: there is no reason to pay a subscription for a Hyperliquid key
- Mind the 10 USDC minimum: percentage sizing on a small account can silently fall under it
- Use Manual account mode if you trade perps and spot from the same account
- Do not put a stop loss in a spot signal: it will not be placed, the entry will still fill
- Keep spot and perp balances funded separately: an API wallet cannot move funds between them
- Separate strategies with separate keys: a sub-account address added as its own key keeps their balances apart
Common Issues and Solutions
"The connected wallet is 0x… but this key is for 0x…"
The builder fee approval has to be signed by the wallet the key belongs to. Switch accounts in your wallet, or connect the right one, and try again. Signing with a different wallet would credit that other account instead, which is why the check exists.
Orders rejected as too small
Hyperliquid requires 10 USDC of order value, and the boundary is exact: 10 is accepted, 9.99 is not. There is no minimum quantity, so this bites hardest with percentage sizing on a small balance or with a DCA ladder whose individual rungs fall under the limit.
"Price must be divisible by tick size"
Hyperliquid has no fixed tick size. A price is valid when it has at most 5 significant figures and at most a certain number of decimals, which depends on the asset. TV-Hub rounds for you, so this normally only appears with a hand-written price in a manual command.
The key stopped working after a few months
The API wallet expired. Create a new one on Hyperliquid, then delete the key in TV-Hub and add it again with the new private key. Your address does not change, so the builder fee approval stays valid.
Spot signal fails while the perp balance is full
Spot and perp balances are separate on Hyperliquid, and an API wallet cannot transfer between them. Move the funds yourself in the Hyperliquid interface. The error message names your perp balance so you can see what happened.
Ready to Automate Hyperliquid?
Connect your API wallet, approve the builder fee and trade on autopilot. Start free today.
Start Free Trial View DocumentationWhy Choose TV-Hub
TV-Hub has been routing TradingView alerts to exchanges since 2019, across Binance, Bybit, OKX, KuCoin, Coinbase, BitMEX and now Hyperliquid. The same trade command works everywhere, so a strategy you built for another exchange moves over by changing one field.
Your credentials are encrypted at rest, and on Hyperliquid the credential itself cannot withdraw: an API wallet trades and nothing else. Every signal, accepted or refused, lands in an activity log you can read, which is the difference between a bot you trust and a bot you hope about.
The visual command builder means no coding. Pick the pair, the size and the risk, and it writes the JSON — including the Hyperliquid specifics like rounding, leverage limits and the isolated-only markets.
Start Your Automated Trading Journey
Hyperliquid gives you an on-chain order book with real depth. TV-Hub gives you a way to trade it while you sleep, from the charts you already read. Ten minutes of setup, an API wallet that cannot touch your funds, and a builder fee approval that replaces the subscription entirely.
Ready? Start with the testnet, move to a small live size, then let the strategy run.
Start Your Journey Today
Join thousands of traders already automating their trading with TV-Hub.
Start Free Trial View DocumentationFrequently Asked Questions
"exchange": "hyperliquid" for perpetuals and "exchange": "hyperliquid-spot" for spot; the credentials and the builder fee approval are shared.
BTC) and spot pairs with a slash (HYPE/USDC), but TV-Hub maps TradingView tickers automatically: HYPEUSDC.P, HYPE-USDC and HYPEUSD all resolve. The market itself always comes from the exchange field, never from the symbol.
Start Free Trial
Connect Hyperliquid in 10 minutes and let your TradingView alerts do the trading.
Start Free Trial View Documentation