Nodebase requires a world graph database to function. On self-hosted deployments, run python seed_db.py from the project root to bootstrap the graph with ~140 country nodes, trade flows, causal edges, and seed events. The platform launches via streamlit run dashboard/app.py. Cloud-hosted plans handle this automatically.
The Globe renders the Digital Financial Earth as an interactive 3D sphere. Country nodes are sized by GDP. Active events are pinned to affected countries and surfaced in the right-side panel. Click any country to open its full data profile: GDP, growth rate, inflation, unemployment, currency, trade composition, and all live events affecting it. Drag to rotate the globe, scroll to zoom.
The live news ticker at the bottom pulls real-time financial headlines from BBC Business, Reuters, CNBC, MarketWatch, Al Jazeera, and The Guardian — refreshed every 30 minutes.
The Nodes view renders the causal knowledge graph as a force-directed network. Each circle is a country node. Edges between nodes represent causal mechanisms — trade dependencies, supply chains, capital flow corridors, and policy transmission links.
Click any node to run an ESE cascade (Economic Shock Expansion): the system performs a breadth-first traversal up to 3 hops from the selected country and animates the propagation path. Source node renders at full opacity; each hop ring progressively fades, showing the diminishing directness of impact at distance. Use the search bar to jump straight to a country and trigger the cascade.
The Intelligence interface accepts natural-language queries about market events, countries, commodities, or geopolitical scenarios. Ask a question — the system reasons through the causal graph and returns the expected propagation chain: which nodes are affected, in what sequence, and through which mechanisms.
Intelligence is currently in preview. Responses are simulated pending integration of the local LLM reasoning layer (Engine C).
The Database view is a read-only browser for the live world state. Browse and filter across five tables: Countries (140 economies with macro indicators), Trade (import/export composition by category), Edges (causal mechanism links with strength and lag data), Events (active and historical events with severity and affected nations), and Nodes (chokepoints, commodities, institutional actors).
Signals emerge when a node's real-world state diverges from its market-priced state. OSINT ingesters (satellite feeds, news, ship tracking, macro releases) update node states continuously. The propagation engine traces causal edges forward from any changed node. Where expected state diverges beyond threshold from market price, a signal candidate enters the filter pipeline — confidence scoring, ethics gate, liquidity check — before surfacing to the dashboard.
| Source | Coverage | Latency | Feeds Into |
|---|---|---|---|
| GDELT Project | Global news — 100+ languages, 6-hour rolling dedup | 15 min | Geopolitical & conflict node states |
| NASA FIRMS | Satellite fire & thermal anomaly detection, FRP delta filter | Near real-time | Infrastructure node states (refineries, ports, pipelines) |
| AIS / MarineTraffic | Global cargo ship positions, port calls, route deviations | Near real-time | Chokepoint & trade flow nodes |
| OpenSky Network | Commercial & cargo flight tracking, airspace closures | Near real-time | Cargo & logistics nodes |
| Source | Coverage | Latency | Feeds Into |
|---|---|---|---|
| FRED | US & global macro — CPI, Fed rate, PMI, M2, credit spreads | On release | Macro economic node states |
| IMF Data API | GDP, growth projections, recession classification, debt levels | Quarterly | Country macro nodes |
| Polygon.io | US equities, ETFs — 15-min delayed on free tier, real-time on paid | 15 min / RT | Equity nodes, divergence detection |
| Binance API | BTC, ETH, major crypto pairs — no API key required | Real-time | Crypto nodes |
| Source | Coverage | Latency | Feeds Into |
|---|---|---|---|
| SEC EDGAR 13F | Quarterly institutional holdings — top 1,000 funds | 45-day lag | Institutional holding & crowding nodes |
| CFTC COT | Weekly futures positioning — speculators vs commercials | Weekly | Futures positioning nodes |
| SEC Form 4 | Insider transactions — filed within 2 business days | 2-day lag | Insider conviction nodes |
| Unusual Whales Paid | Options flow & GEX — institutional conviction signals | Real-time | Market maker positioning, entry timing |
| Source | Coverage | Refresh | Used For |
|---|---|---|---|
| SC Malaysia SAC | Official Shariah-compliant securities list for Bursa Malaysia | Bi-annual | Halal screening gate — Bursa equities |
| MSCI Islamic Index | Shariah screening for US & international equities | Quarterly | Halal screening gate — international equities |
| BDS / Who Profits | Boycott-listed companies, occupation financing, settlement contractors | Bi-annual | BDS compliance gate |
| Endpoint | Description | Status |
|---|---|---|
| GET /graph/nodes | All active nodes with current state, GDP, status, and coordinates | Roadmap |
| GET /graph/nodes/:id | Single node with full state history and connected edge list | Roadmap |
| GET /graph/edges | All causal edges — mechanism type, strength, lag, conditions | Roadmap |
| GET /graph/propagate/:id | Run ESE cascade from a node — returns hop chain up to depth 3 | Roadmap |
| GET /signals | Recent signal candidates with confidence, basket, and chain | Roadmap |
| GET /events | Active and historical events with severity and affected nations | Roadmap |
| POST /intelligence/query | Submit a natural-language query to the Intelligence engine | Roadmap |
The Nodebase API will use bearer token authentication. API keys will be provisioned per organisation through the enterprise dashboard. Rate limits and data freshness tier depend on your subscription plan.
We're a cross-disciplinary team of engineers, macro researchers, and data infrastructure specialists. We believe the next generation of market intelligence tools will be built on causal reasoning — not larger training datasets.
We're running a closed pilot with a small number of institutional partners. If you're a fund, family office, or research organisation interested in evaluating Nodebase for your workflow, reach out to discuss early access terms.
If you represent a data provider, exchange, or financial infrastructure company and want to explore a data partnership or integration, we're actively building out the ingester layer and would welcome the conversation.
For media enquiries, research collaborations, or speaking opportunities, use the same contact address below.