Connecting an exchange
How to add an exchange account, what API permissions are needed, and how the engine uses your key.
This guide explains how to add a live exchange account to Coinrule, what API key permissions are required, and what the engine does once a connection is established. Paper trading accounts are also available on any supported exchange without a live API key.
How does it work?
Coinrule connects to exchanges using your API key or wallet. Coinrule never has your password and cannot withdraw your funds — API keys can be scoped to trading only.
When you connect an account, the engine:
- Validates the key by reading your balances (read-only call)
- Subscribes to market data for your configured pairs
- Places orders when your strategy conditions are met
Which exchanges are supported?
| Venue ID | Display name | Asset type |
|---|---|---|
| binance | Binance | Spot |
| binance_us | Binance.US | Spot |
| binance_futures | Binance Futures | Perpetuals |
| coinbase | Coinbase | Spot |
| coinbase_perps | Coinbase Perps | Perpetuals |
| kraken | Kraken | Spot |
| kraken_futures | Kraken Futures | Perpetuals |
| kucoin | KuCoin | Spot |
| bybit | Bybit | Spot |
| bybit_perps | Bybit Perps | Perpetuals |
| okx | OKX | Spot |
| okx_futures | OKX Futures | Perpetuals |
| gate | Gate | Spot |
| gate_futures | Gate Perps | Perpetuals |
| bitget | Bitget | Spot |
| bitget_futures | Bitget Futures | Perpetuals |
| htx | HTX | Spot |
| htx_perps | HTX Perps | Perpetuals |
| crypto_com | Crypto.com Exchange | Spot |
| upbit_sg | Upbit | Spot |
| hyperliquid | Hyperliquid | Perpetuals (on-chain) |
| trading212 | Trading 212 | Stocks / ETFs |
| alpaca | Alpaca | Stocks / ETFs |
| public | Public | Stocks / ETFs |
| webull | Webull US | Stocks / ETFs |
| etrade | E*TRADE | Stocks / ETFs |
| robinhood_agentic | Robinhood Agentic | Stocks / ETFs |
| tastytrade | tastytrade | Stocks / ETFs |
| moomoo | moomoo | Stocks / ETFs |
Each venue has its own setup guide:
- Crypto exchanges: Binance, Coinbase and Coinbase Perpetuals, Kraken spot and Kraken Futures, KuCoin, Bitget, HTX, Crypto.com Exchange, Upbit
- On-chain: Hyperliquid, Arbitrum, Base
- Stock brokers: Trading 212, Robinhood Agentic, tastytrade, moomoo
How do I connect an exchange?
Go to /connect
Navigate to the Connect page (avatar menu → Connect, or go to
/connect).Choose an exchange
Select the exchange from the list.
Follow the exchange-specific guide
Each exchange has a dedicated setup page with the exact permissions to enable. See the exchange guides in this section.
Paste your API key and secret
On the Coinrule connection form, paste the key and secret. For Binance, Coinbase, and Kraken you can also use OAuth instead of API keys. US stock brokers (Robinhood Agentic, tastytrade, moomoo, E*TRADE) use Fast Connect, a hosted sign-in with no API keys at all, and Hyperliquid uses a wallet signature.
Verify
Coinrule runs a read-only test. If successful, the account appears in your accounts list with "Connected" status.
What happens after I connect?
- Your balance and portfolio data is shown in the Portfolio section.
- You can now launch live agents against this account.
- The engine subscribes to real-time price data for your active pairs.
- Your connected venues become available to AI assistants through the Coinrule MCP, so you can trade across every exchange and broker you connect straight from Claude, ChatGPT, or Grok.
Can I connect multiple accounts?
You can connect multiple accounts — on the same or different exchanges — up to your plan limit.
| Plan | Agents | Exchanges | Credits / mo | Live trading |
|---|---|---|---|---|
| Free | 1 | Paper only | 50 | — |
| Investor | 3 | 1 | 1,000 | ✓ |
| Trader | 10 | 5 | 10,000 | ✓ |
| Pro | Unlimited | Unlimited | 100,000 | ✓ |
| Enterprise | Unlimited | Unlimited | Unlimited | ✓ |
Security
- Use a separate API key for Coinrule, not one you use elsewhere.
- Restrict the key to the minimum permissions shown in each exchange guide.
- Never enable "withdraw" permissions.
- See API key permissions and security for more.