# MyScanity — extended fact sheet

Last updated: 2026-10-29

## What MyScanity is

MyScanity scans global equity markets every trading day, detects trading setups from a fixed catalog, and turns each detected setup into a trade plan with a concrete entry, stop-loss, and 3R/5R targets. Users get a ranked focus list, a custom watchlist, a virtual portfolio with a performance overview, and a daily market newsletter.

## Coverage

- 13 setup types (breakout, episodic pivot, parabolic, VCP, pullback, high-tight flag momentum, CVI rebound/sell, Supertrend, relative-strength leaders)
- 38 country markets across North America, Europe, and Asia-Pacific
- 18 named indices selectable per scanner profile
- Instrument types: stocks and ETFs

## Pricing and trial

- Monthly: 17,00 € (incl. VAT, cancel monthly)
- Yearly: 160,00 € (incl. VAT, cancel monthly)
- Free trial: 14 days, no payment details required
- Payment: Stripe Checkout with 3-D Secure; subscriptions renew until cancelled

## How it works

1. The scan runs once per trading day over the selected universe.
2. Detectors match the catalog's technical criteria (stage analysis, relative strength, volume, structure).
3. Each match gets a trade plan; setups without a valid plan are marked with a reason instead of being dropped silently.
4. The focus list surfaces the strongest setups; matches feed the portfolio and newsletter surfaces.

## Agent API contract

Base URL: https://www.myscanity.de/api/v1 — agent routes live under `/agent/` and accept bearer tokens only.

```bash
curl -s https://www.myscanity.de/api/v1/agent/me \
  -H 'Authorization: Bearer mys_...' \
  -H 'X-MyScanity-Client: claude'
```

| Method | Path | Scope | Returns |
|---|---|---|---|
| GET | /api/v1/agent/me | any | Token probe: username, token name, scopes |
| GET | /api/v1/agent/setups | setups:read | Ranked stored setups with status and compact plan |
| GET | /api/v1/agent/trade-plan/{ticker} | setups:read | Entry, stop, targets, or the skip reason |
| GET | /api/v1/agent/portfolio | portfolio:read | Pending, open, and closed positions vs today's setups |
| GET | /api/v1/agent/watchlist | watchlist:write | Custom watchlist for the active profile |
| PUT | /api/v1/agent/watchlist | watchlist:write | add / remove / replace tickers |
| POST | /api/v1/agent/book-review | book:review | Ephemeral book overlay on the rotation board |

Scopes:

- `setups:read` — stored setups, trade plans
- `portfolio:read` — pending / open / closed positions
- `watchlist:write` — read and write the custom watchlist
- `book:review` — overlay an external depot on today's rotation (ephemeral)

Limits and errors:

- 60 requests/minute per token; watchlist writes and book reviews 10/minute; failed token attempts 20/minute per IP
- Response headers: `RateLimit` + `RateLimit-Remaining` on success, `Retry-After` on 429, `WWW-Authenticate: Bearer realm="myscanity"` on 401/403 (with `resource_metadata`).
- `PUT /api/v1/agent/watchlist` accepts `Idempotency-Key`; replay window 24 h.
- 401 missing/invalid token, 402 not entitled, 404 unknown resource, 429 rate limited
- Auth resource metadata: https://www.myscanity.de/.well-known/oauth-protected-resource
- Response shape is compact: setup status, plan levels, position state, and a reason when no plan exists — not raw market data.

## Boundaries (do not assume)

- No raw OHLCV, no chart binaries, and no bulk data export.
- No scan triggers, no optimizer runs, no settings or admin mutations.
- Not investment advice; no performance guarantees; past results do not predict future returns.
- Yahoo Finance is the upstream market-data source; redistribution limits apply to the underlying quotes.

## Contact and discovery

- Site: https://www.myscanity.de/
- API guide: https://www.myscanity.de/entwickler/api
- OpenAPI: https://www.myscanity.de/api/openapi.json
- Auth metadata: https://www.myscanity.de/.well-known/oauth-protected-resource
- Imprint: https://www.myscanity.de/impressum
- Agent map: https://www.myscanity.de/llms.txt
- Sitemap: https://www.myscanity.de/sitemap.xml