# Integrations

* **ByBit**
* **Binance Futures**

***

### 1. Why Integrate?

*By connecting your exchange:*

* **Sync Balances & PnL** – See your real‐time portfolio performance in our dashboards.
* **Unlock Free Pro Access** – If you signed up via our referral, integration verifies eligibility.
* **Enable Market Scan Signals** – Pull in your actual positions to show weighted exposure in AI Scan.
* **One‐Click Chart Analysis** (Pro uses) – Open any chart directly from your exchange’s trading view.

***

### 2. Obtaining Your API Keys <mark style="color:yellow;">(coming soon)</mark>

#### ByBit

1. Log in to your ByBit account.
2. Navigate to **Account & Security → API Management**.
3. Click **Create New API Key**.
   * Label it “TradingWizard AI.”
   * Set permissions: `Read‐only` (Orders, Positions, Balances).
   * Restrict IP to `*` (or your server’s IP if you want extra security).
4. Copy the **API Key** and **Secret Key**.
5. Keep your Secret Key somewhere safe—ByBit only shows it once.

#### Binance Futures

1. Log in to Binance Futures.
2. Go to **API Management**.
3. Click **Create API**.
   * Label it “TradingWizard AI.”
   * Enable **Enable Reading** (Futures → Trade/History).
   * Restrict IP to `*` (recommended: your server’s IP).
4. Copy **API Key** and **Secret Key**.

***

### 3. Connecting to TradingWizard AI <mark style="color:yellow;">(coming soon)</mark>

1. Go to **Integrations** in the left nav.
2. Click **Add New Exchange**.
3. Choose **ByBit** or **Binance Futures**.
4. Paste your copied **API Key** and **Secret Key** into the form fields.
5. (Optional) Give your integration a nickname (e.g., “ByBit Main Account”).
6. Click **Save**.
7. Wait a few seconds—TradeWizard AI will fetch your account balances and open positions.

> 🔄 To resync later, click the **Resync** icon next to your saved exchange. Useful if you’ve opened new positions or changed your leverage.

***

### 4. Smart Portfolio Sync <mark style="color:yellow;">(coming soon)</mark>

Once connected:

* You’ll see your **Current Balances** on the dashboard.
* In **Market Scan**, any signals that relate to assets in your portfolio are highlighted (e.g., “Your BTC is exposed; caution advised today.”).
* **Chart Analyzer** can automatically fetch your current symbol’s live chart. Just type “XAU/USD” or “BTC/USDT” into the **Symbol** box above the analysis image.

***

### 5. Removing an Integration <mark style="color:yellow;">(coming soon)</mark>

1. In **Integrations**, hover over an existing exchange.
2. Click the **Trash** icon.
3. Confirm removal.
4. Your API keys are irreversibly deleted; TradingWizard AI will no longer fetch data from that exchange.

***

### 6. Security & Permissions

* **Read-Only** keys ensure we can only pull market data and balances—never place trades.
* We never store your Secret Key in plaintext; it’s encrypted end‐to‐end.
* If you suspect any compromise, delete the API key on your exchange immediately and create a new one.

***

*Last updated: June 2025*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tradingwizard.ai/general/integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
