Hyperliquid integration · USDC perpetuals

Automate Crypto Futures Trading on Hyperliquid

Connect your Hyperliquid wallet through an API wallet that can trade but never withdraw, or practise on the Hyperliquid testnet first. Then build a bot that trades USDC perpetuals from your signals, with take profit, stop loss and trailing steps that move a real stop on Hyperliquid. Six steps, no code.

API wallet, never withdraws
Demo on the testnet
Trailing steps on Hyperliquid
A Hyperliquid account connected through an API wallet, a TradingView buy alert opening a ten times long on BTC/USDC with take profit, stop loss and trailing steps, and the trade landing in the list
The BTC/USDC long rising while each trailing step moves the stop on Hyperliquid up behind it, then closing the trade at the stop

Before you start

What you need, and nothing to install

Hyperliquid connects over the internet, straight from Trader Frame. There is no app on your computer, and your main wallet key never leaves your wallet.

A Hyperliquid wallet

The address of the wallet that holds your USDC. For practice, the same wallet on the Hyperliquid testnet.

USDC for margin

Deposited on Hyperliquid. A demo account trades testnet USDC from Hyperliquid’s faucet.

A signal source

TradingView alerts, Telegram, Discord, Copy Trader, or Pip, the AI Trade Agent.

An API wallet

Created on Hyperliquid under More ▸ API. It signs trades for your wallet and can never withdraw.

What happens to every signal
Your signal
Says buy or sell, and the pair
Trader Frame
Size, leverage and exits from your bot
Hyperliquid
Hyperliquid
Order, stop and target placed together

Your bot decides the size, the leverage and the exits. Hyperliquid holds the take profit and stop loss with the position; trailing steps move that stop.

Step by step

From a Hyperliquid wallet to a bot trading BTC/USDC

Practise on the testnet first if you like: steps 4 to 6 are the same for demo and real.

01
Step 1 of 6

Open Hyperliquid in the connect sheet

  • Open Brokers and press + Connect broker.
  • Pick the Crypto tab, then Hyperliquid, and press Continue.

The sheet asks which account to connect: Demo, on the Hyperliquid testnet, or Real.

Opening the connect sheet from the Brokers page, picking the Crypto tab and Hyperliquid, and pressing Continue
02
Step 2 of 6

Practise on the Hyperliquid testnet

  • On the Hyperliquid testnet, open More ▸ API and create an API wallet.
  • Choose Demo, then paste your wallet address and the API wallet private key.
  • Press Connect: the demo account appears with its testnet USDC.

Create the API wallet on the testnet itself: one made on mainnet does not work there. Testnet USDC comes from Hyperliquid’s testnet faucet.

Creating an API wallet on the Hyperliquid testnet, choosing Demo, pasting the wallet address and the API wallet key, pressing Connect, and the demo account appearing with its testnet USDC
03
Step 3 of 6

Connect your real wallet

  • Choose Real.
  • On Hyperliquid, open More ▸ API and create an API wallet: it trades, it can never withdraw.
  • Paste your wallet address and the API wallet private key, then press Connect.

The address is your main wallet, the one that holds your USDC. The key is the API wallet’s: never paste your main wallet’s own private key.

Choosing Real, creating an API wallet on Hyperliquid, pasting the wallet address and the API wallet key, and pressing Connect
04
Step 4 of 6

Build a crypto futures bot on Hyperliquid

  • Create a bot and pick your Hyperliquid account under Brokers.
  • In Position size, pick the trading pair, for example BTC/USDC.
  • Set the trade size: margin, order size or coins.
  • Choose the leverage and the margin mode, Cross or Isolated.

The panel shows what each trade commits: margin, notional at your leverage and the share of your balance. Hyperliquid sets the maximum leverage per market, and the testnet can differ from mainnet.

Picking the Hyperliquid account for a bot, then the BTC/USDC pair, trade size, 10× leverage and margin mode in the Position size panel
05
Step 5 of 6

Set the exits

  • In Exit rule, choose how positions close: Auto close at your target or stop, or follow the signal.
  • Set take profit and stop loss in ROI %.
  • Add trailing steps: each one moves a real stop on Hyperliquid.
  • Check the position preview: prices, fees and the result at take profit and stop loss.
  • Press Save.

Hyperliquid has no trailing order of its own, so the trailing stop runs in Steps: Trader Frame moves your stop as the price climbs, and the stop itself rests on Hyperliquid. ROI % is measured on the margin.

The Exit rule panel: auto close, take profit and stop loss in ROI %, trailing steps, the position preview, then Save
06
Step 6 of 6

Add a signal and switch it on

  • Under Signal sources, add Trading View for your alerts.
  • Press Activate.

Open the Trading View source for the webhook URL and the Buy and Sell alert messages, and paste them into your TradingView alert.

Opening the signal source menu, adding Trading View, and pressing Activate

The alert message

The message only says buy or sell. The bot decides the size, the leverage and the exits.

TradingView
TradingView alert message · strategy
Copy it from the bot’s Trading View panel
{ "symbol": "{{ticker}}", "side": "{{strategy.order.action}}" }
TradingView
Indicator alerts · one per side
Buy opens a long · Sell opens a short
{ "symbol": "{{ticker}}", "side": "BUY" }
{ "symbol": "{{ticker}}", "side": "SELL" }

The alert names the pair the way your chart does, for example BTCUSDT: Trader Frame reads it as BTC/USDC on Hyperliquid. Size, leverage and exits always come from the bot.

AI trading agent for Hyperliquid

Meet Pip: an AI trading agent that trades Hyperliquid inside your limits

Pip is Trader Frame’s Trade Agent. Add it to a Hyperliquid bot instead of an alert: Pip reads the BTC/USDC perpetual market, decides when to go long or short, and explains every decision. Your bot still sets the size, the leverage and the exits.

Suggest
Pip proposes the trade and you place it or skip it. A proposal expires after 5 minutes.
Enter
Pip places the trade itself, inside your bot’s limits: size, leverage, trading hours and plan.
Manage
While its own position is open, Pip can move the stop closer (never wider) or close the trade.
Add Pip to a Hyperliquid bot
Pick Trade Agent under Signal sources

Can an AI agent trade Hyperliquid for me?

Yes. Add Pip, the Trade Agent, to a Hyperliquid bot as its signal source. Pip decides when to buy or sell; the bot places the order on Hyperliquid with your size, leverage and exits.

What does Pip read before a trade?

The pair’s candles on several timeframes, plus the market around them on Hyperliquid: spread, volume, hourly funding on the perpetual and order-book depth.

Does Pip use my exits?

Yes. Take profit, stop loss and trailing steps come from the bot’s Exit rule, and the stop and target rest on Hyperliquid with the position.

How is Pip paid for?

Each look Pip takes uses agent credits from your plan. The Free plan has no agent.

Demo or real

Same bot, two ways in

Both connect the same way, a wallet address and an API wallet key. Demo runs on the Hyperliquid testnet, with its own USDC and its own prices; real runs on mainnet. Everything you build on top is the same, so a bot proven on demo moves to real by changing its broker.

Demo
Real
How it connects
Address + an API wallet made on the testnet
Address + an API wallet made on mainnet
Funds
Testnet USDC
Your USDC
Your main key
Never asked
Never asked: the API wallet signs
Permissions
Trade, never withdraw
Trade, never withdraw
Side by side
One demo account
One real account

Keeping it running

Day to day on Hyperliquid

Exits live on Hyperliquid

Take profit and stop loss rest on Hyperliquid with the position, so they hold on their own. Trailing steps move that stop as the price climbs. Closing by hand in Trader Frame cancels the ones left over.

Leverage and margin mode

Set per bot in Position size. Isolated limits a trade to its own margin; Cross shares your wallet, so the liquidation price depends on your balance.

Fees and funding

The position preview estimates entry and exit fees. Funding on Hyperliquid is paid every hour while a position stays open and changes by market, so it is not priced in advance.

The API wallet

The bot trades through the API wallet you created. If you remove it on Hyperliquid, or it reaches its expiry, create a new one and connect again.

Troubleshooting

What a message means, and what to do

Every refusal and skip is written to the bot’s Signals tab with its reason.

What you see
Why
What to do
Connect: “The broker refused the connection”
The address or the API wallet key was copied wrong, or the API wallet was made on the other network.
Create the API wallet on the same network, testnet for Demo or mainnet for Real, and paste both again.
Connect: “already have a connected account”
One demo and one real Hyperliquid account at a time.
Use the account you have, or disconnect it first.
Account card: “Key rejected”
Hyperliquid no longer accepts the API wallet, for example after it was removed or expired.
Create a new API wallet, then disconnect the account and connect it again.
Demo: the balance reads 0 USDC
The testnet wallet has no testnet USDC yet.
Claim testnet USDC from Hyperliquid’s faucet, then open the account again.
Skipped: “Symbol mismatch”
The alert named a different pair than the bot trades.
Point the alert at the right bot, or change its pair.

FAQ

Hyperliquid questions

Does Trader Frame hold my main wallet key?

No. You paste the key of an API wallet you create on Hyperliquid. It can place and cancel orders for your wallet, and it can never withdraw or move your funds.

What is an API wallet?

A second key that your main wallet approves for trading only. You create it on Hyperliquid under More ▸ API, and you can remove it there at any time.

Which markets can the bot trade?

Hyperliquid USDC perpetuals, such as BTC/USDC, ETH/USDC and SOL/USDC, with the leverage and margin mode you set.

My TradingView alert says BTCUSDT. Does that work?

Yes. Trader Frame reads BTCUSDT, BTCUSD and HYPERLIQUID:BTCUSDC.P all as BTC/USDC on Hyperliquid.

Is there a trailing stop?

Yes, in Steps. Hyperliquid has no trailing order of its own, so Trader Frame moves your real stop on Hyperliquid in steps as the price climbs.

Can I keep demo and real side by side?

Yes. Connect one demo and one real Hyperliquid account, and point each bot at the one you want.

Start on the testnet

Practise on the testnet. Go real with the same bot.

When the bot has earned it, connect your real wallet with a mainnet API wallet and point the same bot at it. Nothing else changes.