What it is

Tessera’s Binance Spot lane pulls spot fills via API keys and/or a Trade History CSV. Futures, margin, and other Binance products are not this lane - use the matching Tessera broker or Custom CSV if you need those.

What you can do

  • Live sync with API key, API secret, and the spot symbols you trade
  • Import Spot Trade History CSV for older history (API sync covers a recent lookback window)
  • Set an optional account start date for analytics inception (does not widen the API fetch window)
  • Start with CSV, then add API keys later

How it works

Choose a method

MethodBest for
API syncRecent spot fills (Tessera paginates trade history for your listed symbols; default lookback is on the order of ~90 days)
Trade History CSVHistory older than the API lookback, or connecting without keys yet

Growth for Binance is trading PnL only. See Portfolio growth.

Connect with live sync

  1. In Binance, create an API key with permission to read spot trade history. Do not enable withdraw unless you need it elsewhere - Tessera only needs trade history access.
  2. In Tessera, choose Binance Spot and enter:
  • API key and API secret
  • Spot symbols you want synced (required - Tessera syncs those pairs)
  • Optional account start date for when analytics should treat the account as starting (portfolio inception, not the API window)
  1. Connect, then run a sync.

API sync is on demand (you trigger sync); it is not the same continuous polling Liquid uses.

Export Spot Trade History CSV

  1. Log in to Binance on the website.
  2. Go to Orders → Spot Order.
  3. Open Trade History (not Order History).
  4. Use Export Trade History, choose your date range (often up to about one year per file), generate, then Download the CSV when ready.

Export limits and download expiry are set by Binance (for example limited statements per month; links may expire after several days). Export Trade History, not Order History or a generic wallet “transaction records” statement.

Official guidance: Binance Support - How to Download Spot Trading Transaction History Statement.

Import the CSV into Tessera

  1. Choose Binance Spot → CSV import.
  2. Enter an account code label for this history in Tessera.
  3. Set statement timezone (spot trade history times are typically UTC - use `Etc/UTC` unless your file clearly differs).
  4. Optionally set asset classes (defaults lean crypto).
  5. Upload the Trade History CSV and import.

After connect

  • Sync API accounts when you want recent fills refreshed.
  • Import additional Trade History CSVs for periods outside the API lookback (non-overlapping ranges work best).
  • If charts look wrong after CSV import, re-check statement timezone (usually UTC).

Limitations

  • Spot only - this lane is not Binance Futures or margin.
  • API sync does not replace full-history CSV for older fills.
  • Portfolio growth stays trading PnL only; transfer history is not fully reconstructed like Liquid live sync.
  • Requires an active subscription.

Resources