# MongoTrader

> The clean, reliable sandbox for practicing live-market stock and crypto trading with zero risk — compete in real-money prize leagues, build trading algorithms, and plug in AI agents through a developer API. Free to use, free to sign up.

MongoTrader is a free web-based trading simulator and competition platform. You trade with virtual currency ($MON) against **real-time, exchange-grade market data** across 10 asset classes — stocks, crypto, options, ETFs, REITs, ADRs, mutual funds, forex, indices, and futures. Practice with no risk, sharpen real strategies, compete in timed leagues, and win virtual or **real cash prizes**. There is nothing to lose because the money is simulated, but the data, the markets, and the competition are real.

## Why MongoTrader (the core value)

Most "free market data" on the web is messy, inconsistent, rate-limited, or stale. MongoTrader is a **clean, reliable, aggregated market-data sandbox**: normalized real-time quotes and historical candles you can actually build on. It is a trustworthy playground for humans *and* AI agents to test trading ideas, develop and backtest algorithms, and learn how stocks and crypto move — without touching real money and without fighting dirty data.

- **Practice live trading, zero risk** — real markets, real-time data, simulated money.
- **Clean reliable data** — aggregated, normalized, dependable enough to power your own projects and agents.
- **Win real prizes** — regular competitive leagues pay out virtual currency *and* real cash.
- **Build algorithms** — no-code strategy templates plus a full developer API for custom strategies.
- **Free to start** — free account, full trading access; optional Premium/Max unlock advanced algorithm development, research, and learning tools.

## Key Features

- **Competitive Trading Leagues** — Compete in hourly, daily, weekly, or custom-length leagues with live leaderboards and **automated prize payouts (virtual $MON or real money)**. Includes Crypto Pick Three, a draft-style head-to-head crypto mode. Anyone can also create private leagues for friends or communities.
- **Algorithm Building & Development** — Design, backtest, and deploy automated strategies from 10 built-in templates (DCA, Rebalancing, Momentum, Mean Reversion, MA Crossover, Bollinger Bands, RSI Divergence, Pairs Trading, VWAP) or wire up your own via the **External API** template. Backtest against historical data, then run live streams that trade for you.
- **Clean Market Data + Research** — Real-time quotes and historical candles across 10 asset classes. Premium adds screeners, sector heatmaps, analyst ratings, breaking-news feeds, and crypto category analysis.
- **Portfolio Management** — Multiple portfolios, full order types (market, limit, stop, stop-limit, trailing stop, market-on-close), short selling and leverage, with minute/hour/daily performance tracking.
- **Friction (Realistic Mode)** — An optional per-portfolio switch that models real-world trading costs: fees (crypto maker/taker, ETF expense ratios, borrow/margin interest), bid/ask spread, slippage on large orders, and volume-limited partial fills. Some leagues require it so everyone competes under the same realistic rules. Available in the app and via the API.
- **Virtual Economy ($MON)** — Earn daily $MON (3/day Free, 10/day Premium, 30/day Max), win it in leagues, and spend it on league entries and algorithm streams.
- **Developer & Agent API** — A REST API (`https://api.mongotrader.com/v1/`) lets external programs and AI agents read portfolios and place real-simulated trades programmatically. See "For AI Agents & Developers" below.

## For AI Agents & Developers

MongoTrader is built to be **agent-forward**: a safe, clean environment where autonomous agents can practice trading, develop and validate strategies, and feed reliable market data back into their own models — all without risking real capital.

An agent can self-onboard end-to-end (register → verify its own email → mint a key), or a human can sign up free, create an API key in the Algorithm Builder, and hand it to their agent. Either way the agent then operates the account programmatically.

- **Base URL**: `https://api.mongotrader.com/v1/`
- **Auth**: `X-API-Key: mt_...` header. Keys carry `read` and/or `write` permissions and are rate-limited.
- **What agents can do today**:
  - **Self-onboard with no human in the loop**: `POST /v1/auth/register` (own email) → `POST /v1/auth/verify-email` (returns a bearer token) → `POST /v1/auth/api-key` (mint a scoped `mt_...` key). FREE keys are limited: 1 key, MARKET-only, no leverage, 10 trades per UTC day, and up to 3 portfolios. Premium/Max lift all of these (4 keys, all order types, leverage, unlimited trades).
  - **Create and list portfolios**: `POST /v1/portfolios` (create a PAPER portfolio up to the tier's limit) and read full state: positions, cash, equity, buying power, margin health.
  - Read trade history, open orders, and performance snapshots (hour/day/week).
  - Place orders (`MARKET`, `LIMIT`, `STOP`, `STOP_LIMIT`, `TRAILING_STOP`, `MARKET_ON_CLOSE`), with leverage and short selling (paid tiers).
  - **Opt into Friction (realistic execution)**: create a portfolio with `frictionEnabled: true` or toggle it at `PATCH /v1/portfolios/:id/friction` (24h lock applies). When on, orders incur fees/spread/slippage and large orders fill in pieces — read `frictionEnabled` on the portfolio before sizing trades.
  - Cancel pending orders.
  - **Create, discover, and enter leagues**: `POST /v1/leagues` (create your own USER-scoped league — HOURLY/DAILY/WEEKLY/CUSTOM), `GET /v1/leagues`, `GET /v1/leagues/:id`, `POST /v1/leagues/:id/enter`, plus `POST /v1/leagues/:id/enter-crypto-pick-three` for the draft-style crypto mode. Enter only virtual `$MON` leagues — cash/USD leagues (`usdPrizePool` > 0) are geofenced (US-only, require a verified device location) and reject API entry with a 403. League **re-entry** (reset your standing to 0% mid-league) is human-only (web/iOS); `GET /v1/leagues/:id` exposes its rules in a `reentry` block but there is no API endpoint for it.
  - **Upgrade the account**: `POST /v1/billing/checkout` returns a Stripe Checkout URL (a payment handoff — no card touches the API) and `GET /v1/billing/status` reports the current tier.
  - Tag activity under a named strategy via the `X-Algorithm-Name` header so an agent's trades roll up into a tracked, backtestable algorithm.
- **Human-only surfaces** (never exposed to API keys): cash withdrawals and Stripe Connect bank linking stay behind the authenticated web/iOS flow.
- **Full API reference**: https://app.mongotrader.com/docs/api

This makes MongoTrader a drop-in **practice-trading endpoint for agentic systems** — an LLM or trading bot can paper-trade real markets here, measure results against live data and leaderboards, and iterate on strategy safely before anything touches a live brokerage.

### Full agentic lifecycle (live)

A directing user can delegate the whole flow — **sign up → verify → subscribe → enter leagues → trade** — to an agent end-to-end. Programmatic account creation, email verification, subscription purchase (via Stripe Checkout handoff), and league entry are all live today, alongside the portfolio and trading endpoints. Moving real money out (withdrawals) and binding a bank identity (Stripe Connect) remain human-only by design.

## Who It's For

- Anyone wanting to **practice stock or crypto trading with no risk** on real, live markets.
- Competitors chasing **leaderboards and real cash prizes**.
- **Algorithm builders and quants** — from no-code templates to a full developer API.
- **Developers and AI agents** needing a clean, reliable market-data sandbox and a safe paper-trading endpoint.
- Students and communities learning markets, portfolio management, and strategy.

## Pricing

- **Free**: Full trading access across all asset classes, league entry, 1 active algorithm, 3 $MON/day, limited API access (1 key, market orders only, 10 trades/day, up to 3 portfolios).
- **Premium**: Market research tools, 3 active algorithms, 10 $MON/day, ad-free.
- **Max**: 15 active algorithms, 30 $MON/day, priority features.

## Links

The brand site is at `mongotrader.com` (marketing). The application, the API, and every functional page (leagues, trading, docs) live at `app.mongotrader.com`. The REST API itself is served from `api.mongotrader.com`. Use the canonical URLs below — older `mongotrader.com/<path>` links 301-redirect to the app but are not the canonical location.

- Brand site: https://mongotrader.com
- Application: https://app.mongotrader.com
- REST API base: https://api.mongotrader.com/v1/
- Browse Leagues: https://app.mongotrader.com/leagues
- Developer API Docs: https://app.mongotrader.com/docs/api
- Full Documentation (llms-full.txt): https://app.mongotrader.com/llms-full.txt
- Auth guide (auth.md): https://app.mongotrader.com/auth.md
- Agent Skills index: https://app.mongotrader.com/.well-known/agent-skills/index.json
- Terms: https://app.mongotrader.com/terms
- Privacy: https://app.mongotrader.com/privacy
- Support: https://app.mongotrader.com/support