Connecting an Exchange

This guide walks you through connecting your centralized exchange account to Arjia.

Supported Exchanges

• Bybit — Spot, derivatives, and grid trading
• Binance — Spot and derivatives trading

Step 1: Create API Keys on Your Exchange

Bybit

1. Log in to your Bybit account
2. Go to Account → API Management
3. Click Create New Key
4. Set a name (e.g., "Arjia Trading")
5. Set permissions:
   • Read — Required (enables position and balance tracking)
   • Trade — Required for grid bots (enables order placement)
   • Withdraw — Do NOT enable this
6. Set IP restrictions if desired (recommended for production use)
7. Copy your API Key and API Secret

Binance

1. Log in to your Binance account
2. Go to Account → API Management
3. Click Create API
4. Choose key type:
   • HMAC — Standard API key and secret
   • RSA — More secure, uses public/private key pair
5. Set permissions:
   • Enable Reading — Required
   • Enable Spot & Margin Trading — For trading features
   • Enable Futures — For derivatives trading
   • Do NOT enable Withdrawals
6. Copy your API Key and Secret

⚠️ Security Warning: Never enable withdrawal permissions for API keys used with third-party services. Arjia does not need withdrawal access.

Step 2: Add API Keys to Arjia

1. Navigate to Settings → Exchange Connections
2. Click Add Exchange
3. Select your exchange (Bybit or Binance)
4. Enter your API Key
5. Enter your API Secret
6. Select authentication type (HMAC or RSA)
7. Click Save

Step 3: Test the Connection

1. After saving, click Test Connection
2. Arjia will attempt to read your account information
3. If successful, you'll see your exchange balance appear
4. If it fails, verify:
   • API key and secret are correct (no extra spaces)
   • Read permission is enabled on the exchange
   • IP restrictions aren't blocking Arjia's servers

Step 4: Configure Sync Settings

• Auto Sync — Automatically sync positions and balances (recommended)
• Sync Interval — How frequently to update data
• Import Trades — Automatically log exchange trades in your Trade Journal

API Key Security

Arjia protects your API keys with:

• AES-256 Encryption — Keys are encrypted before storage
• Never Plaintext — Keys are only decrypted at the moment of API calls
• Secure Transmission — All communication uses HTTPS
• Key Rotation — You can rotate keys at any time by updating the connection

For maximum security, consider using RSA authentication (supported on Binance) where Arjia holds only the private key and you register the public key on the exchange.

Troubleshooting

"Invalid API Key" Error

• Double-check the API key and secret for typos
• Ensure the key is active and not expired
• Check if the key has been revoked on the exchange

"Permission Denied" Error

• Verify that Read permissions are enabled
• For trading features, ensure Trade permissions are enabled
• Check if the key has IP restrictions that block Arjia

Data Not Syncing

• Try a manual sync from the exchange dashboard
• Check that your exchange account has positions/trades to sync
• Verify the API key hasn't been rate-limited