REST API v1
Zod-validated endpoints keep business logic outside route handlers.
Generated contract registry
| Path | Method | Summary |
|---|---|---|
| /api/v1/health | get | Service health and configured adapters |
| /api/v1/valuations/trade | post | Evaluate a two-sided fixture trade |
| /api/v1/players | get | List deterministic demo players |
| /api/v1/prospects | get | List deterministic fictional prospect fixtures |
| /api/v1/prospects/{prospectId} | get | Get a fictional prospect fixture |
| /api/v1/prospects/import-preview | post | Validate a permitted admin prospect CSV without persistence |
| /api/v1/matchups/demo/scenario | post | Run an immutable deterministic matchup scenario |
| /api/v1/sleeper/discover | post | Resolve a public Sleeper username and discover leagues |
| /api/v1/sleeper/league | post | Preview a Sleeper league without persistence |
| /api/v1/sleeper/import | post | Durably import a Sleeper league into the authenticated account |
| /api/v1/account/leagues | get | List private imported leagues |
| /api/v1/account/leagues | delete | Delete a private league import and its dependent records |
| /api/v1/account/objective | get | Load the active account-scoped championship objective |
| /api/v1/account/objective | post | Version and save a championship objective |
| /api/v1/account/preferred-roster | post | Set a private roster display preference |
| /api/v1/account/prospect-research | get | Read private watchlist and note state |
| /api/v1/account/prospect-research | post | Save private watchlist and note state |
| /api/v1/plans/demo | post | Build a deterministic fixture championship plan |
| /api/v1/trade-finder/demo | post | Find explainable fixture trade candidates |
| /api/v1/feedback | post | Record suggestion feedback |
| /api/v1/calculations/share | post | Create a privacy-safe deterministic calculation share ID |