MicroStrategy mNAV Tracker

A comprehensive web application for tracking MicroStrategy's mNAV (multiple Net Asset Value) with advanced scraping capabilities, multiple data sources, and real-time updates. Live at https://mnav-webhook.vercel.app

Features

Core Features

• 📊 Real-time mNAV tracking - Multiple calculation methods (Simple, EV, Adjusted, Official)
• 📺 Big display mode - Large, centered mNAV display with auto-refresh
• 🔄 Daily updates - Automatic updates at midnight UTC
• 📱 Responsive design - Works on desktop and mobile
• 🎨 Interactive tooltips - Hover over formulas to see calculations

Advanced Scraping

• 🤖 Playwright browser automation - Handles JavaScript-heavy sites
• 🌐 External scraping services - ScrapingBee and Browserless integration
• 📱 Social media monitoring - Twitter and StockTwits for mNAV mentions
• 📈 Alternative data sources - TradingView and financial APIs
• 🔄 Multiple fallback layers - Ensures data availability
• 💾 Persistent storage - Saves successful scrapes for reliability

Admin Features

• 🔐 Manual update interface - Admin can override mNAV values
• 📝 Audit trail - Tracks all manual updates with reasons
• 🔑 Token authentication - Secure admin access
• 📊 Status monitoring - Check scraping health and cache status

API Endpoints

• 🚀 RESTful API with comprehensive data
• 🔔 Webhook support for integrations
• 🏥 Health check and status endpoints
• 🌐 CORS enabled for cross-origin requests

Quick Start

Visit Live Site

https://mnav-webhook.vercel.app

Local Development

1. Clone the repository

   git clone https://github.com/localecho/mnav-webhook.git
   cd mnav-webhook

2. Set up environment

   cp .env.example .env
   # Edit .env with your API keys

3. Install dependencies

   pip install -r requirements.txt
   ./install_playwright.sh  # Install browser for scraping

4. Run the application

   python app.py

5. Test the application

   # View main page
   open http://localhost:5000
   
   # Check API
   curl http://localhost:5000/api/mnav
   
   # Check status
   curl http://localhost:5000/api/status

Docker

1. Build the image

   docker build -t mnav-api .

2. Run the container

   docker run -p 5000:8080 mnav-api

API Endpoints

1. Root Endpoint (Big Display Mode)

• URL: /
• Method: GET
• Description: Shows mNAV value in large, centered display
• Query Parameters:
  • fund_code (optional): Specify fund code (default: 'default')
• Features:
  • Large, centered NAV value display
  • Fund name shown above the value
  • Change indicator with color coding (green for positive, red for negative)
  • Auto-refreshes every 30 seconds
  • Dark theme for easy viewing
  • Responsive design for mobile devices

2. Health Check

• URL: /api/health
• Method: GET
• Description: Health status of the API
• Response:

  {
    "status": "healthy",
    "timestamp": "2024-01-01T00:00:00.000000",
    "service": "mnav-api",
    "version": "1.0.0"
  }

3. Get mNAV Data

• URL: /api/mnav
• Method: GET
• Query Parameters:
  • fund_code (optional): Specific fund code
• Response:

  {
    "success": true,
    "data": {
      "fund_code": "FUND123",
      "fund_name": "Sample Fund FUND123",
      "nav": 125.45,
      "date": "2024-01-01",
      "change": 1.23,
      "change_percent": 0.99,
      "currency": "USD"
    }
  }

4. Webhook Endpoint

• URL: /webhook/mnav
• Method: POST
• Headers: Content-Type: application/json
• Body:

  {
    "fund_code": "FUND123",
    "nav": 125.45,
    "date": "2024-01-01"
  }

• Response:

  {
    "success": true,
    "message": "Webhook received successfully",
    "id": 1
  }

5. Webhook History

• URL: /webhook/mnav/history
• Method: GET
• Query Parameters:
  • page (default: 1)
  • per_page (default: 10)
• Description: View webhook history for debugging

Deployment

Railway (Recommended)

1. Fork/Clone this repository

2. Connect to Railway

   • Go to Railway
   • Click "New Project" → "Deploy from GitHub repo"
   • Select your repository

3. Configure environment (optional)

   • Add any required environment variables

4. Deploy

   • Railway automatically builds and deploys

Heroku

1. Install Heroku CLI

2. Create app

   heroku create your-app-name

3. Deploy

   git push heroku main

Manual Deployment

See DEPLOYMENT_GUIDE.md for detailed deployment instructions.

Environment Variables

• PORT: Server port (default: 5000)
• DEBUG: Enable debug mode (default: False)

Testing

Run local tests

# Install test dependencies
pip install pytest pytest-cov

# Run tests
pytest

Test endpoints

# View big display mode (open in browser)
open http://localhost:5000

# View display for specific fund
open http://localhost:5000?fund_code=TECH

# Health check
curl http://localhost:5000/api/health

# Get mNAV data
curl http://localhost:5000/api/mnav?fund_code=FUND123

# Send webhook
curl -X POST http://localhost:5000/webhook/mnav \
  -H "Content-Type: application/json" \
  -d '{"fund_code":"FUND123","nav":125.45,"date":"2024-01-01"}'

Display Mode Example

When you visit the root URL (/), you'll see:

     SAMPLE FUND DEFAULT
         125.45
      +1.23 (0.99%)
    Last updated: 15:35:22

The display features:

• Extra large font size for the NAV value
• Color-coded change indicator (green/red)
• Dark background for reduced eye strain
• Auto-refresh every 30 seconds
• Mobile responsive design

Development

Project Structure

mnav-api/
├── app.py                # Main application
├── requirements.txt      # Dependencies
├── Dockerfile           # Container config
├── railway.json         # Railway config
├── Procfile            # Process file
├── README.md           # This file
├── DEPLOYMENT_GUIDE.md # Deployment guide
└── .github/
    └── workflows/
        └── deploy.yml  # CI/CD workflow

Adding New Endpoints

1. Add route to app.py
2. Update documentation
3. Add tests
4. Deploy

Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

License

This project is open source and available under the MIT License.

Support

For issues, questions, or contributions, please open an issue on GitHub.

---

Built with ❤️ using Flask and deployed on Railway