Positions, snapshots, and holdings

Structure ingests detailed positions and balances from your trading accounts and turns them into the holdings you see in the UI. This page explains that pipeline at a conceptual level.

Raw positions and balances

Every trading account holds:

• Positions in instruments:
  • For example, a long SOL‑PERP position on a derivatives venue.
• Balances in assets:
  • For example, USDC collateral, funding tokens, or settlement currency.

Venues update these as markets move and as your strategies trade.

Position snapshots (internal)

Instead of storing just the latest state, Structure keeps a history of snapshots for each account. Conceptually, a snapshot includes:

• The account it belongs to.
• A timestamp.
• A set of positions, each linked to:
  • An instrument (such as SOL‑PERP).
  • Quantities (for example, base and quote exposure).
• A set of balances, each linked to:
  • An asset (such as SOL or USDC).
  • A quantity (for example, 123.45 units).

Whenever new data arrives:

• Structure appends a new historical snapshot.
• It also updates a fast “latest snapshot” per account, representing the most recent known state.

You do not interact with snapshots directly, but they power:

• The Holdings view.
• Any analytics or history tooling built on top of your positions.

Holdings (user view)

The Holdings view is the trader‑friendly aggregation of the latest snapshots. Each row typically represents a combination of:

• A venue (for example, Drift).
• A trading account at that venue.
• An asset or instrument.

For each row you may see:

• Symbol and name – for example, SOL or SOL‑PERP.
• Venue – which exchange or protocol this belongs to.
• Venue account – which trading account is holding the position or balance.
• Quantity – normalized to human‑readable units.
• Optional metrics such as:
  • Mark‑to‑market value.
  • P&L.
  • Margin requirements.

Conceptually, holdings answer:

• “What do I own, and where?”
• “Which strategies and accounts are driving my exposure?”

Relationship to strategies and accounts

Holdings are always derived from:

• Trading accounts:
  • Each holding is tied to a specific venue account.
  • That account, in turn, may be assigned to a specific strategy.
• Venues, assets, and instruments:
  • Holdings refer to venue‑specific instruments and chain‑specific assets.

When you filter holdings:

• By strategy – you see only holdings belonging to accounts assigned to that strategy.
• By venue – you see how your exposure is distributed across exchanges or protocols.
• By trading account – you zoom in on a single venue account.

Why this model matters

By separating raw snapshots from holdings, Structure can:

• Maintain a detailed history for analysis and compliance.
• Provide fast, up‑to‑date portfolio views.
• Allow you to slice your risk by:
  • Strategy.
  • Venue.
  • Account.
  • Asset or instrument.

For you as a trader, the key takeaways are:

• Holdings are always as of the latest known snapshot.
• Strategy‑level views and portfolio views are two perspectives on the same underlying data.
• When something changes in holdings, it reflects:
  • Executed trades.
  • Market movements.
  • Funding, fees, or other venue‑level adjustments.