{"id":49115552,"url":"https://github.com/schonarth/pivot","last_synced_at":"2026-04-21T07:05:28.817Z","repository":{"id":350958030,"uuid":"1208865754","full_name":"schonarth/pivot","owner":"schonarth","description":"AI-powered paper trading app with news sentiment + technical analysis, simulation, alerts with auto-trade, and MCP integration","archived":false,"fork":false,"pushed_at":"2026-04-19T23:43:08.000Z","size":972,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T01:26:16.488Z","etag":null,"topics":["ai-analysis","papertrade","papertrader","trade","trader","tradinganalysis"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schonarth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-12T20:58:51.000Z","updated_at":"2026-04-19T23:43:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/schonarth/pivot","commit_stats":null,"previous_names":["schonarth/pivot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/schonarth/pivot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schonarth%2Fpivot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schonarth%2Fpivot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schonarth%2Fpivot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schonarth%2Fpivot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schonarth","download_url":"https://codeload.github.com/schonarth/pivot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schonarth%2Fpivot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32081125,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T06:27:27.065Z","status":"ssl_error","status_checked_at":"2026-04-21T06:27:21.250Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-analysis","papertrade","papertrader","trade","trader","tradinganalysis"],"created_at":"2026-04-21T07:05:01.697Z","updated_at":"2026-04-21T07:05:28.810Z","avatar_url":"https://github.com/schonarth.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![Pivot logo](./frontend/public/pivot-logo.png) Pivot\n\n\n**An AI-powered paper trading simulator** for developing and testing investment strategies across global markets without risking real capital. Build strategies, get AI-generated insights with broad market context, track how the story changes over time, compare portfolio or watchlist summaries, and surface new assets worth watching, all risk-free — or let your AI agent do it for you with MCP support!\n\n---\n\n## What You Can Do\n\n- **Develop strategies** with technical indicators and backtesting engine\n- **Get AI insights** — Technical analysis powered by your choice of AI providers, with linked source headlines and broader context beyond the ticker\n- **Backtest strategies** against historical OHLCV data\n- **Paper trade** across 4 global markets: Brazil, US, UK, and Europe (Your market isn't here? Feel free to add! 😄)\n- **Set smart alerts** that trigger trades automatically when conditions are met\n- **Simulate market prices** to test strategies when markets are closed\n- **Manage multiple portfolios** and watchlists for different investment goals and risk profiles, with AI summaries that can cover the whole set\n- **Discover new opportunities** with ranked assets that are worth watching before you own them\n- **Bring your AI agent** to trade with you with our simple to setup MCP server\n\nPerfect for developing trading strategies, testing alert logic, learning portfolio management, and experimenting with automated trading — all without risking real capital.\n\n---\n\n## Getting Started\n\n### Requirements\n\nYou only need **Docker**. That's it.\n\n**Don't have Docker?**\n- [Download Docker Desktop](https://www.docker.com/products/docker-desktop)\n- Install and run it\n\n### Start the Application\n\nOnce Docker is running:\n\n**Linux/Mac:**\n```bash\n./start.sh\n```\n\n**Windows:**\n```bash\nstart.bat\n```\n\nThe application will be ready at `http://localhost:3000` in about 30 seconds.\n\n### First Time Setup\n\n1. Open `http://localhost:3000` in your browser\n2. Register with an email and password\n3. Create your first portfolio (choose a market)\n4. Deposit starting capital\n5. Start trading!\n\n---\n\n## Features\n\n### Strategy Development\n- **Build strategies** with technical indicators (moving averages, RSI, MACD, Bollinger Bands, and more)\n- **Backtest** strategies against historical OHLCV data\n- **Monitor execution** — Track autonomous trades triggered by your strategies\n- **Test and iterate** — Refine rules before deploying to live trading\n\n### AI-Powered Market Intelligence\n- **Generate technical analysis** — Claude, GPT, and Gemini supported now for market insights, with recent headlines tied back to the original source articles\n- **Follow the narrative** — news digest is kept short and readable, so the insight can explain what changed instead of treating each run like a blank slate\n- **Compare scope-level context** — portfolio and watchlist summaries help you see whether the whole set is moving together or diverging\n- **Spot opportunities earlier** — discovery surfaces a capped shortlist of assets worth watching, with a concise reason for each one\n- **Budget tracking** — Monitor AI provider costs and set spending limits (API key required — sorry, no flat rate support 😅)\n\n### Portfolios\n- Create separate portfolios for different markets\n- Track cash, invested value, and profit/loss\n- View performance history and returns\n- See AI summaries for portfolios and watchlists when you want a quick read on the whole group\n- Use divergence-style comparisons to see how a holding or watch item differs from the surrounding context\n- Deposit or withdraw funds anytime\n\n### Trading\n- Buy and sell stocks/ETFs with automatic fee calculation\n  - (no real money transactions, this is for study)\n- Track your positions and average costs\n- View current prices and unrealized gains/losses\n\n### Price Alerts\n- Set alerts when prices go above or below your target\n- Get notified when alerts trigger\n- Automatically execute trades when conditions are met\n- Choose fixed quantity or percentage-based trades\n\n### Market Simulation\nTest your strategies when markets are closed:\n\n**Quick price update:**\n```bash\n./simulate_price.sh AAPL 150.00\n```\n\n**Run realistic market movement:**\n```bash\n./simulate_market.sh\n```\n\n**Simulate with directional trends:**\n```bash\n./simulate_market.sh --trends AAPL MSFT\n```\n\n**Simulate specific market:**\n```bash\n./simulate_market.sh BR\n```\n\nThe simulator updates prices in real-time—watch your portfolio and strategies react on the dashboard.\n\n\u003e [!IMPORTANT]\n\u003e To enable alerts for simulated market, you must turn on the **simulation toggle** on your portfolios.\n\n\u003e [!TIP]\n\u003e Use different portfolios to run simulations and for actual market tracking, to prevent distortions.\n\n---\n\n## AI-Powered Automation (MCP Server)\n\nUse AI agents to automate trading, backtest strategies, generate insights, and manage your portfolio.\n\n**Agent capabilities:**\n- Manage trades, alerts, and portfolios\n- Backtest trading strategies against historical data\n- Generate technical analysis and trading insights\n- Monitor strategy execution and autonomous trades\n- Manage AI provider settings and cost budgets\n- Look up assets through trusted sources when a symbol is missing locally\n\n**To set up agent access:**\n1. Go to Settings\n2. Copy the prompt template with your User UUID\n3. Generate a one-time password (OTP) and give it to your agent\n4. Your agent will have full access to manage trading, backtesting, discovery, and insights\n\n---\n\n## Supported Markets\n\n| Market | Currency | Trading Fee | Exchange |\n|--------|----------|-------------|----------|\n| Brazil | BRL | 0.03% | BVMF |\n| United States | USD | 0% | XNYS |\n| United Kingdom | GBP | 0.1% | XLON |\n| Europe | EUR | 0.1% | XPAR |\n\n---\n\n## Troubleshooting\n\n**\"Can't connect to http://localhost:3000\"**\n- Make sure Docker is running\n- Run the start script again\n- Wait 30 seconds for services to initialize\n- If you're accessing from a different machine than you're running the Pivot server, replace `localhost` with the server's IP address.\n\n**\"Application won't load\"**\n- Check that port 3000 isn't in use by another application\n- Restart Docker\n\n**\"Simulator not updating prices\"**\n- Make sure the application is running (`./start.sh` or `start.bat`)\n- Try a fresh start: stop the application and run the start script again\n\n**Need to stop the application?**\n```bash\ndocker compose down\n```\n\n---\n\n## License\n\nMIT License. See LICENSE file for details.\n\n---\n\n**Built with ❤️ for learning and experimentation.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschonarth%2Fpivot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschonarth%2Fpivot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschonarth%2Fpivot/lists"}