Documentation
v1.0StellarMonitor is a real-time on-chain intelligence platform for the Stellar Network. It monitors whale transfers, large SDEX trades, Soroban smart contract events, and anomalous token distribution patterns — delivering instant alerts via Twitter, Telegram, and this web dashboard.
All data is sourced directly from public blockchain infrastructure. StellarMonitor does not store private keys, personal data, or any information that could identify individual users.
Open Source. Published under the MIT License at github.com/withercryptodev-star/stellarmonitor
Roadmap
The milestones we are working toward. Items are ordered by priority, not fixed dates — we ship when the work is ready. Full version with deliverables and rationale lives on GitHub.
Curated News section now live at /news, replacing the Soroban page. Manual publishing via admin panel works today. AI-summarized publishing, weekly newsletter "Stellar Pulse" and quarterly research reports are in development.
Natural language queries over on-chain data, AI-generated wallet summaries, automated anomaly detection with narrative context. A chat layer that makes Stellar activity accessible via site and Telegram.
Deep-dive pages for individual Stellar assets — holders, distribution, liquidity across SDEX and Soroban AMMs, DEX pairs, historical activity, transfer and trade history.
Follow top traders, LPs and early movers on Stellar. Curated Smart Money list, live feed of their transactions, copy-trade signals, historical performance and leaderboards by category.
Connect a wallet — see full P&L, every DeFi position, every trade, every asset across Stellar. Real-time tracking across Blend, Aquarius, Soroswap, FxDAO, DeFindex with CSV export for tax reporting.
Public watchlists — follow any Stellar wallet, get notified on moves. Custom alert thresholds via Telegram. Community-contributed address tags. Webhook support for power users.
Structured partnerships with Stellar projects — data integrations, co-marketing campaigns, shared dashboards, embeddable widgets on partner sites, joint AMAs and featured partner slots on the Ecosystem page.
Independent third-party audit of backend, API, data pipelines and user-facing surfaces. Penetration testing, dependency review, public security disclosure policy, bug bounty program and published audit report.
If the product grows into what we think it can, the site will eventually need a full visual refresh. Not a priority on its own — happens only when scope genuinely outgrows the current design. Not happening soon, but on the horizon.
Have an idea? Open an issue on GitHub or reply to our pinned tweet. The roadmap is not fixed — we ship what moves the project forward fastest.
Architecture
StellarMonitor consists of three independently running components:
| Component | Description | Technology |
|---|---|---|
| Bot | Core monitoring engine. Subscribes to Horizon SSE, detects patterns, publishes alerts | Python 3.11, Tweepy, python-telegram-bot |
| API | REST API serving alert history and statistics to the website | FastAPI, SQLite, Uvicorn |
| Site | Public dashboard. Reads from Horizon API directly and from the StellarMonitor API | HTML/CSS/JS, GitHub Pages |
Data Flow
Stellar Network
│
▼
Horizon SSE Stream (/payments)
│
▼
StellarMonitor Bot
├── Whale detector
├── SDEX detector
├── Soroban monitor
└── Meme pump detector
│
├──▶ Twitter / X (@StellarMonitor)
├──▶ Telegram (@stellarmonitor)
└──▶ SQLite DB ──▶ FastAPI ──▶ stellarmonitor.xyzData Sources
StellarMonitor uses exclusively public blockchain data. No proprietary or private data sources are used.
| Source | Usage | Docs |
|---|---|---|
| Stellar Horizon API | Primary data source. SSE stream for real-time operations, REST for historical queries | developers.stellar.org |
| Soroban RPC | Smart contract events from Soroban protocols (Aquarius, Soroswap, Blend) | developers.stellar.org/rpc |
| stellar.expert API | Token metadata and asset information | stellar.expert |
| CoinGecko API | XLM price in USD (free tier, no API key required) | coingecko.com/api |
| Twitter API v2 | Publishing alerts to @StellarMonitor | developer.twitter.com |
| Telegram Bot API | Publishing alerts to @stellarmonitor | core.telegram.org |
Whale Alerts
The whale detector monitors all payment operations on Stellar in real time via Horizon SSE. An alert fires when a single transfer exceeds configurable USD thresholds.
Alert Intensity Scale
| Emoji | Label | Threshold |
|---|---|---|
| 🔵 | Alert | Below $250K |
| 🟡🟡 | Notable | $250K – $1M |
| 🟠🟠🟠 | Big Move | $1M – $10M |
| 🔴×4 | Whale | $10M – $50M |
| 🚨×5 | Historic | $50M+ |
Mass Distribution Detection
When one sender transfers identical amounts to multiple wallets in a short time window, StellarMonitor groups these into a single Mass Distribution alert. This pattern typically indicates payroll, airdrop, or institutional liquidity provisioning.
SDEX Monitor
Stellar's built-in DEX is monitored by tracking manage_sell_offer, manage_buy_offer, and path_payment operations. Multi-operation transactions are grouped into a single alert showing all pairs and total volume.
Volume Spike Detection
The system tracks a rolling 60-minute average for each SDEX pair. When volume in a 10-minute window exceeds 3× the average, a Volume Spike alert is published.
News
StellarMonitor provides real-time monitoring of Soroban smart contract events on Stellar mainnet. It connects to a Soroban RPC endpoint and polls for events from known DeFi protocols.
Tracked Protocols
| Protocol | Events Tracked |
|---|---|
| Aquarius AMM | Liquidity Deposit, Withdraw, Swap, New Pool |
| Soroswap | Swap, Add Liquidity, Remove Liquidity |
| Blend Protocol | Supply, Borrow, Repay, Liquidation |
Note: Soroban RPC does not always return USD amounts for liquidity events. In such cases the event is either skipped or published with the contract name only.
Transaction Scanner
The Scanner tool explores the full transaction history of any Stellar wallet address. It queries Horizon API with multi-page pagination to load data across arbitrary time periods.
Filter Options
| Filter | Description |
|---|---|
| Type | All / Transfers / SDEX / Path Payment |
| Min Value | Minimum USD threshold from Any to $1M+ |
| Asset | Filter by XLM, USDC, USDT, or custom token code/issuer |
| Sort | Newest / Oldest / Largest — up to 10,000 pages loaded |
| Period | 1h, 24h, 3d, 7d, 2w, 30d, 1y, All time |
| Exchange Flows | Show transactions with known exchanges (TOML-verified + 30+ addresses) |
| Circular | Detect A→B→A round-trip patterns |
| Round Numbers | Filter for institutionally round amounts |
| Repeated Amounts | Highlight recurring transfer amounts |
Wallet Graph
The Graph tool visualizes transaction connections as an interactive force-directed node graph. Node size = transaction volume; color = direction of fund flow.
Color Legend
| Color | Meaning |
|---|---|
| Cyan | Root wallet (the address you searched) |
| Green | Wallets that received funds from root |
| Orange | Wallets that sent funds to root |
| Purple | Wallets with bidirectional transfers |
| Gray | Known exchanges (Binance, Coinbase, etc.) |
Single-click any node to load that wallet's graph. Double-click to open in Scanner. Use depth 1/2/3 to control exploration hops.
Node Type Filters
Use the checkboxes in the legend to show/hide: Root wallet, Sent to, Received from, Both directions, Exchange nodes.
View Balance History
Click "View Balance History" in the info panel for a cumulative net flow area chart. Select period: 1D, 1W, 1M, 1Y, All.
Liquidity Pools
The Pools page shows active Stellar AMM pools ranked by USD volume via Stellar Expert API. Only pools with TVL ≥ $500 are shown.
| Column | Description |
|---|---|
| TVL | Total Value Locked in USD |
| 24H Volume | USD trading volume last 24h |
| APR | Estimated annual return: 24h fees × 365 / TVL |
| Earned 24h | Actual fee revenue earned by LPs in last 24h (USD) |
API Reference
Base URL: https://api.stellarmonitor.xyz — All endpoints return JSON. No authentication required. CORS enabled for all origins.
GET/api/alerts
Returns the most recent whale and SDEX alerts detected by the bot.
GET /api/alerts?limit=50&min_usd=100000
{
"alerts": [
{
"id": 142,
"type": "WHALE_USDC",
"usd_value": 2500000,
"asset": "USDC",
"amount": 2500000,
"from_full": "GAVA7FY3...",
"link": "https://stellar.expert/explorer/public/tx/...",
"created_at": "2026-03-21T10:30:00Z"
}
],
"count": 1
}| Parameter | Type | Default | Description |
|---|---|---|---|
| limit | integer | 50 | Number of results (max 200) |
| type | string | — | Filter: WHALE_USDC, WHALE_XLM, SDEX, AIRDROP_SUMMARY |
| min_usd | float | 0 | Minimum USD value |
GET/api/stats
Returns aggregated statistics for the last 24 hours.
GET /api/stats
{
"period": "24h",
"total_alerts": 47,
"whale_count": 12,
"sdex_count": 31,
"biggest_usd": 610000000,
"usdc_volume": 48500000
}GET/api/whale
Returns only whale-type alerts above a specified threshold.
GET /api/whale?min_usd=500000&limit=20GET/api/pairs
Returns top SDEX trading pairs by volume in the last 24 hours.
GET /api/pairs?limit=5
{
"pairs": [
{ "pair": "USDC/AQUA", "cnt": 14, "vol": 6020000 },
{ "pair": "USDC/CETES", "cnt": 8, "vol": 3470000 }
]
}Brand Kit
Everything you need to represent StellarMonitor in content, partner materials, press coverage, or contributor work.
Full brand kit on GitHub: github.com/withercryptodev-star/stellarmonitor/tree/main/brand
Includes logos (SVG + PNG), Twitter and square banners, editable templates, and brand guidelines.
Quick access
| Asset | Size | Link |
|---|---|---|
| Logo mark (SVG) | Scalable | Download |
| Logo mark (PNG) | 1024×1024 | Download |
| Wordmark | 800×200 | Download |
| Twitter post banner | 1200×628 | Download |
| Twitter header | 1500×500 | Download |
| Square post | 1080×1080 | Download |
| Announcement template | 1200×628 | Download |
Colors
| Role | Hex |
|---|---|
| Background | #050a12 |
| Cyan accent | #00c8ff |
| Verified green | #00e87a |
| Purple | #a78bfa |
| Amber | #fbbf24 |
| Red | #ff3d5a |
| Primary text | #f0f4fa |
| Secondary text | #8da0b8 |
Typography
- Outfit — headlines and UI, weights 400/600/700/800
- DM Mono — labels, metrics, code, weights 400/500
Both free from Google Fonts.
Logo usage
- Always cyan on dark background — no inversions
- Minimum clear space equals the diameter of the inner dot
- Do not recolor, rotate, stretch, or add effects
Voice
Direct. Factual. No hype. Numbers over adjectives. Short sentences over long ones.
Taglines
- Primary: On-chain. Real-time.
- Secondary: Stellar network intelligence
Mentions and hashtags
Handle: @StellarMonitor
Partners: @StellarOrg, @BuildOnStellar
Hashtags: #Stellar, #XLM, #Soroban, #StellarEcosystem, #BuildOnStellar
Disclaimer
StellarMonitor is an informational tool only. It displays publicly available on-chain data for educational and analytical purposes.
- StellarMonitor does not provide financial, investment, trading, or legal advice.
- Nothing on this platform constitutes a recommendation to buy, sell, or hold any digital asset.
- All data is sourced from public APIs and provided "as is" without warranty of accuracy.
- Past transaction patterns do not indicate future activity or price movements.
- StellarMonitor is not affiliated with the Stellar Development Foundation, Circle, or any exchange.
- Use this tool at your own risk. The operators accept no liability for decisions made based on information displayed here.
Privacy Policy
Last updated: March 21, 2026
StellarMonitor does not collect, store, or process any personally identifiable information (PII).
- We do not use cookies or tracking pixels.
- We do not require registration or login.
- We do not store IP addresses or browser fingerprints.
- Wallet addresses entered in the Scanner are not logged or stored.
All data displayed is sourced from the public Stellar blockchain. Blockchain data is inherently public. StellarMonitor does not make any previously private data public.
This site uses Google Fonts from fonts.googleapis.com. See Google's Privacy Policy for details. No other third-party analytics are used.
Terms of Service
Last updated: March 21, 2026
By accessing stellarmonitor.xyz you agree to the following terms:
You may use the site for personal, educational, and non-commercial research purposes. You may access the public API for non-commercial projects with attribution. You may not use automated scraping that degrades service for others. You may not use data from this site to harass or harm any individual.
The site is provided on a best-effort basis. We do not guarantee 100% uptime or real-time accuracy. We reserve the right to modify these terms at any time.
Open Source Licenses
StellarMonitor is released under the MIT License. Copyright © 2026 StellarMonitor Contributors.
Dependencies
| Package | License | Usage |
|---|---|---|
| requests | Apache 2.0 | HTTP client for Horizon API |
| httpx | BSD 3-Clause | Async HTTP for Soroban RPC |
| tweepy | MIT | Twitter API v2 client |
| python-telegram-bot | LGPL 3.0 | Telegram Bot API client |
| stellar-sdk | Apache 2.0 | Stellar network utilities |
| fastapi | MIT | REST API framework |
| uvicorn | BSD 3-Clause | ASGI server |
| DM Mono | SIL OFL 1.1 | Monospace font |
| Outfit | SIL OFL 1.1 | Display font |