Connecting Your Wallet

Predite reads your live positions, balances, and P&L directly from your trading accounts — and, on the right plan, can place orders for you. None of that works until you connect a wallet. This page explains exactly what a connection is, how to set one up for both Polymarket and Kalshi, the three Polymarket signature types, what a funder address is, and how we keep your keys safe.

## What "connecting a wallet" actually does

There are two distinct things you can grant Predite, and it's worth being precise about the difference because they have very different security profiles:

You decide which one you want per wallet. A read-only connection never asks for a private key. You can start read-only and upgrade to trading later, or downgrade at any time by disconnecting and reconnecting.

> **Plan gating:** Read-only connections and real-money portfolio tracking are available on **all plans (Starter $29, Pro $59, Bot $99)**. Manual **Live Trading** and **TWAP Orders** require **Pro or Bot**. Fully automated execution — the Bot running strategies and **Copy Trading** with auto-fill — requires the **Bot $99/mo** plan. If you connect a trading wallet on Starter, you'll still get full read-only data; the execute buttons simply stay disabled until you upgrade.

## Where to find it

Everything lives in **Settings → Trading API**. From any screen:

1. Open **Settings** from the left sidebar (or the gear icon, top right). 2. Select the **Trading API** tab. 3. You'll see two cards: **Polymarket** and **Kalshi**, each showing a status badge — `Not connected`, `Read-only`, or `Trading enabled`.

Each card expands into its own connection flow. You can connect one venue, both, or neither. Predite features degrade gracefully: connect only Kalshi and the Polymarket-specific tooling just won't show data.

## Connecting Polymarket

Polymarket runs on Polygon and settles through its CLOB (Central Limit Order Book). Because Polymarket accounts come in a few flavors, this is the more involved of the two connections. You'll provide three things: a **private key**, a **signature type**, and — for two of the three types — a **funder address**.

### Step by step

1. In **Settings → Trading API**, click **Connect** on the Polymarket card. 2. Choose **Read-only** or **Trading**. - For **Read-only**, paste only your **public wallet address** (the `0x…` address). Click **Verify** and you're done — skip to the verification note below. - For **Trading**, continue with the steps below. 3. **Select your signature type** (see the next section — this is the single most common source of connection errors). 4. **Paste your private key.** This is the key for the account that signs CLOB orders. It's a 64-character hex string, with or without the `0x` prefix. 5. **Enter your funder address** if your signature type requires one (types 1 and 2 — explained below). For an EOA (type 0), leave this blank. 6. Click **Test connection.** Predite derives the signer address from your key, queries the CLOB for your balance and any open positions, and shows you a confirmation summary: the signer it derived, the funder it will trade from, and your current USDC balance. 7. Confirm the summary matches what you expect, then click **Save & encrypt.** Your key is encrypted before it ever touches our database (details in the security section).

### The three signature types

Polymarket supports three account architectures, and the CLOB needs to know which one you're using so it builds the order signature correctly. Pick the wrong one and orders will be rejected with a signature-mismatch error even though your key is valid.

A quick way to decide: if you log into Polymarket with an email, you're almost certainly **type 1**. If you log in by connecting a browser wallet, you're **type 2**. If you never used the Polymarket site and funded a raw wallet yourself, you're **type 0**.

### What a funder address is

The **funder address** is simply *the address that holds the USDC and the position tokens* — the account that actually gets debited when you buy and credited when you sell. In type 0, the signer and funder are the same address, so there's nothing to enter. In types 1 and 2, Polymarket separates the *signer* (the key that authorizes an order) from the *funder* (the contract that holds and moves the money). The CLOB matches orders to the funder, so if you omit it or paste the signer address by mistake, the exchange will report a zero balance or reject the order.

You can find your funder address in Polymarket under **your profile → deposit address**, or by copying the address shown on your Polymarket portfolio page. It will be different from the address derived from your private key — that's expected and correct for types 1 and 2.

### Common Polymarket gotchas

## Connecting Kalshi

Kalshi is a regulated US exchange and doesn't use crypto wallets or private keys in the Polygon sense. Instead, you connect with a **Kalshi API key**.

1. In Kalshi, go to **Account → API Keys** and generate a key. Kalshi gives you a **Key ID** and a **private key** (an RSA key used to sign API requests). Download or copy both — Kalshi only shows the private key once. 2. In Predite, click **Connect** on the Kalshi card in **Settings → Trading API**. 3. Choose **Read-only** or **Trading**. (Kalshi's API key model means the same credential can do both; choose **Read-only** if you want Predite to ignore the trading permission and never place orders.) 4. Paste your **Key ID** and **private key**. 5. Click **Test connection.** Predite authenticates, pulls your balance and open positions, and shows a summary. 6. Click **Save & encrypt.**

Kalshi notes:

## How we secure your key

This is the part that matters most, so we'll be specific.

If you'd rather not store a signing key at all, use a **read-only** connection. You'll lose execution features but keep full portfolio analytics, journaling, and EV alerts. For the complete threat model and our data-handling commitments, see the **Security** page.

## Disconnecting a wallet

You can revoke access at any time:

1. Go to **Settings → Trading API**. 2. On the relevant card, click **Disconnect.** 3. Confirm. We **permanently delete** the stored ciphertext of your key from our systems. Read-only public addresses are also removed.

Disconnecting immediately disables any feature that depends on that wallet — the Bot pauses, Copy Trading stops mirroring, and live execution buttons grey out. Your historical Trade Journal entries and P&L records are kept (they're your data, not your key), so disconnecting doesn't erase your performance history.

For maximum safety after disconnecting a *trading* wallet you no longer trust, rotate the underlying secret at the source: generate a new Kalshi API key, or for Polymarket move funds to a fresh wallet. Deleting it from Predite removes our copy, but only you can invalidate the key itself.

## Verifying it worked

After connecting, head to the **Portfolio** page. Within a few seconds you should see your live positions, cost basis, and unrealized P&L pulled straight from the exchange. If the **Trading API** card shows `Trading enabled` and Portfolio is populated, you're fully set up. From there:

If positions don't appear, revisit the signature-type and funder-address checks above — that resolves the large majority of Polymarket connection issues.

## Related Docs