Hannya

Connect my API key

The robot takes its positions on YOUR account, with an API key with limited rights: trading only, never withdrawals. Here is how to create it, exchange by exchange. No exchange account yet? The A-to-Z guides

The three rules, whatever the exchange

  1. Trading only

    Tick the read and trading rights (spot and futures depending on the robot). NEVER tick withdrawal or transfer: without that right, nobody can move a cent out of your account, even with the key.

  2. The IP address on the whitelist

    When the exchange offers to restrict the key to IP addresses, enter this one, and only this one: 204.168.249.237
    That is the address the orders come from. A key without IP restriction works too, but it is less protected.

  3. Paste the key with us, once

    On the robot's purchase page or in Accounts: account name, key, secret (and the passphrase on KuCoin). It is encrypted on receipt and never shown again, to anyone. The “Validate” button reads your balance to check it works.

    Imperial is different: you only paste a 30-day session token, generated on the site (see below).

KuCoin Create the key on KuCoin

  1. Open the API management

    On kucoin.com, logged in: your avatar at the top right → “API Management” → “Create API”. Choose “API Trading”.

  2. Name and passphrase

    Give it a name (for example “Hannya”) and a passphrase: YOU choose it, write it down, KuCoin never shows it again. With us, it is the third field.

  3. Rights

    Tick “General” and “Futures Trade” (and “Spot Trade” if the robot is spot). Leave “Withdrawal” and “Transfer” unticked.

  4. IP restriction

    Choose “Restricted” and enter the address above. Then confirm (e-mail code, SMS or Google Authenticator).

  5. Collect the three values

    KuCoin shows the key (API Key) and the secret only once: copy them right away with your passphrase, and paste all three with us.

MEXC Create the key on MEXC

  1. Open the API management

    On mexc.com, logged in: your avatar → “API Management” → “Create API”.

  2. Rights

    Tick account reading and Futures trading (and Spot if the robot is spot). Leave withdrawal unticked.

  3. IP restriction

    Add the address above to “IP whitelist”: on MEXC, a key without a whitelist expires after 90 days; with a whitelist it does not expire.

  4. Collect the key and the secret

    The secret is shown only once: copy it right away, then paste the key and the secret with us.

Hyperliquid Create the key on Hyperliquid

  1. Open the API page

    On app.hyperliquid.xyz, wallet connected: menu “More” → “API”. Hyperliquid is a DEX: the key is an “API wallet” (agent) allowed to trade for your main wallet, never to withdraw.

  2. Generate the API wallet

    Give it a name, click “Generate”, then “Authorize API Wallet” and sign with your main wallet. Write down the API wallet's private key: it is shown only once.

  3. What you paste with us

    API key = the address of YOUR main wallet (0x…). Secret = the API wallet's private key (never your main wallet's). No IP whitelist on Hyperliquid.

  4. One direction per pair

    Hyperliquid has no hedge mode: one position per pair and per account. A long bot and a short bot on the same pair can both exist, but not hold a position at the same time: while one is in a position or waiting for its entry, the other sends nothing. To hold both directions at once, connect a second Hyperliquid account — another wallet, with its own agent key — and put the long bots on one and the short bots on the other. Hyperliquid's sub-accounts only open after $100,000 of volume, and the site does not handle them yet.

Aster Create an agent at Aster

  1. Deposit first

    Aster refuses every signed call until your wallet has made a deposit.

  2. Open the agent page

    On asterdex.com, connected with your wallet: More → "API Management", "Pro API" tab, "Authorize new API wallet". An agent is a separate key that your wallet signs once.

  3. Rights

    Allow perpetuals trading and keep withdrawal closed: the dashboard reads the agent's rights back and refuses one that can withdraw.

  4. IP list

    Add this address, and only that one. 204.168.249.237

  5. Report the key

    Copy the agent's private key and paste it on the Aster tile of the Accounts page, with your account's address, the one shown at the top right on Aster (0x… or a Solana address), not the agent's. Never your wallet's private key: the dashboard refuses it. An agent has an expiry date: renewing it will need your signature.

  6. Hedge mode

    The dashboard works in Hedge mode, one position per direction. On the first order, it switches your account if it is empty. If orders or a position are open in One-way mode, it refuses and tells you.

Imperial Create the token at Imperial

  1. Open API access

    On imperial.space, signed in (Phantom or Solflare wallet, or e-mail/Google): “API Access” → “Generate API Token”. Imperial is a perpetuals DEX on Solana: there is no key or secret, but a session token.

  2. Sign the session

    Your wallet signs “Approve Trading Session”: no deposit, no order, no withdrawal — the token trades, it cannot move funds out. Copy it right away: Imperial does not show it again.

  3. What you paste with us

    The token alone, with the account name: your wallet address and the expiry date are inside it. No IP whitelist at Imperial.

  4. Every 30 days

    The token expires after 30 days: generate it again on imperial.space and paste it into “Renew the token” on the account row — without deleting the account. To revoke it earlier: “End session” on imperial.space.

And then

A key can be revoked in one click on the exchange, at any time: the robot then stops on its own. With us, “Delete” in Accounts erases the encrypted key.