MacroBay
Crypto market intelligence with receipts.
Quick start · What's on the desk · Why crypto · Data sources · Roadmap · Docs · License
Local-first. No bundled market data, no bundled API keys, no hosted account. Not affiliated with any venue or data provider.
MacroBay is a desktop intelligence desk for crypto. One screen holds what actually moves the market — perpetual funding and positioning, stablecoin supply and ETF flows, risk appetite, cross-asset moves, and the macro prints that reprice everything. The analyst agent reads the same evidence and explains what changed, with the source and the cutoff time attached to every number.
A claim that cannot be traced to a source record and a timestamp is supposed to be reported as a gap. That is the whole product: not a paragraph you have to take on faith.
It is not your charting tool: candles, indicators and order tickets stay in the software you already use. It does two other things — it watches for the changes that would move a call, and it uses AI to say what the change means: which reading moved, by how much, what it is tied to, and what would prove the call wrong. Then it pushes a notification to your phone, with the source and the cutoff.
841 economic indicator codes and 524 collected release events are built in — the official schedules of the U.S. Bureau of Labor Statistics, BEA, the Fed, Japan and Canada, with prior values and consensus aligned in one table. The data comes from public endpoints that are good enough on their own, so you do not also need the expensive institutional data and alert subscriptions.
The daily briefing
One page a morning, about three minutes: what the market is pricing, what changed overnight, and what to watch today. Every number carries its source and its cutoff time, so you can check it yourself — and whatever could not be collected is reported as a gap instead of being quietly filled in.
One page a morning, the whole page — every item, its source and its cutoff.
Why you can trust it
- Every number points back. A claim carries its source record and the cutoff it was read at, so
- A gap is reported as a gap. What could not be collected is named and grouped, never filled with
- The data lands before the analysis. Sources are collected into a local store, frozen into a
Download
macOS · Apple Silicon (.dmg) · macOS · Intel (.dmg) · Windows · x64 (.exe) · All releases
This build is not code-signed and not notarized, so the first launch takes two steps:
- macOS — drag the app into Applications, then right-click (Control-click) the app → Open
- Windows — run the installer. When SmartScreen says Windows protected your PC, click
Every update you download repeats those same two steps, until a signed build ships. When neither path works, the fallback is in Download and install.
The Intel build is MacroBay-x64.dmg: built, but not yet verified on Intel hardware. The Apple
Silicon download link above is unchanged, and latest-mac.yml is produced only by the arm64 job.
⭐ If this is useful to you, a star keeps it going
One person builds MacroBay, in the open.
A star is the only signal I can see that someone is actually using it — and it decides whether the
next person who needs this ever finds it.
> → Star the repo · it takes two seconds.
Built for people whose read has to survive a follow-up question — whether that is your first cycle or your fourth.
Who it is for
- Trading for a living → — one screen instead of five, and a
- Still learning the market → — the same screen, except it
Why crypto first
Crypto is the hardest place to fake a market read, which makes it the right place to build one.
- The market never closes. Funding flips at 00:00 UTC, a listing lands at 3am, CPI prints
- The signal is scattered. Exchange announcements and API changes, status incidents, stablecoin
- Revisions are quiet. A number you read yesterday may be restated today. A tool that overwrites
So the desk is built around three habits: read the whole picture on one screen, keep the observation time on every reading, and make the AI show its work.
What's on the desk
The desk is where a briefing's evidence lives. Open any claim on the page and you land here: the same reading, its window, its source and its cutoff — plus the panels the brief draws from.
The desk is the "don't miss the change" layer, not a trading terminal: it draws no intraday tape and gives no levels. Once AI has turned a change into a sentence you can read, the notification goes out through the channels you enabled — a briefing finished, an intelligence signal fired, a story above the strength threshold, or a calendar event before and after its release.
Notifications can go to Telegram, Slack, Discord, QQ and Lark; several channels can be enabled at once, each gets its own copy, and a channel that did not receive it says why.
The desk behind the page — conclusion, market status, cross-asset returns, capital conditions, sentiment and funding, with the policy path, calendar and sentiment in the right column..
- Funding and positioning. BTC and ETH perpetual funding, who pays whom, and the history behind
- Capital and flows. Stablecoin supply and ETF net flows — the liquidity that has to be
- Risk appetite. The Fear & Greed index read as evidence, with its observation time and bucket,
- Cross-asset, one scale. DXY, gold, QQQ, US10Y, BTC and ETH normalized on a single chart.
- A calendar that does not rewrite history. Scheduled, observed, and later-revised values are
- Venue and chain events. Binance and OKX announcements and API changes, plus Coinbase, Kraken
- An analyst with a visible trace. It reads the same evidence, separates facts from assumptions,
Reading it teaches you the market
Most crypto tools assume you already know why funding matters. Here the explanation sits next to the number: the key readings carry a plain-language note about what they mean, and every conclusion spells out the causal chain, the conditions that would break it, and the gaps.
That is the part a newcomer usually has to assemble from ten threads and a group chat: what moved price, through which channel, and what would prove it wrong. Read a few of those and the market stops being a black box — you are no longer memorising indicators, you are watching cause and effect with the receipts attached. One reading gives you a number; the next tells you the channel it works through — after a few, you can explain the move yourself.
It is not a course, and it is not advice. It is a desk that lays out its reasoning every time you open it.
How a complete answer looks
Every analysis separates five things, or it is incomplete:
| Element | What it means |
| --- | --- |
| Facts | Observed values, each tied to a source record |
| Assumptions | What the interpretation takes for granted |
| Conditions | What would invalidate the conclusion |
| Gaps | What the available evidence does not answer |
| Time boundary | The observation time, and the asOf cutoff the query used |
A later revision is not folded back into an earlier answer. Reading the market at 09:00 and reading it at 21:00 should produce two different, defensible answers — not one answer silently rewritten.
What it is not
- Not a signal service. No buy or sell calls, no return promises, no "alpha" for sale.
- Not a charting or entry-timing tool. No candles, no price targets, no buy/sell levels, no chip
- Not a trading bot. No order execution, no position management, no brokerage connection.
- Not a hosted account. No MacroBay server holds your data or your keys; there is nothing to sign
- Not a data bundle. What is built in is the adapter, not the data: no subscription bought on your
Data sources
Curated sources across crypto-native, market data, news and the macro layer, chosen because crypto is where free and low-cost data is actually good enough: exchange announcements and API changes (Binance, OKX), venue, chain status and release feeds (Coinbase, Kraken, Solana, GitHub releases), market data (Binance spot and futures, CoinGecko, DeFiLlama stablecoins and TVL, ETF flows, Fear & Greed), news (mainstream industry media and project official blogs, each enabled in settings as needed), and the macro layer that sets the regime (FRED, SEC, CFTC, Federal Reserve, plus the official BLS, BEA and Fed release schedules behind the calendar).
Some sources need your own account, key, or network access, and coverage varies by source. Anything you have not enabled appears as an explicit gap — never as a neutral placeholder value.
Quick start
Prefer a build? Grab a release. To run from
source you need Node.js 22+ and pnpm 10; to build the package yourself, use pnpm dist:mac
(see Packaging).
pnpm install
pnpm dev
Full walkthrough: Quick start.
- Settings → Model Service: add a provider and API key, enable it, and choose the default model
- Settings → Intelligence Sources: enable the sources you have access to and add any required
- Open Intelligence in the sidebar: it lands on the crypto dashboard.
- Ask the analyst: What changed in the last macro release, and which assets does it affect?
Status
MacroBay is alpha (0.4.4). macOS is the primary development and build platform; it was actually
installed and used during 0.4.0, and has not been re-verified by a real install since. Panels still
need your own provider credentials; anything that cannot be read is reported as a gap. The macOS .dmg
is unsigned; Windows installers build in CI and on Windows 11 x64 hardware, but the installed app is
not verified there yet, and Linux has no packaging.
See Status and limitations.
Roadmap
Crypto depth comes first: more venues and derivatives coverage, ETF and flow history, on-chain signals, and event-driven alerts. Review and replay make a decision inspectable after the fact. The runtime stays model- and agent-replaceable so the desk can deepen without becoming a monolith. See ROADMAP.md.
Documentation
| Start | Understand the product | Build on it | | --- | --- | --- | | Quick start | Product overview | Architecture | | Installation | Analysis workflow | Development setup | | First run | Traceability | Adding a product | | Model service | Analyst agent | Platform and products | | Status and limitations | — | — |
Chinese documentation: docs/README.zh-CN.md
Data and privacy
MacroBay is a client for providers you configure. The MIT license covers the code, not the data. There is no MacroBay-hosted data service, no resale, and no proxy: your data stays on your machine and credentials stay in the local secret store. You are responsible for provider terms, keys, rate limits, and any commercial use.
Feedback
Questions about setup, data sources or proxies belong in Q&A: ask there rather than in an issue. Bugs and concrete feature requests go through the issue templates.
Early feedback shapes the roadmap directly: what gets added, and what gets dropped.
Contributing
Electron 41 · React 19 · TypeScript 5.8 · pnpm 10. Local AI development notes may live inAGENTS.md; that file is not part of the public repository.
License
MIT © 2026 MacroBay contributors