Workspace / Falcon Alpha

User Guide

Reference guide for understanding balances, PNL, funding, sync behavior, and how to interpret the portfolio data shown in the app.

Auto sync is conservative for live exchanges and only runs when an account is safely stale

What This App Tracks

This product is built as an audit-friendly crypto portfolio and trading operations workspace across spot and futures accounts.

Dashboard

Executive operating view across balances, exposure, funding, sync health, and recent activity.

Use this first to understand portfolio size, funding drag, connector health, and the highest-risk open positions.

Balances

Latest holdings by asset, account, and exchange using the most recent snapshot per account, snapshot type, and asset.

Use this to verify what is currently held and whether valuation is marked or still waiting for a price.

Analytics

Portfolio balance curve, open unrealized PNL history across futures positions, and funding history across the selected date range.

Use this to see daily balance evolution and how open unrealized PNL has moved over time across all Binance and Bitget futures accounts. Days carry forward the latest known values per account until a newer snapshot replaces them.

PNL Analytics

Booked and open PNL, fees, and attribution by account, symbol, and strategy.

Use this when reviewing trading performance rather than wallet balances.

Funding

Funding payment ledger and historical funding totals.

Use this to separate funding cashflows from execution PNL and trading fees.

Trades / Orders / Positions

Execution and position-level audit trail across spot and futures.

Use these pages when you need drill-down rather than portfolio-level summaries.

How Balance Valuation Works

These rules explain why the current portfolio value may differ from what you expect if some assets are unpriced or some accounts synced at different times.

  • Latest marked portfolio value uses the latest snapshot for each exchange account, snapshot type, and asset, then applies either stored valuation_usd or a fallback market mark for major assets when available.
  • If an asset shows Pending price mark, the app has quantity data but does not currently have a usable USD mark for that asset from the fallback price source.
  • Stablecoin-like assets such as USDT, USDC, FDUSD, BUSD, TUSD, and USDP are treated as approximately 1 USD unless the exchange provided a direct valuation.
  • The Balances page hides zero-quantity rows by design so users only see active holdings.
  • When both spot and futures snapshots exist for the same asset, they are treated separately by snapshot type so one does not overwrite the other.
  • On the Balances page, Binance USDT rows with basis Futures wallet show a hoverable question-mark helper in the Quantity column. That balance should be read as unrealized PNL + margin + available balance.

How To Read Binance Futures Wallet USDT

This is the key interpretation note for Binance futures-heavy accounts on the Balances page.

  • Locked on the Balances page means quantity not currently free for withdrawal or immediate spot reuse inside that snapshot context.
  • For Binance USDT rows with basis Futures wallet, the Quantity value should be read as unrealized PNL + margin + available balance.
  • That means Binance futures wallet quantity is not just idle wallet cash. It is the broader futures wallet state for that asset inside the account.
  • Available and Locked still help explain how much of that wallet is immediately free versus tied to margin usage, but the Quantity number itself is the full futures wallet total.
  • Because exchanges model wallet, margin, and unrealized PNL differently, futures wallet values should be treated as an exchange-specific operational interpretation rather than a universal accounting standard across every venue.

How PNL Is Interpreted

The app separates open performance, closed performance, funding, and fees so users can trace where results are coming from.

  • Realized PNL should reflect closed trade or position outcomes that the exchange has already booked.
  • Unrealized PNL reflects the mark-to-market gain or loss of still-open futures positions.
  • Funding is tracked separately from trading fees and from execution PNL so it remains audit-friendly.
  • Fee leakage is intended to show all recorded fees for the selected period, not only fees visible on the currently loaded table page.
  • A strategy, symbol, or account card should be interpreted as the aggregate of realized PNL, unrealized PNL, funding, and fees according to that page's definitions, not just one component.
  • The Analytics page now includes a daily history chart of open unrealized PNL summed across all futures-margined accounts on Binance and Bitget. Each day is the latest known per-account value carried forward and summed, converted to USD.

How Sync And Data Integrity Work

These points explain what the sync engine is trying to guarantee and why imported data can still depend on exchange permissions and endpoint behavior.

  • Exchange sync is designed to be idempotent. Re-running a sync should update existing normalized records instead of creating duplicates when unique identifiers are available.
  • The app separates raw exchange fetches, normalized records, and computed analytics so calculations remain traceable and reproducible.
  • Auto-sync checks every 30 minutes and only runs accounts that are stale. Auto-sync is now capped to the latest 3 days of history so routine refreshes stay light and are less likely to hit exchange rate limits.
  • Manual sync on the Exchange Connections page now accepts a days value. Use a short range like 3 to 7 days for routine refreshes, and only use larger ranges such as 30, 90, or 180 days when you intentionally want a deeper backfill.
  • If a connector validates successfully but imports zero rows, that usually means the exchange endpoint returned no matching data for the requested account mode, permissions, or time window.
  • Sync Logs now record the effective lookback window for each sync, so operators can tell whether a run was a short refresh or a deeper backfill.
  • If one account does not sync on a given day, analytics balance history now carries forward the latest known values instead of dropping that account from the curve.

Important Definitions

Use these definitions when reading cards, charts, and tables across the app.

Portfolio Value

The summed USD valuation of the latest known holdings across all included accounts and snapshot types.

Balance History

A time series built from historical balance snapshots. Daily charts now carry forward prior balances until newer snapshots arrive.

Funding

Periodic cashflow between longs and shorts in perpetual futures. It is not the same as execution PNL.

Margin Used

Capital committed to support open leveraged futures positions.

Unrealized PNL

Open profit or loss that exists at the current mark price but is not yet booked as realized PNL. The Analytics page charts a daily history of this value summed across all open futures positions on Binance and Bitget.

Transfer-Adjusted PNL

Performance after excluding deposits, withdrawals, and internal transfers that should not be mistaken for trading gains or losses.

Troubleshooting Reading Differences

Use these checks before deciding that a number is incorrect. Most apparent mismatches come from date ranges, missing marks, or exchange-specific accounting rules.

  • If balances look lower than expected, first compare the Balances page total with the Analytics page date range. Analytics is range-based, while Balances is the latest current state.
  • If a chart point looks too low, it usually indicates either a real decrease in holdings or missing marks for some assets. Major assets are fallback-priced when possible, but not every asset can be auto-marked.
  • If trades, funding, or transfers look incomplete, verify the exchange API key permissions, account mode, and whether the venue exposes that dataset for the specific account type you connected.
  • If values differ from the exchange UI, remember that exchange apps sometimes blend wallet balance, cross margin, unrealized PNL, bonus balances, and pending settlements differently from API endpoints.
  • Use Sync Logs to confirm what the last sync actually imported before assuming the page itself is wrong.
Trade Manager Codex