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
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.
Soroban Events
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 |
| Sort | Newest first or Largest first |
| Period | 1h, 24h, 3d, 7d, 2w, 30d, 1y, All time |
| Exchange Flows | Only show transactions involving known exchanges |
| 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.) |
Double-click any node to re-center the graph on that wallet. Use depth selector 1/2/3 to control exploration hops.
API Reference
Status: The REST API will be available at https://api.stellarmonitor.xyz after VPS deployment. The site currently reads directly from Horizon.
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 }
]
}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 |
| Three.js r128 | MIT | 3D globe visualization |
| DM Mono | SIL OFL 1.1 | Monospace font |
| Outfit | SIL OFL 1.1 | Display font |