Stocks
The Stocks widget tracks a single ticker, a watchlist of multiple tickers, or a hero-style big number — pick your visual at add-time. Drop it on a Mizu page or paste the embed URL into Notion or Obsidian. v1 ships with mock prices for design preview; live API integration arrives with the founder cockpit sprint.
Stocks is the markets primitive — a small widget you point at one or many tickers to surface the latest price + delta in your dashboard. Three layouts ship: a Card with the price, percent change, and ticker tag; a Watchlist that lists multiple tickers with arrows + price + delta per row; and a Big Number layout for hero placement (single ticker, giant centered price colored green or red by direction). v1 uses a built-in mock price catalog so the widget renders cleanly out of the box; live data sources (Alpha Vantage, IEX Cloud, Polygon free tiers) wire in alongside the curated News widget when the Sora persona launches.
How to add a Stocks widget to your page
- Drop Stocks on your canvas
In the Studio left rail, click Stocks under the Developer category. The LayoutPicker popup opens with three thumbnails: Card, Watchlist, Big number.
- Pick a layout
Card for a single ticker with the full set of price + delta + ticker info. Watchlist for tracking 3-5 tickers in a stacked list. Big number for a hero display where the single price IS the visual.
- Set your ticker(s)
In the inspector panel, type a ticker symbol like AAPL or META for Card and Big layouts. For Watchlist, type a comma-separated list like AAPL,GOOGL,META,AMZN.
- Theme it
Use the standard Studio color and font controls to match your page palette. Up/down arrows always paint green/red regardless of theme so the price direction reads at a glance.
- Embed elsewhere
Click Copy embed URL when you're happy. Paste it into Notion (/embed), Obsidian, or any other iframe-friendly host. The widget renders identically across all surfaces.
Questions, answered.
What ticker symbols are supported?
v1 ships with mock data for AAPL, META, GOOGL, AMZN, MSFT, NVDA, TSLA, SBUX. Any other ticker renders with a zero price placeholder. The full universe of US-listed equities ships with the live API integration in the Sora sprint.
How do I switch between Card, Watchlist, and Big number layouts?
Click the Stocks widget in the Studio left rail and the LayoutPicker popup opens — pick the visual you want and it drops on canvas configured. Or pass ?layout=card | watchlist | big in the embed URL.
Can I track multiple stocks in one widget?
Yes, with the Watchlist layout. Pass ?tickers=AAPL,GOOGL,META as a comma-separated list and the widget renders one row per ticker.
When does live price data ship?
It's part of the Sora founder-cockpit persona sprint. That sprint includes the Feed Agent infrastructure (server-side cron polling external APIs), which Stocks will tap for real-time-ish prices via Alpha Vantage / IEX / Polygon free tiers.
Is the data real-time?
v1 is static. Live integration aims for ~5-15 minute freshness — typical free-tier API cadence. Real-time tick data requires paid tiers (~$5/mo per ticker on most providers) and isn't planned for v1.
Can I use this for crypto?
Not yet. v1 mocks support equities only. Crypto pairs (BTC, ETH, etc.) ship as a follow-up via CoinGecko once equity integration is stable.
Will it work in Notion / Obsidian?
Yes. Type /embed in Notion or use Obsidian's Embed plugin and paste the widget URL — the layout you picked renders inline. Same widget URL works in any iframe-friendly host.