Skip to content

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. 1

    Open the API page

    Go to app.hyperliquid.xyz/API and connect your main wallet.

  2. 2

    Authorize an API wallet

    Generate a new one and copy its private key.

  3. 3

    Copy your main address

    Use the 0x address of your main account.

  4. 4

    Paste both in Nyria

    Add the address and the key on the Hyperliquid card.

  5. 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

Try a paper bot first

No card required. Paper is free. Live trading from $15 a month.