Connect TradingView to Hyperliquid: Perps + Spot Automation Guide 2026

12 min read Updated: August 13, 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:

  1. Type a name for the wallet, for example "tvhub"
  2. Click Generate, then Authorize API Wallet
  3. In the dialog, click MAX for the longest life Hyperliquid allows: 180 days
  4. Copy the private key shown in the red box
  5. 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)

  1. In TV-Hub, go to Settings → API Keys and click Add API Key
  2. Select Hyperliquid from the exchange dropdown
  3. Main wallet address: the address from step 3
  4. API wallet private key: the key from step 2
  5. Name it something you will recognise later, for example "HL Main"
  6. 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)

  1. Open your chart, right-click and choose Add Alert
  2. Paste the JSON into the Message field
  3. Enable Webhook URL and enter https://alerts.tv-hub.org
  4. Click Create
  5. 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 Documentation

Trade 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 Documentation

Why 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 Documentation

Frequently Asked Questions

No. You give TV-Hub an API wallet, and Hyperliquid's API wallets can place and cancel orders but have no withdrawal permission at all. That restriction is enforced by the exchange, not by us. Withdrawals stay with your main wallet, which you never hand over.

Yes, if you approve the builder fee. Hyperliquid lets you route 0.01% of each perp fill and 0.03% of each spot fill to TV-Hub, and that replaces the subscription for that key. You pay it only when you trade, and you can revoke it on Hyperliquid at any time. Without the approval, the key runs on the 7-day trial and then needs a subscription like any other exchange.

No. One API key covers both. Send "exchange": "hyperliquid" for perpetuals and "exchange": "hyperliquid-spot" for spot; the credentials and the builder fee approval are shared.

That is Hyperliquid's rule, not ours: every API wallet is switched off after 180 days at the latest. TV-Hub shows the date on your key list so it does not surprise you. When it arrives, create a new API wallet, delete the key and add it again — the builder fee approval belongs to your address and stays valid.

No. Hyperliquid has not enabled trigger orders on its spot market, so no stop loss, trailing stop or break-even move can be placed there. The entry still executes and the refusal is logged, which means the position is open and unprotected. Take profit works, because on spot it is a resting limit sell. For stop-protected strategies, use the perpetual market.

Whatever your chart gives you. Perpetuals are named by the bare coin (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.

Yes. Tick Demo Account when you add the key and TV-Hub routes every order to the Hyperliquid testnet, on perps and spot alike. Demo trading is free and needs no subscription.

Start Free Trial

Connect Hyperliquid in 10 minutes and let your TradingView alerts do the trading.

Start Free Trial View Documentation