ARCHR Edge (archer-odds-tool)
A multi-sport odds and props app: every price at every book next to ARCHR's own model, for NBA, NFL, UFC, MLB, soccer, tennis and F1.
- Game lines. Moneylines, spreads, totals, team totals, halves and quarters, alternates. For each one: the best price across books, ARCHR's fair price, and the edge (EV) between them. Tap a price to add it to the slip.
- Player props. One layout for every sport: a line ladder, a game-by-game chart, the projection and what drives it, hit rates (L5/L10/season/vs opponent/home-away) and every book's price. ARCHR posts its own line before the books do, and the books' prices slot in when they post. Each sport adds its own panels: NBA usage, NFL snaps/air yards/red-zone looks, MLB pitcher matchups, UFC fighter metrics, tennis serve and return.
- Matchup breakdowns. A face-off, tale of the tape, and "why ARCHR prices it this way" for every game, bout and match.
- Models. Fitted and backtested, each blended with the market. Every model's accuracy and calibration are on
/models.
- Discord. A daily +EV card, a free lean, a graded results recap, plus slash commands.
It's a research tool: it doesn't place bets.
Where things are
| Path | What |
|---|
/ | Home: today across every sport |
/slate | The odds Slate: every game, every market, best price vs ARCHR |
/nba, /nfl, /mlb, /ufc, /f1 | Sport pages (boards, game/bout pages) |
/nba/props, /nfl/props, /mlb/props, /ufc/props | Player and fighter props |
/sports, /sports/<sport>, /sports/<sport>/props | The all-sports engine: soccer, tennis and every other league the feeds carry, with soccer and tennis props |
/models | Model report cards |
/api/cron/* | Background jobs (bearer CRON_SECRET) |
/api/health, /api/status | DB connectivity; job freshness and compute budget |
Design notes live in docs/architecture/. Start with operations.md (schedule, compute budget), MODEL-FRAMEWORK.md, and the per-sport props docs (nba-props.md, NFL-ADVANCED.md, MLB-PROPS.md, SOCCER-PROPS.md, TENNIS-PROPS.md, UFC-PROPS.md).
Stack
- App: Next.js 16 (App Router, TypeScript), deployed on Vercel.
- Database: Prisma 7 on Postgres, Neon in production. The client is generated to
src/generated/prisma; import it from @/generated/prisma/client.
Data sources:
- Odds: The Odds API or ParlayAPI (optionally OddsBlaze per sport), odds-api.io for the long tail, and ESPN's free DraftKings lines.
- Schedules, scores and box scores: ESPN and the MLB Stats API.
- UFC: Cito, plus UFCStats via a public mirror.
- Tennis: the Sackmann ATP/WTA archive plus ESPN.
- NFL advanced stats: nflverse.
Local development
Requires Docker (for local Postgres). Odds keys are optional: without one, the app still runs on ESPN's free lines, and ARCHR's own prices still show.
cp .env.example .env # every variable, with what it does; fill in what you need
docker compose up -d # local Postgres on :5432
npx prisma migrate dev # apply the schema
npm run dev # http://localhost:3000
npm run lint # eslint
npm run typecheck # tsc --noEmit
npm test # vitest
npm run build # production build
npx prisma studio # browse the local DB
Run any job locally with curl -H "Authorization: Bearer $CRON_SECRET" localhost:3000/api/cron/<job>.
Background jobs
Vercel Cron runs one route, /api/cron/tick, about 20 times a day. Each tick wakes the database once and runs every job that's due, by its own cadence or at fixed hours: odds, fixtures, results, box scores, history imports, grading and the Discord posts. The schedule lives in src/lib/ops/schedule.ts.
Pages also refresh the data behind them when it's stale. Viewing a page wakes the database anyway, so this costs nothing extra.
Why it's built this way: the production database is billed by the hours it's awake. See docs/architecture/operations.md.
GitHub Actions call the same /api/cron/* routes. They're manual, except the weekly Model Lab:
model-lab.yml: weekly (Monday), plus manual. Runs the backtests and fits against production, and saves the report cards behind /models.sync-free.yml: health check plus a one-off refresh.backfill-history.yml, all-sports-fill.yml: one-time history fills.poll-odds*.yml, poll-player-props.yml: on-demand odds polls. These spend credits.fire-card.yml, results-tick.yml: post the Discord card or recap now.reset-ledger.yml: wipes the results ledger. Destructive.ops-status.yml: read-only status.ci.yml: lint, typecheck, tests, build.
The workflows need two repo secrets (Settings → Secrets and variables → Actions): APP_URL (the deployed base URL) and CRON_SECRET (the same value as the deployment's). Model Lab also needs DATABASE_URL.
