TrueHold

HelpConnecting

Connect an exchange with a read-only API key

Create a read-only key on the exchange, paste it into TrueHold, and balances, positions and history appear. The key is validated before it is stored.

TrueHold reads exchange accounts through API keys that can only read. Trading and withdrawal permissions are never required, so leave them off: where the exchange lets TrueHold check, a key that carries them is refused.

Steps

  1. 01On the exchange, open the API management page and create a new key with read permission only. The exact permission name differs by venue; the coverage page for each exchange on this site shows which box to tick.
  2. 02If the exchange offers an IP allowlist, ask support for the addresses to bind; a bound key is the safer setup. A read-only key also connects without an allowlist, although some exchanges expire unbound keys.
  3. 03In TrueHold, open Exchanges and choose Link an exchange. Pick the venue, paste the API key and secret, and the passphrase where the exchange uses one.
  4. 04The key is validated against the exchange before it is stored. If validation fails, the exchange rejected the key or its permissions; check that read access is enabled and that the secret was copied in full.
  5. 05Balances refresh within seconds of a successful validation. Futures, margin and earn balances arrive with the same key as spot.

Which exchanges

Binance, OKX, Bybit and Backpack connect through their own APIs. Kraken, Coinbase, MEXC, Bitget, Gate, BingX and a long tail of other venues connect through a shared connector. If your venue issues API keys, try it; the coverage page lists the ones people ask about most. Prediction markets connect separately: Polymarket by address and Kalshi with API credentials.

Related

What TrueHold can and cannot do with your keys

TrueHold asks for read-only keys, validates them before storing and encrypts them at rest. A read-only key cannot trade or withdraw; revoke it any time.

Replace or rotate an API key

Open the exchange account in TrueHold, replace the key from its settings, and the account keeps its history. Expiring keys are flagged in advance.

Why a sync failed and what to do

A failed sync usually means a revoked or expired key or an exchange outage. TrueHold retries, emails you if it keeps failing, and lets you re-connect.

Still stuck?

Write to hello@truehold.xyz with the screen you are on. Answers become docs, so the next person finds it here.

Open TrueHold