Guide
Why does Nyria say the Hyperliquid API wallet is unauthorized?
Nyria shows Hyperliquid says the API wallet is unauthorized when that wallet isn't approved for your account. Authorize a new API wallet at app.hyperliquid.xyz/API. Then paste its private key in Nyria.
Official documentation
Fix: the Hyperliquid API wallet is unauthorized
- 1
Open the API page
Go to app.hyperliquid.xyz/API and connect your main wallet.
- 2
Authorize an API wallet
Generate a new one and copy its private key.
- 3
Copy your main address
Use the 0x address of your main account.
- 4
Paste both in Nyria
Add the address and the key on the Hyperliquid card.
- 5
Connect again
Tick that you're not a US person, then connect.
What the message means
- Hyperliquid doesn't recognize that wallet for your account.
- Nyria passes on the answer.
- Nothing connected.
- No order was placed.
- A newly authorized wallet is the usual fix.
Common causes
- The API wallet was never authorized.
- The API wallet was removed later.
- The key belongs to a different wallet.
- The main address is the API wallet's address.
- The key was copied with a character missing.
Two wallets, two jobs
- Your main wallet holds the funds.
- The API wallet signs trades for it.
- Nyria needs the address of the first.
- Nyria needs the key of the second.
What the API wallet can do
- It can place and cancel trades.
- It can't withdraw funds.
- Withdrawals need your main wallet.
- Nyria never sees that wallet.
Still stuck
- Make a fresh API wallet for this connection.
- Copy its private key before you leave the page.
- Paste the main address, not the API wallet's.
- Paper uses the Hyperliquid testnet.
Questions
- What does the API wallet is unauthorized mean?
- Hyperliquid doesn't approve that wallet for your account.
- How do I fix it?
- Authorize a new API wallet and paste its private key.
- Which address do I enter?
- Your main account address.
- Can the API wallet withdraw?
- No. It only signs trades.
- Who can connect Hyperliquid?
- It isn't available to US persons.
- Can I test first?
- Yes, on Nyria Paper.
Next
- Paste an alert into the alert tester to see how Nyria reads it.
- Step by step for one account: how to automate TradingView to Nyria Paper.
- Step by step for one account: how to automate Webhook to Nyria Paper.
- Alert tester.
Guides
How broker API trading works
What a broker API does and does not do, and the receiver that reads your alerts and places the orders for you.
Read guideCan Nyria withdraw money from my broker account?
No. Nyria reads balances and sends orders. Your cash stays at your broker.
Read guideDo I give Nyria my main Hyperliquid wallet key?
No. You enter your main address and a separate API wallet's key.
Read guideTry a paper bot first
No card required. Paper is free. Live trading from $15 a month.