Skip to content

Guide

Do I give Nyria my main Hyperliquid wallet key?

No. Nyria asks for your main account address and the private key of an API wallet. An API wallet only signs trades for your account and can't withdraw. Withdrawals need your main wallet, which Nyria never sees.

Official documentation

Connect Hyperliquid with an API wallet

  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

    Add both in Nyria

    Paste the address and the key on the Hyperliquid card.

  5. 5

    Confirm and connect

    Tick that you're not a US person, then connect.

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.

One API wallet per connection

  • Make a new API wallet for each connection.
  • The main address goes in, not the API wallet's.
  • Nyria stores the key encrypted and never shows it again.

Testing first

  • Paper uses the Hyperliquid testnet.
  • Use app.hyperliquid-testnet.xyz/API there.
  • Nyria Paper also simulates perps without a wallet.

Who can connect

  • Hyperliquid isn't available to US persons.
  • The connect form asks you to confirm.
  • A strategy can lose money.

Questions

Do I give Nyria my main wallet key?
No. Only an API wallet's key.
Which address do I enter?
Your main account's 0x address.
Can the API wallet withdraw?
No. It only signs trades.
Can I reuse one API wallet?
Make a new one per connection.
Is Nyria's key storage encrypted?
Yes. It's encrypted at rest.
Can US persons connect?
No. Hyperliquid isn't available to them.

Next

Try a paper bot first

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