THE VESTLUMA GUIDE
A little guidance.
A lot more clarity.
Get comfortable with your workspace, from your first account to your next paper order.
Using Vestluma
Vestluma analyzes household portfolios and hypothetical decisions. Live trading is disabled. Paper Lab supports simulated orders; an operator-configured Alpaca paper account can use paper orders only. It cannot move real money or guarantee outcomes.
Start with your own workspace
- Sign in with ChatGPT and create your household profile.
- In Accounts, import an authorized USD portfolio snapshot or load a clearly labeled synthetic sample.
- Review holdings, set investment boundaries, and assign a budget to your goals.
- Compare a hypothetical decision in Digital Twin. Save the receipt to keep its inputs and checks.
- Activate a passing, current receipt for shadow tracking. Refresh explicitly; continuous monitoring requires a separately configured runner.
Try Paper Lab
- Create your household, then open Paper Lab.
- Create a simulated account and explicitly enable paper submissions.
- Use symbol TEST, quantity 1, and a $100 limit to prepare a draft.
- Review the order and confirm submission. A filled order updates simulated cash and shares.
- For uncertain orders, choose Reconcile; do not submit another order.
The simulator uses a fixed $100 price and $10,000 starting cash. Orders are limited to $1,000, whole shares, long positions, and one outstanding order. These results do not model real market liquidity or execution quality. Background monitoring must be enabled per household and requires an operator-provisioned runner. Findings appear in Paper Lab; email and SMS delivery are not implemented.
About the Alpaca connection
Alpaca provides the separate account and API services used by the optional paper connection. Vestluma is independently developed and is not an Alpaca product. Alpaca paper-account connections require your authorization. Provider testing is still in progress; connecting does not submit an order or enable live trading.
Trading with an Alpaca paper account
The Trading view connects to an actual Alpaca paper account that uses simulated funds. This is separate from Paper Lab’s local TEST simulator. Paper and live connections are separate; live trading remains disabled.
During restricted acceptance, order submission requires both operator release controls and your explicit approval. Review the selected environment, instruction and limits before submitting. Fixed schedules also require separate authorization and a verified external scheduler; saving a schedule does not prove that it is running.
If an order outcome is unknown, use Reconcile on the saved order instead of creating a replacement. Stop new orders & schedules prevents new submissions but does not cancel orders already sent to Alpaca. Cancel an existing order separately and verify its final status; an order can fill before cancellation completes.
Sharing and roles
Each signed-in user has a separate household. In Households, owners create a single-use invitation for an editor or viewer. The recipient must also have permission to open this Site. Household invitations do not change Site visibility. Viewers can read and export; editors can change portfolio inputs, goals, simulations, and shadows. Owners control permissions, policies, profile, broker sync, recovery, and deletion. Members can leave a shared household.
Your data
The application stores your household profile, imported financial records, policies, goals, receipts, and sharing permissions. Data is scoped to your household and members you authorize. Do not upload credentials or accounts you are not authorized to access. Paper broker authorization uses the provider’s consent page. Credentials are encrypted on the server and are never included in client exports. Only household owners can connect accounts, manage paper orders, or schedule monitoring.
Controls lets you export records or delete household data. Resolve all outstanding Paper Lab and Trading orders before deleting your household. Deletion clears broker tokens and paper state as well as financial records and revokes household memberships and invitations. Minimal access and action audit metadata remains; a fixed retention period is not currently implemented. Downloaded copies cannot be recalled by removing access. A restore backup you retain can restore your own data within 30 days.
Recovering from a problem
If a save times out or its outcome is uncertain, reload saved state before repeating the action. A conflict means another session changed the household. Review that saved version before trying again. Sign out on shared devices.
Download a restore backup in Controls before replacing important records. Paper Lab and Trading have separate exports for active records and archived pages. Archive completed orders to free space without removing their records; drafts and unresolved orders stay active. Paper Lab and Trading records are excluded from portfolio restore backups; restoring a portfolio never resubmits or rewinds an order. Restore requires the unchanged owner-bound file, pauses Guardian, stops shadow tracking, and invalidates old receipts. This backup workflow does not replace infrastructure disaster recovery.
Understanding results
Policy review compares holdings with recorded policy limits and flags missing data. It does not choose a security or a contribution amount. Digital Twin starts with an unchanged-portfolio baseline; select your own action, destination, and amount for a different scenario. Opening Digital Twin from a finding preserves the inputs you have already entered. Shadow tracking compares a saved scenario with later snapshots without creating orders.
Imported constituent sources are unverified. Goal probabilities use your assumptions and seeded simulations. Modified Dietz depends on complete cash flows and correct opening/closing valuations. Shadow observations are hypothetical dollar comparisons, not realized returns. Tax lots, live execution, licensed research, and account eligibility are not evaluated.
Service availability
This release is undergoing production validation for an initial United States customer market. The Early Access Program (EAP) is free, with paid access planned after EAP is complete. Pricing and the transition date will be announced before EAP ends; you must choose a paid plan before being charged. For access, support, or privacy requests, contact addointernationals@gmail.com and include the request reference if shown. Never include broker secrets or full financial exports. EAP is provided without a guaranteed response time or uptime. Read the terms of use and privacy notice. International expansion is planned for a later phase; it is not available in this release.