This guide explains how to generate and configure API keys for each exchange supported by JiaDX. Follow the instructions for each exchange you want to use.
⚠️ Security First
Always follow these security practices:
- Never enable withdrawal permissions - only trading
- Store your API secret securely - you can't retrieve it later
- Use IP whitelisting if available
- Never share your API keys with anyone
Hyperliquid
Hyperliquid uses wallet-based authentication with API wallet generation.
- Go to app.hyperliquid.xyz
- Connect your wallet
- Click More → API
- Name your API wallet
- Click Generate
- Click Authorize API Wallet
- Set the Days Valid (expiration)
- Save your Private Key securely - you won't see it again!
- Click Authorize to confirm
- In JiaDX Settings, enter:
- 🔑 Public Login Address - Your EVM public address (main wallet)
- 📦 API Wallet Address - Agent wallet address (derived from API private key)
- 🔐 API Private Key - The private key you saved (0x... 66 characters)
Aster
Aster uses traditional API key/secret authentication.
- Go to aster.finance and log in
- Click More → API Management
- Click Create API
- Add a Label (e.g., "JiaDX")
- Copy and save your API Key and API Secret Key immediately
- Set permissions:
- ✅ Enable Reading
- ✅ Enable Futures
- IP Access: Unrestricted or Restricted (add:
51.38.184.107) - Click Confirm and Save
- In JiaDX Settings, enter:
- 🔑 API Key - Your Aster API key
- 🔐 API Secret Key - Your Aster secret key
Paradex
Paradex uses StarkNet L2 wallet authentication with subkeys.
- Go to app.paradex.trade
- Connect your Ethereum wallet and complete onboarding
- Get your Main Account Address:
- Click Wallet → Copy your Paradex Address (MAIN)
- Generate a Subkey:
- Go to Parameters → Key Management → Subkey
- Click Add New Key
- Save the Private Key securely
- In JiaDX Settings, enter:
- 🔑 Main Account Address - Your Paradex address on Starknet L2
- 🔐 Subkey Private Key - The private key shown when you created the subkey (0x... 66 chars)
Lighter
Lighter uses wallet-based authentication with API keys.
- Go to app.lighter.xyz
- Connect your wallet
- Click Tools → API Keys
- Click Generate API Key
- Save all the credentials securely
- In JiaDX Settings, enter:
- 🔗 L1 Address - Your Ethereum wallet address connected to Lighter
- 🔢 API Key Index - Index of your API key (2-254)
- 🔑 Public Key - Your API public key
- 🔐 Private Key - Your API private key
Adding Keys to JiaDX
Once you have your API keys:
- Log in to JiaDX
- Click ⚙️ API Settings in the header
- Find the exchange section
- Enter your API credentials
- Click Save
- JiaDX will verify the connection
✅ Verification
After saving, JiaDX will show a green checkmark if the connection is successful. If you see an error, double-check your keys and permissions.
Troubleshooting
Connection failed:
- Verify you copied the full key without extra spaces
- Check that trading permissions are enabled
- Ensure the API key hasn't expired
- Try generating a new key
Orders not executing:
- Verify trading permissions are enabled
- Check you have sufficient balance
- Ensure the API key has the correct permissions