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.
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. See the full page — every item, its source and its cutoff.
- Every number points back. A claim carries its source record and the cutoff it was read at, so you can go and check it instead of taking the paragraph on faith.
- A gap is reported as a gap. What could not be collected is named and grouped, never filled with a neutral value that reads like data.
- The data lands before the analysis. Sources are collected into a local store, frozen into a snapshot, and only that snapshot is analysed — so a conclusion has a record behind it, and the numbers stay on your machine.
macOS · Apple Silicon (.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
and confirm Open in the dialog. Double-clicking is blocked by Gatekeeper. If macOS still
refuses, run
xattr -dr com.apple.quarantine /Applications/MacroBay.appin Terminal and open it again. - Windows — run the installer. When SmartScreen says Windows protected your PC, click More info → Run anyway.
Every update you download repeats those same two steps, until a signed build ships.
No API key yet? Open the app and choose Sample mode → Open sample dashboard. It replays one recorded real week — dashboard, funding, stablecoins, ETF flows, two calendar months and three published analyses — labelled Sample data, and writes nothing into your database. Live panels still need your own model provider and data-source credentials.
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.
- Trading for a living → — one screen instead of five, and a conclusion that survives "how do you know?".
- Still learning the market → — the same screen, except it explains the plumbing while you read it.
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 mid-session. There is no closing bell that consolidates the story, so the timestamp and the source are the analysis.
- The signal is scattered. Exchange announcements and API changes, status incidents, stablecoin supply, ETF flows, funding, sentiment, macro releases — no single feed tells you what changed.
- Revisions are quiet. A number you read yesterday may be restated today. A tool that overwrites the old reading removes the only way to learn from being wrong.
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.
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 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 today's print instead of a single number.
- Capital and flows. Stablecoin supply and ETF net flows — the liquidity that has to be somewhere.
- Risk appetite. The Fear & Greed index read as evidence, with its observation time and bucket, not as a verdict.
- 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 separate records — FOMC, CPI, PCE and payrolls with their official release values.
- Venue and chain events. Binance and OKX announcements and API changes, plus Coinbase, Kraken and Solana status.
- An analyst with a visible trace. It reads the same evidence, separates facts from assumptions, asks a structured question when a choice changes the answer, and shows the tools it ran.
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.
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.
- 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 distribution, no order flow. It does not replace the chart you already read — it tells you what happened behind it.
- 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 up for and nothing to cancel.
- Not a data bundle. No bundled feeds and no bundled credentials — you enable the sources you have access to.
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.
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 devFull walkthrough: Quick start.
- Settings → Model Service: add a provider and API key, enable it, and choose the default model for agents.
- Settings → Intelligence Sources: enable the sources you have access to and add any required credentials.
- Open Intelligence in the sidebar: it lands on the crypto dashboard. The agent portal is not the first screen; reach it with Back to Agents on the dashboard.
- Ask the analyst: What changed in the last macro release, and which assets does it affect?
The answer should show what is known, what is missing, where the evidence came from, and the time boundary it used.
MacroBay is alpha (0.4.0). macOS is the verified platform. A sample mode ships with the app:
with no key and no network you can open the full dashboard and one published analysis, replayed from a
real recorded week. Live panels still need your own provider credentials. 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.
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.
| 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
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.
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.
Electron 41 · React 19 · TypeScript 5.8 · pnpm 10. Local AI development notes may live in
AGENTS.md; that file is not part of the public repository.
MIT © 2026 MacroBay contributors