nicxx2/jupiter-usdc-price-alerts repository overview

⁠Per-rule trends

Rule Trends reuse saved Action Readiness checks. Gaps remain visible instead of being plotted as zero.

⁠Risk thresholds

⁠Rule builder

⁠Settings and rate management

⁠Confirmation protection

⁠Mobile layout

⁠Wallet tracking

• Added cached Token Safety reports using one SolanaTracker token-information request per check, enabled by default when SolanaTracker is available, with persistent global and per-token controls, manual or scheduled refreshes, retained trusted results after failures, and no safety notifications.
• Improved Token Overview with full aligned Buy and Sell prices, a responsive mobile layout, and compact safety shields that open a detailed report without changing the active token.
• Improved SolanaTracker RSI reliability with standard Wilder calculations over genuine traded candles, stable no-trade values, safer source validation, and correct persistence across restarts, token switches, and interval changes.
• Added safer confirmation for unusually large Jupiter price moves before updating charts, shared quote caches, or firing alerts.
• Improved multi-token monitoring with live Token Overview updates, a clear active-token marker, accurate overdue scheduling, independent background alerts, safer notification retries, and cleaner fired-alert timing details.
• Improved Action Readiness trends across 24h, 7d, 30d, and 90d so representative real readings remain visible while genuine provider gaps and rule or scenario changes stay clearly separated.

⁠📈 Per-rule Action Readiness trends

• Open the dedicated graph button on any enabled rule card to switch safely between its live value and its history.
• Choose 24h, 7d, 30d, or 90d views on desktop or mobile; each coin and rule remembers its own view and range in that browser.
• Actual readings are plotted against the rule target, including stepped target changes and separate price-impact scenario segments.

⁠🛡️ Truthful gaps and provider timing

• Rule Trends reuse completed Action Readiness evaluations and make no additional Jupiter requests.
• Only fresh, finite readings are saved. Unknown, stale, malformed, disabled, and interrupted periods appear as gaps and are never converted to zero.
• Jupiter token metrics are deduplicated by the provider's source timestamp, while live price-impact quotes use their own quote timestamp.

⁠💾 Bounded, isolated history

• Trend history is stored in /shared/action-rules-history.sqlite3, separately from current readiness, configuration, alerts, and price history.
• Recent readings stay detailed, older readings are progressively downsampled, and retention is bounded to 90 days by default.
• History endpoints return a mobile-safe bounded number of points, and deleting a tracked coin also deletes its rule history.
• A history storage problem cannot stop current Action Readiness checks or alerts.

⁠📱 Focused responsive cards

• A dedicated 36px graph control prevents accidental card activation and keeps the current Pass / Not passed / Unknown status visible.
• Charts use compact labels and tap-friendly tooltips, disable animation for motion safety, and explain gaps and the latest valid reading.

⁠✨ What's New in v3.2

⁠✅ Action Rules and Action Readiness

• Create independent per-coin conditions for holder count, market cap, liquidity, 24-hour volume, sell pressure, volume/liquidity ratio, and maximum Jupiter sell-quote price impact.
• See each rule's current value, target, and Pass / Not passed / Unknown result in a responsive Action Readiness card.
• Enable or disable Action Rules globally or per coin while preserving every coin's saved configuration.
• Jupiter-reported holder counts are clearly identified as provider data and may differ slightly from other indexers.

⁠🔔 Confirmed Action Rules alerts

• Optionally send an ntfy alert when every enabled rule has passed two fresh checks.
• Choose a send once alert or re-arm after two confirmed failures followed by two new passes.
• Stale, missing, malformed, or zero-denominator data stays Unknown and cannot trigger an alert.
• Per-coin ntfy topics override the global topic, and delivery failures retry on later checks without repeating a successfully completed one-time alert.

⁠🔌 Safe Jupiter integration

• The optional JUPITER_API_KEY is used only by Action Rules for Tokens V2 data and authenticated sell quotes.
• Without that key, Action Rules remain unavailable while the existing keyless Jupiter price monitor and price alerts continue unchanged.
• Action Rules use a separate conservative limiter, batch metadata for up to 100 mints, and retry only transient failures such as timeouts, 429, and server errors.
• Permanent 4xx errors stop only the current retry burst; the next scheduled refresh still tries again normally.
• Signed Swap V2 price impact is normalized into adverse percentage points so a negative signed value cannot incorrectly pass a maximum-impact rule.

⁠📱 UI and long-running reliability

• Action Readiness starts as a compact, expandable status bar, remembers each coin's browser expand/collapse preference, and stays responsive on desktop and mobile.
• When JUPITER_API_KEY is blank or Action Rules are globally disabled, Action Readiness and Rules indicators stay hidden from the main dashboard; Settings clearly explains the inactive state. A global visibility change only takes effect after Settings is saved.
• Settings displays the effective Action Rules refresh interval and isolated limiter from Docker/ENV configuration.
• Global/per-coin transitions, restarts, stale gaps, unrelated token edits, and alert state persistence are handled without false-ready alerts.
• Re-enabling RSI now shows a waiting state immediately instead of briefly reporting that RSI is still disabled.

⁠🧾 What's New in v3.1.1

⁠🪙 Multi-token monitoring

• Track multiple output tokens from the web UI while keeping Docker Compose as the simple default setup.
• Validate new token mints with Jupiter before saving them.
• Switch the active token without losing each token's saved chart, alert, RSI, and wallet context.

⁠⚙️ Token-isolated settings

• Each token can have its own simulated USD amount, buy/sell alerts, alert reset minutes, RSI alerts, RSI interval, RSI reset mode, decimals, price check interval, RSI check interval, and optional ntfy topic.
• Per-token ntfy test notifications make it easy to confirm the right topic before alerts fire.
• Chart window, wallet selection, and sell simulator preferences are remembered per token in the browser.

⁠🔌 API and wallet reliability

• Jupiter price checks now use keyless Swap V2 quote-only requests with a dedicated 0.5 req/sec default limiter.
• Wallet info now uses SolanaTracker PnL V2 batch positions with a fallback to basic wallet holdings for migrated or not-yet-indexed tokens.
• Sell simulator keeps proceeds visible for holding-only data, but avoids showing a misleading principal/profit split until PnL is indexed.
• Long SolanaTracker RSI and wallet status errors wrap cleanly within mobile and desktop cards without changing the original error text.

⁠🛡️ Safer rate and state management

• SolanaTracker calls use a shared safe limiter by default for free accounts, with custom/off modes for higher plans.
• Scheduler checks tokens in a conservative round-robin flow so multiple tokens queue cleanly instead of spiking API calls.
• SolanaTracker can be disabled globally from Settings, hiding RSI, wallet info, and sell simulator while Jupiter price alerts keep running.
• RSI can also be disabled per token when you only want SolanaTracker checks on selected tokens.
• Missing or failed RSI data displays as -- with status context instead of a fake 0.00.
• Price history and quote caches are scoped per token and cleared when calculation settings change.

⁠v2.4

⁠🌙 Dark Mode Support

• Persistent theme toggle — Sun/moon button in top-right corner
• System preference detection — Automatically detects your OS dark/light preference on first visit
• Per-device memory — Each browser/device remembers your theme choice
• Dark-aware charts — Chart.js axes, grid, and tooltips adapt to dark mode
• Improved dropdowns — All select elements now have proper dark mode styling
• Smooth transitions — Clean theme switching without page reload

⁠v2.3.1

⁠🔗 Jupiter API Update

• Migrated from the deprecated quote-api.jup.ag/v6 to the new lite-api.jup.ag/swap/v1.
• Added retry and backoff logic for more resilient price checks.
• Added restrictIntermediateTokens=true to reduce rare dust-pool price spikes.

⁠v2.3

⁠🧮 Sell % Simulator (Wallets)

Quickly model a partial exit from your position and see an estimated breakdown of proceeds:

• Adjust 0–100% via slider, numeric input, or quick chips
• Shows:
  • Estimated current token price
  • Tokens to sell
  • Expected proceeds
  • Split into principal vs unrealized profit/loss
• Works with the selected wallet or All (aggregate)
• Hidden when no wallets are configured or when the selected source has no holdings
• Uses the latest values from the Wallet Info card (PnL):
  price ≈ current_value / holding, with proceeds split using the current cost basis and unrealized PnL
• Note: This is an estimate; execution may vary due to price impact and slippage

⁠v2.2.2

⁠📱 Mobile Layout Tweaks

• Improved layout so the UI now looks better on phones and smaller screens.

⁠💼 Wallet Information Panel

• You can now add wallets to view real-time holdings and cost basis.
• A new “All” option shows the combined totals across all wallets.
• Requires: SOLANATRACKER_API_KEY; wallets can be set with WALLET_ADDRESSES or added from the Web UI.

⁠v2.1

⁠🔍 RSI Indicators (Optional)

By providing a SOLANATRACKER_API_KEY, you enable a new RSI panel in the UI that lets you:

• RSI is calculated on the token’s USD (USDC) price, not on the token/SOL pair
• View live RSI values across multiple intervals: 1s, 1m, 5m, 15m, 1h, 4h
• Set RSI alert thresholds, e.g. "below:30", "above:70"
• Optionally auto-reset alerts when RSI crosses back (toggle with RSI_RESET_ENABLED)

⁠🛡️ Resilience to API Hiccups

• Handles rate limits (429) and timeouts gracefully
• If RSI data is unavailable, the UI displays "––" instead of crashing
• RSI alerts automatically resume on the next scheduled check

⁠🖥️ RSI Alert Status Badges

• New badges show live RSI alert state:
  • 🟢 Active
  • 🟡 Waiting to Reactivate
  • 🔴 Inactive