# Investment Bets

> Investment Bets is a gamified paper-trading web app for tracking stock-market calls by percentage return.

Investment Bets lets users place long or short paper-trading bets on stocks, compare performance on leaderboards, follow other traders, and review public track records. Prices are fetched server-side from market data so entry and exit prices are not user supplied.

## Primary Resources

- [Website](https://investment-bets.com/): Browser app for sign-in, portfolios, bets, leaderboards, public profiles, follows, feed, billing, and Telegram notifications.
- [Full LLM overview](https://investment-bets.com/llms-full.txt): Expanded product, API, and crawler guidance.
- [Authentication notes](https://investment-bets.com/auth.md): How agents should understand account creation, cookie sessions, and protected endpoints.
- [API catalog](https://investment-bets.com/.well-known/api-catalog): RFC 9727 linkset pointing to machine-readable API descriptions.
- [OpenAPI description](https://investment-bets.com/openapi.json): Public description of the Investment Bets API surface.
- [Sitemap](https://investment-bets.com/sitemap.xml): Canonical crawlable URLs.
- [Crawler policy](https://investment-bets.com/robots.txt): Robots directives and Content-Signal preferences.

## Public API Summary

The production API origin is `https://api.investment-bets.com`. Public unauthenticated reads include leaderboards, public user profiles, and Stripe plan listings. Most account, trading, feed, follow, billing portal, and Telegram operations require an HttpOnly `auth_token` cookie from the email/password login flow.

## Agent Guidance

- Use `Accept: text/markdown` on `https://investment-bets.com/` to retrieve a concise markdown homepage.
- Use `/openapi.json` before attempting API calls.
- Do not call write endpoints unless a human user has explicitly authorized the action.
- Do not probe webhook endpoints.