`README.md`

43 lines
# polymtrx

A Claude Code skill that scans **live Polymarket** prediction markets and ranks
them by tradeable-edge signals — reproducing the MTRX / [@Polymtrx](https://x.com/polymtrx)
(PolyMatrix) "prediction markets + signals → find the best opportunities"
workflow.

- **Zero-dependency** — Python 3.9+ stdlib only.
- **No API keys** — hits Polymarket's free public Gamma + CLOB endpoints.
- **$0 (local)** — no metered calls.
- **Read-only** — surfaces opportunities; never trades, never touches a wallet or key.

## Layout
```
skills/polymtrx/
  SKILL.md                 the skill contract (frontmatter + workflow)
  scripts/polymtrx.py      the engine: fetch → normalize → score → rank → emit
  references/api.md        Polymarket endpoint shapes + coercion gotchas
```
Symlinked live at `~/.claude/skills/polymtrx → skills/polymtrx`.

## Usage
```bash
python3 skills/polymtrx/scripts/polymtrx.py scan "fed rate cut" --emit markdown
python3 skills/polymtrx/scripts/polymtrx.py trending
python3 skills/polymtrx/scripts/polymtrx.py market fed-decision-in-july-181
python3 skills/polymtrx/scripts/polymtrx.py doctor
```

## Opportunity score
Blended 0–100 from six signals: `volume` (0.30), `timing` (0.20), `contest`
(0.20), `liquidity` (0.15), `movement` (0.10), `longshot` (0.05). Tune in
`WEIGHTS` / `score_market()`.

## Provenance
Seed idea: `x.com/polymtrx/status/2076318987441357033`. X paywalls automated
reads, so the exact post text couldn't be captured; this implements the
confirmed workflow category (Polymarket opportunity intelligence). Refine the
scoring in `scripts/polymtrx.py` if the source describes a sharper method.

## License
MIT.