Agentic ETF flow analyst for the one-person on-chain finance operator

Per-asset breakdown

Source

Data pulled from etfs/summary-history on the SoSoValue Public API. Brief regenerated server-side every 6 hours. Static mode uses a deterministic synthesis engine. Groq mode (when enabled) routes the same stats through Llama 3.3 70B for richer phrasing.

Inputs

• Daily net inflow for each tracked spot ETF (BTC, ETH, SOL, XRP) from SoSoValue
• 60 most recent rows per asset, both US and HK markets

Per-asset signal

• Sum the last 7 days of net inflow into sum7
• Sum the prior 7 days into prev7
• Bullish if sum7 > 0 and sum7 > prev7 * 1.1
• Bearish if sum7 < 0 and sum7 < prev7
• Fading-bull if positive but below prior 7d
• Fading-bear if negative but easing
• Otherwise neutral

Daily Brief

Cross-asset summary computed by aggregating the per-asset directions. The strongest absolute 7d flow becomes the standout. Cumulative inflow narrative anchors the longer-term context. Risk callout flags a single high-outflow day on a leading asset, the most common cohort-drag pattern.

Why deterministic, not just an LLM

Signals are computed first. The brief is a report on those signals, not the source of them. That keeps the engine auditable, free of hallucinated numbers, and reproducible across runs. Groq mode rephrases, never invents.

Endpoints used

• GET /etfs/summary-history with symbol, country_code, limit=60
• GET /indices for SSI ticker enumeration

Rate limits respected

Demo plan is 10 calls per month. The proxy caches every 2xx response on disk for 7 days. On rate limit, upstream failure, or missing key, the proxy serves stale-cached data with explicit headers (X-Cache: STALE-429, STALE-UPSTREAM-FAIL). Higher Buildathon limits applied for via the official access form.

SSI Protocol on Base

• MAG7.ssi token: 0x9E6A46f294bB67c20F1D1E7AfB0bBEf614403B55
• DEFI.ssi token: 0x164ffdaE2fe3891714bc2968f1875ca4fA1079D0
• Stake at ssi.sosovalue.com/en/reward

Security

API keys live in dotfiles outside the web root override and are denied by .htaccess. Server-side only - no key ever ships to the browser.

Wave 1 - shipped

• SoSoValue API integration via whitelisted PHP proxy
• Per-asset signal engine across BTC, ETH, SOL, XRP
• Daily Brief endpoint with static and Groq modes
• Branded landing, methodology surface

Wave 2 - May 18 to May 29

• SoDEX testnet API integration
• One-click trade flow from each Signal-to-Action card
• SSI rebalance correlation overlay (does today's BTC inflow align with MAG7.ssi rebalance?)
• Confirmation modal before any trade-intent action

Wave 3 - Jun 4 to Jun 15

• Risk control layer (max position, slippage, allowlist)
• Deployable Telegram bot version using the same agent core
• Broader ticker coverage (LTC, HBAR, DOGE, LINK, AVAX, DOT)
• Final demo polish and submission package

All preferences persist locally in your browser. Nothing leaves the device.

Inputs

• Total capital you want to deploy across the cohort
• Composite signal score per asset (0-100) from the signal engine
• Risk profile - conservative, balanced, or aggressive

Algorithm

Each asset's weight is its score raised to a risk exponent: weight = score^riskExp where riskExp is 1 for conservative, 2 for balanced, 3 for aggressive. Higher exponent concentrates more capital into the highest-scoring assets. Weights are normalized across the 4 assets.

Why this shape

Conservative spreads capital roughly proportional to score. Aggressive heavily favors the top scorer. Balanced sits in between. Assets with score 0 or no data get nothing.

Caveats

This is a directional sizer based on flow data, not a complete risk model. It does not account for volatility, position correlation, or time-of-entry. Treat the output as a starting point, not a trade ticket.

Highlighted side wins each row. Underlying data: 60d cached SoSoValue series.

-

Browser notifications fire when the condition crosses. The page must be open for client-side alerts to work.

2026-05-10 - Wave 1 submission build

• Hero with Buildathon framing + tag pills
• 4-asset toggles with keyboard shortcuts (1-4)
• Daily Brief endpoint ai.php with static + Groq modes, 6h cache
• Per-asset Signal-to-Action grid, click-to-detail modal
• Stat cards with animated counters + 7d sparklines
• Main chart with 14d / 30d / 60d range toggle + cumulative overlay
• 30-day flow heatmap calendar
• Compare-all view, sparkline per asset, click to focus
• Methodology, Data sources, Roadmap modals
• CSV export for the rows table
• Share button for deeplink with asset and region pre-selected
• Sticky topbar with live status pill + scroll shadow
• Toast notifications, chart hover tooltip, skeleton loaders

Earlier (2026-05-02)

• SoSoValue API proxy api.php with whitelist + 7d disk cache
• Initial BTC and ETH coverage, US and HK regions
• Geist font system, dark theme baseline

Wave 2 plan

• SoDEX testnet API integration with one-click trade flow
• SSI rebalance correlation overlay
• Confirmation modal before any trade-intent action

Insight

Recommended action

Note

Signals reflect 7d net inflow vs prior 7d. The deterministic engine is described in the Methodology modal.