# analyst-picks

Read the picks analysts stated in their public content, credited and linked to the source, only when you ask for them.

| Method | Path | Title | Access | Price | MCP tool |
| --- | --- | --- | --- | --- | --- |
| GET | [`/v1/analyst-picks`](#list-analyst-picks) | List analysts' picks | `read:odds` | 1 | `get_analyst_picks` |
| GET | [`/v1/analyst-picks/days`](#list-analyst-pick-days) | Count analysts' picks by day | `read:odds` | 1 | none |
| GET | [`/v1/analyst-picks/{pick_id}`](#get-analyst-pick) | Get one analyst pick | `read:odds` | 1 | `get_analyst_pick` |
| POST | [`/v1/analyst-picks/{pick_id}/report`](#report-analyst-pick) | Report a wrong analyst pick | `read:odds` | 0 | `report_analyst_pick` |
| GET | [`/v1/analysts`](#list-analysts) | List the analysts Kelly follows | `read:odds` | 1 | none |
| GET | [`/v1/analysts/leaderboard`](#get-analyst-leaderboard) | Rank the analysts by their graded picks | `read:odds` | 2 | `get_analyst_leaderboard` |
| GET | [`/v1/analysts/{analyst_id}`](#get-analyst) | Get one analyst and their record | `read:odds` | 1 | `get_analyst_record` |
| GET | [`/v1/analysts/{analyst_id}/record`](#get-analyst-record) | Get an analyst's record by period | `read:odds` | 1 | `get_analyst_record` |
| GET | [`/v1/analyst-picks/weeks/{competition}/{season}/{week}`](#get-analyst-picks-week) | Get a week's analyst picks | `read:odds` | 1 | `get_analyst_picks_week` |

`GET /v1/analyst-picks`

## List analysts' picks
scope `read:odds` · 1 credit, not charged during the beta · MCP tool `get_analyst_picks` · status live

Picks that the analysts, shows and outlets Kelly follows stated in their public content (podcasts, videos, articles, posts), newest first: who said it, the game, the market, the selection, the line and price as stated, how firmly, and a link to the source at the moment it was said. Only on request: it never appears inside an answer, a market or any other response, and Kelly never rates, ranks or recommends a pick or an analyst. Filter by a local day or a range on the game's, the source's or Kelly's clock, firmness and grade; sort by when said, the game, units or CLV; add each pick's grade and the market's fair chance, the totals over every pick the filters keep, or take the whole range as CSV (ADR-K247); following=true keeps the picks from what your account follows (ADR-K250).

### Parameters
- `analyst` string · query  
  Only this analyst's picks (anl_…).  
  pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
- `sport` string · query  
  Only this sport, e.g. nfl.  
  pattern ^[a-z]{2,10}$
- `game_id` string · query  
  Only picks matched to this game (gm_…).  
  pattern ^gm_[0-9a-hjkmnp-tv-z]{20}$
- `since` string · query  
  Reported at or after this, with offset.  
  format date-time
- `until` string · query  
  Reported before this, with offset.  
  format date-time
- `market` string · query  
  Only picks on this kind of market.  
  One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
- `upcoming_days` integer · query  
  Only picks on games starting from now through this many days ahead (0: today), New York days.  
  min 0 · max 14
- `group` string · query  
  game: add each pick's line now and move, and the games with their pick counts per side.  
  One of: `game` (open: new values may be added).
- `limit` integer · query  
  Picks per page; default 20.  
  min 1 · max 100
- `cursor` string · query  
  next_cursor from the previous page, with the same filters.  
  min length 1 · max length 512
- `date` string · query  
  Only picks on this local day in tz, on basis's clock (the game's day by default). Not with since or until.  
  format date
- `tz` string · query  
  date's IANA zone; default America/New_York.  
  min length 1 · max length 64
- `basis` string · query  
  The clock date, since and until read: game (the game's start; date's default), said (the source's publish time) or reported (when Kelly reported it; since and until's default).  
  One of: `game`, `said`, `reported` (open: new values may be added).
- `firmness` string · query  
  Only picks put this firmly: official, lean, mention, comma-separated.  
  min length 1 · max length 40
- `result` string · query  
  Only picks graded this way; open: its game not over yet; ungraded: its game is over with no grade, graded.reason says why.  
  One of: `won`, `lost`, `push`, `void`, `late`, `open`, `ungraded` (open: new values may be added).
- `series` string · query  
  Only picks given in this named series (Road to 272, Teaser of the Week), in any case.  
  min length 1 · max length 80
- `team_id` string · query  
  Only picks on this team's games or naming it: a team page's picks.  
  pattern ^tm_[0-9a-hjkmnp-tv-z]{20}$
- `player_id` string · query  
  Only picks naming this player or a prop player linked to him: a player page's picks.  
  pattern ^plr_[0-9a-hjkmnp-tv-z]{20}$
- `sort` string · query  
  reported (default), said, game, units or clv; picks with no value last.  
  One of: `reported`, `said`, `game`, `units`, `clv` (open: new values may be added).
- `order` string · query  
  desc (default) or asc.  
  One of: `desc`, `asc` (open: new values may be added).
- `include` string · query  
  grade, fair and public, comma-separated: each pick's grade, the market's fair chance of its side, and (with group=game) the public's shares per game.  
  min length 1 · max length 40
- `totals` boolean · query  
  true: add the record of every pick the filters keep.
- `format` string · query  
  json (default) or csv: every pick the filters keep, one row each, as text/csv.  
  One of: `json`, `csv` (open: new values may be added).
- `following` boolean · query  
  true: only picks from the analysts, teams and competitions your account follows (GET /v1/me/following; a competition counts whole only when it is in whole_leagues).

### Response
`200` The picks, newest first.

- `object` const · required  
  Always analyst_pick_list.  
  Always `"analyst_pick_list"`.
- `data` array of object · required  
  The picks, newest reported first.
  - `object` const · required  
    Always analyst_pick.  
    Always `"analyst_pick"`.
  - `id` string · required  
    The pick's ID (apck_…).  
    pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$
  - `analyst` object · required  
    Who the pick is credited to.
    - `id` string · required  
      The analyst's ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The analyst's, show's or outlet's name.
    - `kind` string · required  
      person, show or outlet: a show or outlet is credited when the person who said it is not one Kelly follows (stated_by names them).  
      One of: `person`, `show`, `outlet` (open: new values may be added).
  - `stated_by` string · required  
    Who said it, as named in the source.
  - `outlet` object · required · nullable  
    The outlet or show the pick was published on, when that is not who it is credited to: the pick counts for both records. Null otherwise.
    - `id` string · required  
      The outlet's or show's analyst ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The outlet's or show's name.
    - `kind` string · required  
      outlet or show.  
      One of: `outlet`, `show` (open: new values may be added).
  - `show` object · required · nullable  
    The show it was said on, when an outlet carries that show and the show is not who it is credited to: the pick counts for the show too. Null otherwise.
    - `id` string · required  
      The show's analyst ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The show's name.
  - `sport` string · required · nullable  
    The sport, e.g. nfl.
  - `event` string · required  
    The game or event as said.
  - `game` object · required · nullable  
    Kelly's game when the pick was matched to one, else null.
    - `id` string · required  
      The game's ID (gm_…).  
      pattern ^gm_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required · nullable  
      The game's name.
    - `start_time` string · required  
      The scheduled start.  
      format date-time
  - `market` object · required  
    The market as said, and Kelly's market when matched.
    - `id` string · required · nullable  
      Kelly's market ID (mkt_…), or null.
    - `kind` string · required  
      spread, total, moneyline, prop, future, parlay or other.  
      One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
  - `selection` string · required  
    The side as said, e.g. Steelers +3.
  - `label` string · required  
    The pick in plain words, built from the market, side, stated line and the team or player named: Over 5.5 goals, Cameron Boozer over 8.5 rebounds, Minnesota Wild moneyline. The price is not in it.
  - `stat` string · required · nullable  
    A prop's stat as said (rebounds, passing yards) or what a game total counts (points, goals, runs); null for other markets.
  - `side` string · required · nullable  
    home, away, over, under, yes, no or draw; null when not stated.  
    One of: `home`, `away`, `over`, `under`, `yes`, `no`, `draw` (open: new values may be added).
  - `team_id` string · required · nullable  
    The team picked (tm_…), when matched.
  - `player_id` string · required · nullable  
    The player picked (plr_…), when matched.
  - `line` number · required · nullable  
    The line as stated; never computed.
  - `line_text` string · required · nullable  
    The line as written: +3, pk, 44.5.
  - `price_american` integer · required · nullable  
    The price as stated, American odds.
  - `units` number · nullable  
    The stake as stated, in units ('2u', 'half a unit'); null when none was stated (never inferred from how strongly the pick was put).
  - `firmness` string · required  
    official, lean or mention: how firmly it was put.  
    One of: `official`, `lean`, `mention` (open: new values may be added).
  - `series` string · nullable  
    The named set of picks it was given in, as the source names it (Road to 272, Teaser of the Week); null when none was named. Each series has its own record.
  - `said_in` object · required  
    Where it was said.
    - `kind` string · required  
      episode, video, article or post.  
      One of: `episode`, `video`, `article`, `post` (open: new values may be added).
    - `title` string · required  
      The item's title.
    - `url` string · required  
      The item's public link, at the moment it was said when known.  
      format uri
    - `published_at` string · required  
      When the item was published.  
      format date-time
    - `moment_seconds` integer · required · nullable  
      Seconds into the show, when known.
    - `channel` object · required  
      The channel the item was published on.
      - `name` string · required · nullable  
        The channel's name.
      - `url` string · required  
        The channel's public page.  
        format uri
      - `kind` string · required  
        youtube, podcast, rss, web, x, tiktok, instagram or threads.  
        One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
    - `platform` string · required  
      The platform it was said on, for its icon: x, youtube, podcast, tiktok, instagram, threads, discord, reddit, newsletter, video (elsewhere) or article.  
      One of: `x`, `youtube`, `podcast`, `tiktok`, `instagram`, `threads`, `discord`, `reddit`, `newsletter`, `video`, `article` (open: new values may be added).
  - `said_at` string · required  
    When the pick was said in public: its source's publish time (ADR-K247).  
    format date-time
  - `released_at` string · required  
    When its source was released (the same time as said_at until Kelly knows a recording time).  
    format date-time
  - `reported_at` string · required  
    When Kelly published the pick.  
    format date-time
  - `corrects` string · required · nullable  
    The pick this one corrects (apck_…), or null.
  - `withdrawn` object  
    Only on a pick its analyst dropped before the game started, or replaced at a new line: when and where they dropped it. It is not graded and is on no list or count; the analyst's profile and the pick's own page show it.
    - `at` string · required  
      When it was dropped: the publish time of the item it was dropped in.  
      format date-time
    - `said_in` object · required  
      Where it was dropped.
      - `kind` string · required  
        episode, video, article or post.  
        One of: `episode`, `video`, `article`, `post` (open: new values may be added).
      - `title` string · required  
        The item's title.
      - `url` string · required  
        The item's public link.  
        format uri
      - `published_at` string · required  
        When the item was published.  
        format date-time
      - `channel` object · required  
        The channel the item was published on.
        - `name` string · required · nullable  
          The channel's name.
        - `url` string · required  
          The channel's public page.  
          format uri
        - `kind` string · required  
          youtube, podcast, rss, web, x, tiktok, instagram or threads.  
          One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
      - `platform` string · required  
        The platform it was said on, for its icon: x, youtube, podcast, tiktok, instagram, threads, discord, reddit, newsletter, video (elsewhere) or article.  
        One of: `x`, `youtube`, `podcast`, `tiktok`, `instagram`, `threads`, `discord`, `reddit`, `newsletter`, `video`, `article` (open: new values may be added).
  - `now` object · nullable  
    Kelly's consensus on the picked side now, when the pick's market is matched and priced; else null. Present only with group=game.
    - `point` number · required · nullable  
      The consensus line on the picked side.
    - `price` number · required · nullable  
      The consensus price, decimal.
    - `price_american` integer · required · nullable  
      The consensus price, American odds.
    - `as_of` string · required · nullable  
      The newest book time behind it.  
      format date-time
  - `move` object · nullable  
    How far the line has moved since the pick was stated; null with no line or price now. Present only with group=game.
    - `points` number · required · nullable  
      The line's distance from the stated line (0 when only the price moved).
    - `with_pick` boolean · required · nullable  
      True when the market moved the analyst's way, false against; null level.
  - `out` object · nullable  
    Kelly's consensus on the picked side when the pick came out (the time Kelly published it), from Kelly's own line history; null when Kelly had no market or fewer than two books then. Present only with group=game.
    - `point` number · required · nullable  
      The consensus line on the picked side; null for a moneyline.
    - `price_american` integer · required · nullable  
      The consensus price, American odds.
    - `at` string · required · nullable  
      The time it is taken at: the pick's publish time, or the game's start.  
      format date-time
  - `close` object · nullable  
    Kelly's consensus on the picked side from the last book update before the game started (the close closing-line value is measured against); null until the game starts, or with no market. Present only with group=game.
    - `point` number · required · nullable  
      The consensus line on the picked side; null for a moneyline.
    - `price_american` integer · required · nullable  
      The consensus price, American odds.
    - `at` string · required · nullable  
      The time it is taken at: the pick's publish time, or the game's start.  
      format date-time
  - `grade` string · nullable  
    With include=grade: won, lost, push or void; null while open, late or ungraded.  
    One of: `won`, `lost`, `push`, `void` (open: new values may be added).
  - `graded` object · nullable  
    With include=grade: the grade as Kelly settled it; null until then.
    - `result` string · required  
      win, loss, push, void, late (said after the start) or ungraded.  
      One of: `win`, `loss`, `push`, `void`, `late`, `ungraded` (open: new values may be added).
    - `reason` string · required · nullable  
      Why, when the result is ungraded, void or late ("picked side not matched to the game", "game cancelled"); null on a win, loss or push.
    - `cause` string · required · nullable  
      Why it isn't graded, as one stable code (no_line, no_game, player_not_matched, first_scorer, part_of_game, no_box_score, parlay_leg, sport_no_results, …; trackrecord.causes); null unless the result is ungraded.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated (1 unit risked); 0 on a push.
    - `closing_line` number · required · nullable  
      The closing line on the picked side, where Kelly has one.
    - `closing_price` integer · required · nullable  
      The closing price, American odds, where known.
    - `clv_points` number · required · nullable  
      The line taken minus the close, signed so + is better; null without a close.
    - `score` object · required · nullable  
      The final score.
      - `home` integer  
        Home.
      - `away` integer  
        Away.
    - `line` number · required · nullable  
      The line the pick settled at: the analyst's, or Kelly's line when the pick came out (line_basis).
    - `line_basis` string · required · nullable  
      stated (the analyst's line), release (none was said: Kelly's consensus on the picked side when the pick came out) or first_after (none was said and no book had quoted it yet: Kelly's first consensus after it, before the start); null with no line.  
      One of: `stated`, `release`, `first_after` (open: new values may be added).
  - `fair` number · nullable  
    With include=fair: the market's no-vig chance of the picked side at today's consensus line (now.point), 0–1; null when too few books price it. Never Kelly's own probability.
- `has_more` boolean · required  
  True when next_cursor reads more.
- `next_cursor` string · required · nullable  
  Send it back as cursor, with the same filters.
- `games` array of object  
  With group=game: the games the page's picks are on, by start time.
  - `game` object · required  
    The game.
    - `id` string · required  
      The game's ID (gm_…).  
      pattern ^gm_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required · nullable  
      The game's name.
    - `competition` string · required · nullable  
      Its competition, e.g. ncaaf.
    - `start_time` string · required · nullable  
      The scheduled start.  
      format date-time
    - `status` string · required · nullable  
      scheduled, live, final, …
    - `home_team` object · required · nullable  
      The team: id, name, short name and abbreviation.
      - `id` string  
        The team's ID (tm_…).
      - `name` string · nullable  
        The team's name.
      - `short_name` string · nullable  
        The team's short name, e.g. Wild.
      - `abbreviation` string · nullable  
        The team's abbreviation, e.g. MIN.
    - `away_team` object · required · nullable  
      The team: id, name, short name and abbreviation.
      - `id` string  
        The team's ID (tm_…).
      - `name` string · nullable  
        The team's name.
      - `short_name` string · nullable  
        The team's short name, e.g. Wild.
      - `abbreviation` string · nullable  
        The team's abbreviation, e.g. MIN.
    - `score` object · required · nullable  
      The score once the game has started; null before.
      - `home` integer · required  
        Home.
      - `away` integer · required  
        Away.
    - `period` string · required · nullable  
      The period while live or once final, as the score feed says it (Q2, 3rd, Top 5th).
    - `clock` string · required · nullable  
      The game clock while live, e.g. 6:41.
  - `pick_ids` array of string · required  
    Its picks in data, in data's order.
  - `consensus` array of object · required  
    Per market (spread, total, moneyline), each side's pick count; never a rating.
    - `market` string · required  
      spread, total or moneyline.  
      One of: `spread`, `total`, `moneyline` (open: new values may be added).
    - `sides` array of object · required  
      Sides by count, most first.
      - `side` string · required  
        home, away, over, under, yes, no or draw.  
        One of: `home`, `away`, `over`, `under`, `yes`, `no`, `draw` (open: new values may be added).
      - `label` string · required  
        The team's name, or Over, Under, …
      - `count` integer · required  
        Picks on this side in this list.
    - `split` boolean · required  
      True when picks are on more than one side.
  - `split` boolean · required  
    True when any market's picks are on more than one side.
  - `public` null  
    With include=public: the public's bet and money shares per market and side. Null: Kelly has no licensed source of them yet.
- `records` array of object  
  With group=game: each analyst on the page with their record from live picks over the last 90 days of games. Beside their picks, never a ranking.
  - `analyst` object · required  
    Whose record.
    - `id` string · required  
      The analyst's ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required · nullable  
      The analyst's, show's or outlet's name.
  - `days` integer · required  
    The window's length in days of games (90).
  - `from` string · required  
    The window's first game date (New York).  
    format date
  - `to` string · required  
    The window's last game date (New York).  
    format date
  - `picks` integer · required  
    Picks graded win, loss or push in the window.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1; null with none.
  - `units` number · required · nullable  
    Units won at the stated price, or −110 when none was stated; null with no priced pick.
  - `roi` number · required · nullable  
    Units won over units risked; null with none risked.
  - `units_stated_only` number · required · nullable  
    Units won on the picks with a stated price only; null with none.
  - `priced_picks` integer · required  
    Decided picks with a price (stated, or −110 assumed for a spread or total).
  - `stated_price_picks` integer · required  
    Decided picks with a price the analyst stated.
  - `assumed_price_picks` integer · required  
    Decided spreads and totals graded at −110 because no price was stated.
  - `average_price` integer · required · nullable  
    The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
  - `clv_points` number · required · nullable  
    Mean closing-line value in points (+ is better than the close); null with no close.
  - `clv_points_picks` integer · required  
    Decided picks with a closing line.
  - `clv_prob` number · required · nullable  
    Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
  - `clv_prob_picks` integer · required  
    Decided picks with a closing price at the same line.
  - `no_edge_match_prob` number · required · nullable  
    How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
  - `e_value` number · required · nullable  
    The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
  - `units_at_stated` number · required · nullable  
    Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
  - `roi_at_stated` number · required · nullable  
    Units won at stated stakes over units risked at stated stakes; null with none risked.
  - `stated_units_picks` integer · required  
    Decided, priced picks with a stake the analyst stated in units.
  - `late` integer · required  
    Picks left out because they were said after the start.
  - `void` integer · required  
    Picks void (a cancelled game, a player who did not play).
  - `ungraded` integer · required  
    Picks Kelly could not grade (futures, parlays, a line or side not stated).
  - `open` integer · required  
    Picks published on games in the window, not settled yet.
  - `removed` integer · required  
    Picks Kelly removed as extraction errors, ever (the removals rule).
  - `by_firmness` object · required  
    The record for each firmness: official, lean, mention.
    - `official` object · required  
      The same record for one firmness.
      - `picks` integer · required  
        Picks graded win, loss or push in the window.
      - `wins` integer · required  
        Wins.
      - `losses` integer · required  
        Losses.
      - `pushes` integer · required  
        Pushes.
      - `win_rate` number · required · nullable  
        Wins over wins and losses, 0–1; null with none.
      - `units` number · required · nullable  
        Units won at the stated price, or −110 when none was stated; null with no priced pick.
      - `roi` number · required · nullable  
        Units won over units risked; null with none risked.
      - `units_stated_only` number · required · nullable  
        Units won on the picks with a stated price only; null with none.
      - `priced_picks` integer · required  
        Decided picks with a price (stated, or −110 assumed for a spread or total).
      - `stated_price_picks` integer · required  
        Decided picks with a price the analyst stated.
      - `assumed_price_picks` integer · required  
        Decided spreads and totals graded at −110 because no price was stated.
      - `average_price` integer · required · nullable  
        The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
      - `clv_points` number · required · nullable  
        Mean closing-line value in points (+ is better than the close); null with no close.
      - `clv_points_picks` integer · required  
        Decided picks with a closing line.
      - `clv_prob` number · required · nullable  
        Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
      - `clv_prob_picks` integer · required  
        Decided picks with a closing price at the same line.
      - `no_edge_match_prob` number · required · nullable  
        How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
      - `e_value` number · required · nullable  
        The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
      - `units_at_stated` number · required · nullable  
        Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
      - `roi_at_stated` number · required · nullable  
        Units won at stated stakes over units risked at stated stakes; null with none risked.
      - `stated_units_picks` integer · required  
        Decided, priced picks with a stake the analyst stated in units.
      - `late` integer · required  
        Picks left out because they were said after the start.
      - `void` integer · required  
        Picks void (a cancelled game, a player who did not play).
      - `ungraded` integer · required  
        Picks Kelly could not grade (futures, parlays, a line or side not stated).
    - `lean` object · required  
      The same record for one firmness.
      - `picks` integer · required  
        Picks graded win, loss or push in the window.
      - `wins` integer · required  
        Wins.
      - `losses` integer · required  
        Losses.
      - `pushes` integer · required  
        Pushes.
      - `win_rate` number · required · nullable  
        Wins over wins and losses, 0–1; null with none.
      - `units` number · required · nullable  
        Units won at the stated price, or −110 when none was stated; null with no priced pick.
      - `roi` number · required · nullable  
        Units won over units risked; null with none risked.
      - `units_stated_only` number · required · nullable  
        Units won on the picks with a stated price only; null with none.
      - `priced_picks` integer · required  
        Decided picks with a price (stated, or −110 assumed for a spread or total).
      - `stated_price_picks` integer · required  
        Decided picks with a price the analyst stated.
      - `assumed_price_picks` integer · required  
        Decided spreads and totals graded at −110 because no price was stated.
      - `average_price` integer · required · nullable  
        The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
      - `clv_points` number · required · nullable  
        Mean closing-line value in points (+ is better than the close); null with no close.
      - `clv_points_picks` integer · required  
        Decided picks with a closing line.
      - `clv_prob` number · required · nullable  
        Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
      - `clv_prob_picks` integer · required  
        Decided picks with a closing price at the same line.
      - `no_edge_match_prob` number · required · nullable  
        How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
      - `e_value` number · required · nullable  
        The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
      - `units_at_stated` number · required · nullable  
        Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
      - `roi_at_stated` number · required · nullable  
        Units won at stated stakes over units risked at stated stakes; null with none risked.
      - `stated_units_picks` integer · required  
        Decided, priced picks with a stake the analyst stated in units.
      - `late` integer · required  
        Picks left out because they were said after the start.
      - `void` integer · required  
        Picks void (a cancelled game, a player who did not play).
      - `ungraded` integer · required  
        Picks Kelly could not grade (futures, parlays, a line or side not stated).
    - `mention` object · required  
      The same record for one firmness.
      - `picks` integer · required  
        Picks graded win, loss or push in the window.
      - `wins` integer · required  
        Wins.
      - `losses` integer · required  
        Losses.
      - `pushes` integer · required  
        Pushes.
      - `win_rate` number · required · nullable  
        Wins over wins and losses, 0–1; null with none.
      - `units` number · required · nullable  
        Units won at the stated price, or −110 when none was stated; null with no priced pick.
      - `roi` number · required · nullable  
        Units won over units risked; null with none risked.
      - `units_stated_only` number · required · nullable  
        Units won on the picks with a stated price only; null with none.
      - `priced_picks` integer · required  
        Decided picks with a price (stated, or −110 assumed for a spread or total).
      - `stated_price_picks` integer · required  
        Decided picks with a price the analyst stated.
      - `assumed_price_picks` integer · required  
        Decided spreads and totals graded at −110 because no price was stated.
      - `average_price` integer · required · nullable  
        The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
      - `clv_points` number · required · nullable  
        Mean closing-line value in points (+ is better than the close); null with no close.
      - `clv_points_picks` integer · required  
        Decided picks with a closing line.
      - `clv_prob` number · required · nullable  
        Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
      - `clv_prob_picks` integer · required  
        Decided picks with a closing price at the same line.
      - `no_edge_match_prob` number · required · nullable  
        How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
      - `e_value` number · required · nullable  
        The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
      - `units_at_stated` number · required · nullable  
        Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
      - `roi_at_stated` number · required · nullable  
        Units won at stated stakes over units risked at stated stakes; null with none risked.
      - `stated_units_picks` integer · required  
        Decided, priced picks with a stake the analyst stated in units.
      - `late` integer · required  
        Picks left out because they were said after the start.
      - `void` integer · required  
        Picks void (a cancelled game, a player who did not play).
      - `ungraded` integer · required  
        Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `totals` object  
  With totals=true: the record of every pick the filters keep, not only this page (1 unit a pick, at the stated price or −110). It describes the slice; it never ranks.
  - `picks` integer · required  
    Picks the filters keep.
  - `graded` integer · required  
    Of them, graded win, loss or push.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1.
  - `units` number · required · nullable  
    Units won.
  - `units_risked` number · required  
    Units risked on priced, decided picks.
  - `roi` number · required · nullable  
    Units won over units risked.
  - `units_stated_only` number · required · nullable  
    Units won on picks with a stated price.
  - `priced_picks` integer · required  
    Decided picks with a price.
  - `stated_price_picks` integer · required  
    Of them, the price was stated.
  - `assumed_price_picks` integer · required  
    Of them, −110 was assumed.
  - `average_price_american` number · required · nullable  
    The average price taken, American odds.
  - `clv_points_mean` number · required · nullable  
    Mean closing-line value in points, where the close is known.
  - `clv_points_picks` integer · required  
    Picks with a closing-line value.
  - `open` integer · required  
    Picks not graded yet.
  - `void` integer · required  
    Void picks.
  - `late` integer · required  
    Picks said after the start.
  - `no_skill_match_prob` number · required · nullable  
    How often a bettor with no edge matches this record at these prices.
  - `first_date` string · required · nullable  
    The first game date.  
    format date
  - `last_date` string · required · nullable  
    The last game date.  
    format date
- `notice` string · required  
  What the picks are and are not: as stated, credited and linked, never rated or ranked.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/analyst-picks?date=2026-10-04&basis=said&include=grade,fair&totals=true
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_pick_list",
  "data": [
    {
      "id": "apck_samp1estakesamp1e000",
      "object": "analyst_pick",
      "analyst": {
        "id": "anl_samp1eana1ystsamp1e0",
        "name": "Sample Analyst",
        "kind": "person"
      },
      "stated_by": "Sample Analyst",
      "outlet": null,
      "show": null,
      "sport": "nfl",
      "event": "Chiefs at Raiders",
      "game": null,
      "market": {
        "id": null,
        "kind": "spread"
      },
      "selection": "Chiefs -3",
      "side": "away",
      "label": "Chiefs -3",
      "stat": null,
      "team_id": null,
      "player_id": null,
      "line": -3,
      "line_text": "-3",
      "price_american": -110,
      "units": null,
      "firmness": "official",
      "series": null,
      "said_in": {
        "kind": "video",
        "title": "Sample Sunday picks",
        "url": "https://www.youtube.com/watch?v=sample00001&t=754s",
        "published_at": "2026-10-04T17:30:00+00:00",
        "moment_seconds": 754,
        "channel": {
          "name": "Sample Analyst Show",
          "url": "https://www.youtube.com/@sampleanalyst",
          "kind": "youtube"
        },
        "platform": "youtube"
      },
      "said_at": "2026-10-04T17:30:00+00:00",
      "released_at": "2026-10-04T17:30:00+00:00",
      "reported_at": "2026-10-04T17:30:00+00:00",
      "corrects": null,
      "grade": null,
      "graded": null,
      "fair": null
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "totals": {
    "picks": 1,
    "graded": 0,
    "wins": 0,
    "losses": 0,
    "pushes": 0,
    "win_rate": null,
    "units": null,
    "units_risked": 0,
    "roi": null,
    "units_stated_only": null,
    "priced_picks": 0,
    "stated_price_picks": 0,
    "assumed_price_picks": 0,
    "average_price_american": null,
    "clv_points_mean": null,
    "clv_points_picks": 0,
    "open": 1,
    "void": 0,
    "late": 0,
    "no_skill_match_prob": null,
    "first_date": null,
    "last_date": null
  },
  "notice": "Picks as the analysts stated them in public content, with links to the source. Kelly reports them; it does not rate, rank or recommend any pick or analyst. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00+00:00",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_ef6226eacfd046a3b1ebbccd",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00+00:00 · Picks as stated by the analysts named, with links to the sources

```http
GET https://api.askkelly.ai/v1/analyst-picks?sport=nfl&limit=5
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_pick_list",
  "data": [
    {
      "id": "apck_samp1estakesamp1e000",
      "object": "analyst_pick",
      "analyst": {
        "id": "anl_samp1eana1ystsamp1e0",
        "name": "Sample Analyst",
        "kind": "person"
      },
      "stated_by": "Sample Analyst",
      "outlet": null,
      "show": null,
      "sport": "nfl",
      "event": "Chiefs at Raiders",
      "game": null,
      "market": {
        "id": null,
        "kind": "spread"
      },
      "selection": "Chiefs -3",
      "side": "away",
      "label": "Chiefs -3",
      "stat": null,
      "team_id": null,
      "player_id": null,
      "line": -3,
      "line_text": "-3",
      "price_american": -110,
      "units": null,
      "firmness": "official",
      "series": null,
      "said_in": {
        "kind": "video",
        "title": "Sample Sunday picks",
        "url": "https://www.youtube.com/watch?v=sample00001&t=754s",
        "published_at": "2026-10-04T17:30:00+00:00",
        "moment_seconds": 754,
        "channel": {
          "name": "Sample Analyst Show",
          "url": "https://www.youtube.com/@sampleanalyst",
          "kind": "youtube"
        },
        "platform": "youtube"
      },
      "said_at": "2026-10-04T17:30:00+00:00",
      "released_at": "2026-10-04T17:30:00+00:00",
      "reported_at": "2026-10-04T17:30:00+00:00",
      "corrects": null
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "notice": "Picks as the analysts stated them in public content, with links to the source. Kelly reports them; it does not rate, rank or recommend any pick or analyst. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00+00:00",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_2e7f9f974dabb13fbf816dbf",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00+00:00 · Picks as stated by the analysts named, with links to the sources

```http
GET https://api.askkelly.ai/v1/analyst-picks
```

```json
{
  "type": "https://docs.askkelly.ai/problems/unauthenticated",
  "title": "Authentication required",
  "status": 401,
  "code": "unauthenticated",
  "detail": "Credentials are missing, expired or invalid. Send an API key or OAuth token in the Authorization header.",
  "param": null,
  "doc_url": "https://docs.askkelly.ai/problems/unauthenticated",
  "request_id": "req_4358f2c773da963aad035956",
  "retryable": false,
  "display_message": "Please sign in to continue."
}
```

`GET /v1/analyst-picks/days`

## Count analysts' picks by day
scope `read:odds` · 1 credit, not charged during the beta · status live

How many published picks fall on each local day from `from` to `to` (seven days around today by default), by the game's day, the day said or the day Kelly reported them, with each day's count per sport: the counts a day strip or range picker shows.

### Parameters
- `from` string · query  
  The first day (seven days around date or today by default).  
  format date
- `to` string · query  
  The last day, at most 400 days on.  
  format date
- `date` string · query  
  The middle of the default seven days.  
  format date
- `tz` string · query  
  The days' IANA zone; default America/New_York.  
  min length 1 · max length 64
- `basis` string · query  
  game (default), said or reported.  
  One of: `game`, `said`, `reported` (open: new values may be added).
- `analyst` string · query  
  Only this analyst's picks (anl_…).  
  pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
- `sport` string · query  
  Only this sport, e.g. nfl.  
  pattern ^[a-z]{2,10}$
- `market` string · query  
  Only picks on this kind of market.  
  One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
- `firmness` string · query  
  official, lean, mention, comma-separated.  
  min length 1 · max length 40
- `following` boolean · query  
  true: count only picks from what your account follows.

### Response
`200` The days and their counts.

- `object` const · required  
  Always analyst_pick_days.  
  Always `"analyst_pick_days"`.
- `timezone` string · required  
  The days' zone.
- `basis` string · required  
  Which day a pick falls on: its game's (game), the day said, or the day Kelly reported it.  
  One of: `game`, `said`, `reported` (open: new values may be added).
- `today` string · required  
  Today in the zone.  
  format date
- `from` string · required  
  The first day.  
  format date
- `to` string · required  
  The last day.  
  format date
- `days` array of object · required  
  Every day, in order.
  - `date` string · required  
    The day.  
    format date
  - `picks` integer · required  
    Picks on it.
  - `sports` object · required  
    Picks on it per sport (nfl, ncaaf, …).
- `notice` string · required  
  What the picks are and are not: as stated, credited and linked, never rated or ranked.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/analyst-picks/days?date=2026-10-04&basis=said
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_pick_days",
  "timezone": "America/New_York",
  "basis": "said",
  "today": "2026-10-04",
  "from": "2026-10-01",
  "to": "2026-10-07",
  "days": [
    {
      "date": "2026-10-01",
      "picks": 0,
      "sports": {}
    },
    {
      "date": "2026-10-02",
      "picks": 0,
      "sports": {}
    },
    {
      "date": "2026-10-03",
      "picks": 0,
      "sports": {}
    },
    {
      "date": "2026-10-04",
      "picks": 1,
      "sports": {
        "nfl": 1
      }
    },
    {
      "date": "2026-10-05",
      "picks": 0,
      "sports": {}
    },
    {
      "date": "2026-10-06",
      "picks": 0,
      "sports": {}
    },
    {
      "date": "2026-10-07",
      "picks": 0,
      "sports": {}
    }
  ],
  "notice": "Picks as the analysts stated them in public content, with links to the source. Kelly reports them; it does not rate, rank or recommend any pick or analyst. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_a0c38f8567d1e01200580882",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00Z · Picks as stated by the analysts named, with links to the sources

`GET /v1/analyst-picks/{pick_id}`

## Get one analyst pick
scope `read:odds` · 1 credit, not charged during the beta · MCP tool `get_analyst_pick` · status live

One published pick, as list_analyst_picks returns it. A removed or corrected pick is not_found; its correction names it in corrects.

### Parameters
- `pick_id` string · path · required  
  The pick's ID (apck_…).  
  pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$

### Response
`200` The pick.

- `object` const · required  
  Always analyst_pick.  
  Always `"analyst_pick"`.
- `id` string · required  
  The pick's ID (apck_…).  
  pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$
- `analyst` object · required  
  Who the pick is credited to.
  - `id` string · required  
    The analyst's ID (anl_…).  
    pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
  - `name` string · required  
    The analyst's, show's or outlet's name.
  - `kind` string · required  
    person, show or outlet: a show or outlet is credited when the person who said it is not one Kelly follows (stated_by names them).  
    One of: `person`, `show`, `outlet` (open: new values may be added).
- `stated_by` string · required  
  Who said it, as named in the source.
- `outlet` object · required · nullable  
  The outlet or show the pick was published on, when that is not who it is credited to: the pick counts for both records. Null otherwise.
  - `id` string · required  
    The outlet's or show's analyst ID (anl_…).  
    pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
  - `name` string · required  
    The outlet's or show's name.
  - `kind` string · required  
    outlet or show.  
    One of: `outlet`, `show` (open: new values may be added).
- `show` object · required · nullable  
  The show it was said on, when an outlet carries that show and the show is not who it is credited to: the pick counts for the show too. Null otherwise.
  - `id` string · required  
    The show's analyst ID (anl_…).  
    pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
  - `name` string · required  
    The show's name.
- `sport` string · required · nullable  
  The sport, e.g. nfl.
- `event` string · required  
  The game or event as said.
- `game` object · required · nullable  
  Kelly's game when the pick was matched to one, else null.
  - `id` string · required  
    The game's ID (gm_…).  
    pattern ^gm_[0-9a-hjkmnp-tv-z]{20}$
  - `name` string · required · nullable  
    The game's name.
  - `start_time` string · required  
    The scheduled start.  
    format date-time
- `market` object · required  
  The market as said, and Kelly's market when matched.
  - `id` string · required · nullable  
    Kelly's market ID (mkt_…), or null.
  - `kind` string · required  
    spread, total, moneyline, prop, future, parlay or other.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
- `selection` string · required  
  The side as said, e.g. Steelers +3.
- `label` string · required  
  The pick in plain words, built from the market, side, stated line and the team or player named: Over 5.5 goals, Cameron Boozer over 8.5 rebounds, Minnesota Wild moneyline. The price is not in it.
- `stat` string · required · nullable  
  A prop's stat as said (rebounds, passing yards) or what a game total counts (points, goals, runs); null for other markets.
- `side` string · required · nullable  
  home, away, over, under, yes, no or draw; null when not stated.  
  One of: `home`, `away`, `over`, `under`, `yes`, `no`, `draw` (open: new values may be added).
- `team_id` string · required · nullable  
  The team picked (tm_…), when matched.
- `player_id` string · required · nullable  
  The player picked (plr_…), when matched.
- `line` number · required · nullable  
  The line as stated; never computed.
- `line_text` string · required · nullable  
  The line as written: +3, pk, 44.5.
- `price_american` integer · required · nullable  
  The price as stated, American odds.
- `units` number · nullable  
  The stake as stated, in units ('2u', 'half a unit'); null when none was stated (never inferred from how strongly the pick was put).
- `firmness` string · required  
  official, lean or mention: how firmly it was put.  
  One of: `official`, `lean`, `mention` (open: new values may be added).
- `series` string · nullable  
  The named set of picks it was given in, as the source names it (Road to 272, Teaser of the Week); null when none was named. Each series has its own record.
- `said_in` object · required  
  Where it was said.
  - `kind` string · required  
    episode, video, article or post.  
    One of: `episode`, `video`, `article`, `post` (open: new values may be added).
  - `title` string · required  
    The item's title.
  - `url` string · required  
    The item's public link, at the moment it was said when known.  
    format uri
  - `published_at` string · required  
    When the item was published.  
    format date-time
  - `moment_seconds` integer · required · nullable  
    Seconds into the show, when known.
  - `channel` object · required  
    The channel the item was published on.
    - `name` string · required · nullable  
      The channel's name.
    - `url` string · required  
      The channel's public page.  
      format uri
    - `kind` string · required  
      youtube, podcast, rss, web, x, tiktok, instagram or threads.  
      One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
  - `platform` string · required  
    The platform it was said on, for its icon: x, youtube, podcast, tiktok, instagram, threads, discord, reddit, newsletter, video (elsewhere) or article.  
    One of: `x`, `youtube`, `podcast`, `tiktok`, `instagram`, `threads`, `discord`, `reddit`, `newsletter`, `video`, `article` (open: new values may be added).
- `said_at` string · required  
  When the pick was said in public: its source's publish time (ADR-K247).  
  format date-time
- `released_at` string · required  
  When its source was released (the same time as said_at until Kelly knows a recording time).  
  format date-time
- `reported_at` string · required  
  When Kelly published the pick.  
  format date-time
- `corrects` string · required · nullable  
  The pick this one corrects (apck_…), or null.
- `withdrawn` object  
  Only on a pick its analyst dropped before the game started, or replaced at a new line: when and where they dropped it. It is not graded and is on no list or count; the analyst's profile and the pick's own page show it.
  - `at` string · required  
    When it was dropped: the publish time of the item it was dropped in.  
    format date-time
  - `said_in` object · required  
    Where it was dropped.
    - `kind` string · required  
      episode, video, article or post.  
      One of: `episode`, `video`, `article`, `post` (open: new values may be added).
    - `title` string · required  
      The item's title.
    - `url` string · required  
      The item's public link.  
      format uri
    - `published_at` string · required  
      When the item was published.  
      format date-time
    - `channel` object · required  
      The channel the item was published on.
      - `name` string · required · nullable  
        The channel's name.
      - `url` string · required  
        The channel's public page.  
        format uri
      - `kind` string · required  
        youtube, podcast, rss, web, x, tiktok, instagram or threads.  
        One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
    - `platform` string · required  
      The platform it was said on, for its icon: x, youtube, podcast, tiktok, instagram, threads, discord, reddit, newsletter, video (elsewhere) or article.  
      One of: `x`, `youtube`, `podcast`, `tiktok`, `instagram`, `threads`, `discord`, `reddit`, `newsletter`, `video`, `article` (open: new values may be added).
- `detail` object  
  With include=detail (ADR-K254): pick (the picks card's shape, with label, now, move, out, close, grade and fair), summary (Kelly's own summary of where it was said, never a quote, or null), analyst (id, name, channels, sports), record (the last 90 days, or null), groups (the show and outlet it was published on when not who it is credited to, each with id, name, kind and its record), game (state, score, teams, consensus, or null), others (the game's other picks) and url (the pick's page).
- `share` object · required  
  How to share the pick: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
  - `url` string · required  
    The link to the pick's page.  
    format uri
  - `image` string · required  
    The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
    format uri
  - `title` string · required  
    The title the link carries.
  - `text` string · required  
    A message ready to send: the title, then the link.
- `notice` string · required  
  What the picks are and are not: as stated, credited and linked, never rated or ranked.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/analyst-picks/apck_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "type": "https://docs.askkelly.ai/problems/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "No published analyst pick has that ID.",
  "param": "pick_id",
  "doc_url": "https://docs.askkelly.ai/problems/not_found",
  "request_id": "req_ff19460b8cdc5a113ab62eab",
  "retryable": false,
  "display_message": "That could not be found."
}
```

```http
GET https://api.askkelly.ai/v1/analyst-picks/apck_samp1estakesamp1e000
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_pick",
  "id": "apck_samp1estakesamp1e000",
  "analyst": {
    "id": "anl_samp1eana1ystsamp1e0",
    "name": "Sample Analyst",
    "kind": "person"
  },
  "stated_by": "Sample Analyst",
  "outlet": null,
  "show": null,
  "sport": "nfl",
  "event": "Chiefs at Raiders",
  "game": null,
  "market": {
    "id": null,
    "kind": "spread"
  },
  "selection": "Chiefs -3",
  "side": "away",
  "label": "Chiefs -3",
  "stat": null,
  "team_id": null,
  "player_id": null,
  "line": -3,
  "line_text": "-3",
  "price_american": -110,
  "units": null,
  "firmness": "official",
  "series": null,
  "said_in": {
    "kind": "video",
    "title": "Sample Sunday picks",
    "url": "https://www.youtube.com/watch?v=sample00001&t=754s",
    "published_at": "2026-10-04T17:30:00+00:00",
    "moment_seconds": 754,
    "channel": {
      "name": "Sample Analyst Show",
      "url": "https://www.youtube.com/@sampleanalyst",
      "kind": "youtube"
    },
    "platform": "youtube"
  },
  "said_at": "2026-10-04T17:30:00+00:00",
  "released_at": "2026-10-04T17:30:00+00:00",
  "reported_at": "2026-10-04T17:30:00+00:00",
  "corrects": null,
  "share": {
    "url": "https://askkelly.ai/picks/p/apck_samp1estakesamp1e000",
    "image": "https://askkelly.ai/picks/p/apck_samp1estakesamp1e000/opengraph-image",
    "title": "Chiefs -3 (−110) · Sample Analyst",
    "text": "Chiefs -3 (−110) · Sample Analyst https://askkelly.ai/picks/p/apck_samp1estakesamp1e000"
  },
  "notice": "Picks as the analysts stated them in public content, with links to the source. Kelly reports them; it does not rate, rank or recommend any pick or analyst. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00+00:00",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_c7f531a0a4b1348544dc3b7d",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00+00:00 · Picks as stated by the analysts named, with links to the sources

`POST /v1/analyst-picks/{pick_id}/report`

## Report a wrong analyst pick
scope `read:odds` · 0 credits, not charged during the beta · MCP tool `report_analyst_pick` · status live

Tells Kelly a published pick is wrong: not what was said, the wrong line, price, game or analyst, never stated as a pick, or the same pick twice, with an optional note. It goes to Kelly's review queue, and the same open report from one account is kept once. Free (ADR-K251).

### Parameters
- `pick_id` string · path · required  
  The pick's ID (apck_…).  
  pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$

Body, `application/json` (required):

- `reason` string  
  wrong_pick: the selection isn't what was said; wrong_line or wrong_price: the number is off; wrong_game: matched to the wrong game; wrong_analyst: credited to the wrong person; not_a_pick: it was never stated as a pick; duplicate: the same pick twice.  
  One of: `wrong_pick`, `wrong_line`, `wrong_price`, `wrong_game`, `wrong_analyst`, `not_a_pick`, `duplicate` (open: new values may be added).
- `note` string  
  What you heard, in your words; it stays with Kelly's review queue.  
  max length 500

### Response
`202` The report is in the review queue.

- `object` const · required  
  Always analyst_pick_report.  
  Always `"analyst_pick_report"`.
- `pick_id` string · required  
  The pick reported.  
  pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$
- `reason` string · required  
  What is wrong, as sent.  
  One of: `wrong_pick`, `wrong_line`, `wrong_price`, `wrong_game`, `wrong_analyst`, `not_a_pick`, `duplicate` (open: new values may be added).
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found)

### Example
```http
POST https://api.askkelly.ai/v1/analyst-picks/apck_samp1estakesamp1e000/report
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{
  "reason": "wrong_line",
  "note": "The show said -2.5, not -3."
}
```

```json
{
  "object": "analyst_pick_report",
  "pick_id": "apck_samp1estakesamp1e000",
  "reason": "wrong_line",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "kelly",
  "attribution": null,
  "request_id": "req_04bd79d0319b49817a6b7551",
  "live_topics": [],
  "rg_line": null
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T17:30:00Z

```http
POST https://api.askkelly.ai/v1/analyst-picks/apck_samp1estakesamp1e000/report
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{
  "reason": "bad_beat"
}
```

```json
{
  "type": "https://docs.askkelly.ai/problems/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "reason must be one of wrong_pick, wrong_line, wrong_price, wrong_game, wrong_analyst, not_a_pick, duplicate.",
  "param": "reason",
  "doc_url": "https://docs.askkelly.ai/problems/invalid_request",
  "request_id": "req_cdef049188c46d85cb6a95c5",
  "retryable": false,
  "display_message": "Something in that request was not understood."
}
```

`GET /v1/analysts`

## List the analysts Kelly follows
scope `read:odds` · 1 credit, not charged during the beta · status live

The analysts, shows and outlets whose public picks Kelly reports, alphabetical, with their public channels. Never ordered by a record.

### Parameters
- `q` string · query  
  Part of a name or alias.  
  min length 1 · max length 80
- `followed` string · query  
  Only these: seed, or heard (the live list of speakers Kelly follows because it heard them state picks).  
  One of: `seed`, `heard` (open: new values may be added).
- `limit` integer · query  
  Analysts to return; default 50.  
  min 1 · max 200

### Response
`200` The analysts, alphabetical.

- `object` const · required  
  Always analyst_list.  
  Always `"analyst_list"`.
- `data` array of object · required  
  The analysts, alphabetical.
  - `id` string · required  
    The analyst's ID (anl_…).  
    pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
  - `object` const · required  
    Always analyst.  
    Always `"analyst"`.
  - `name` string · required  
    The name.
  - `kind` string · required  
    person, show or outlet.  
    One of: `person`, `show`, `outlet` (open: new values may be added).
  - `channels` array of object · required  
    Its active channels.
    - `name` string · required · nullable  
      The channel's name.
    - `url` string · required  
      Its public page.  
      format uri
    - `kind` string · required  
      youtube, podcast, rss, web, x, tiktok, instagram or threads.  
      One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
  - `followed` string · required  
    Why Kelly follows it: seed (chosen by research or by hand) or heard (Kelly heard them state picks on a channel it watches, and follows them since).  
    One of: `seed`, `heard` (open: new values may be added).
  - `heard_at` string · required · nullable  
    When Kelly first heard a heard speaker state a pick; null for seed.  
    format date-time
  - `image` object · nullable  
    Its picture, or null: the show's podcast or YouTube artwork, the outlet's own site icon or the analyst's own X picture, as a square WebP served from Kelly's API host. Draw the name's initials where null.
    - `url` string · required  
      The picture's URL on Kelly's API host; its `v` changes with the picture.  
      format uri
    - `source` string · required  
      Where it came from.  
      One of: `override`, `podcast`, `apple`, `youtube`, `site`, `x` (open: new values may be added).
- `has_more` boolean · required  
  True when more analysts match than limit (narrow with q or followed).
- `next_cursor` string · required · nullable  
  Always null.
- `notice` string · required  
  What the picks are and are not: as stated, credited and linked, never rated or ranked.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/analysts?q=sample
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_list",
  "data": [
    {
      "id": "anl_samp1eana1ystsamp1e0",
      "object": "analyst",
      "name": "Sample Analyst",
      "kind": "person",
      "channels": [],
      "followed": "seed",
      "heard_at": null,
      "image": null
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "notice": "Picks as the analysts stated them in public content, with links to the source. Kelly reports them; it does not rate, rank or recommend any pick or analyst. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_85c49d3e1d2416bfa18bfc29",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00Z · Picks as stated by the analysts named, with links to the sources

`GET /v1/analysts/leaderboard`

## Rank the analysts by their graded picks
scope `read:odds` · 2 credits, not charged during the beta · MCP tool `get_analyst_leaderboard` · status live

Every analyst Kelly follows, ranked by the record of their graded picks over the last 30 days of games (or days, or since to until), live picks only unless origin=all: W-L-P, win rate, units and ROI at the stated or assumed -110 price, units at stated prices only, the average price, closing-line value, the luck read and every pick left out, open or removed. Ranked rows need min_picks priced, decided picks (100 by default) and say whether the record beats the market so far or is too early to tell (e-BH across the board); the rest follow by name. Built once per settle.

### Parameters
- `days` integer · query  
  The last N days of games to today (New York); default 30. Not with since or until.  
  min 1 · max 3650
- `since` string · query  
  A range's first game day.  
  format date
- `until` string · query  
  A range's last game day.  
  format date
- `origin` string · query  
  live (default): picks Kelly published as they were said; all: with the back catalogue.  
  One of: `live`, `all` (open: new values may be added).
- `sport` string · query  
  Only these sports, comma-separated (nfl,ncaaf).  
  min length 1 · max length 80
- `market` string · query  
  Only these markets, comma-separated.  
  min length 1 · max length 80
- `firmness` string · query  
  official, lean, mention, comma-separated.  
  min length 1 · max length 40
- `sort` string · query  
  units (default), roi, win_rate, clv or picks.  
  One of: `units`, `roi`, `win_rate`, `clv`, `picks` (open: new values may be added).
- `min_picks` integer · query  
  The bar to be ranked: priced, decided picks; default 100.  
  min 1 · max 10000
- `limit` integer · query  
  Rows of each list; default 100.  
  min 1 · max 200
- `kind` string · query  
  Only these analysts, ranked among themselves: person (individuals), show, outlet, comma-separated (show,outlet for shows and outlets).  
  min length 1 · max length 40

### Response
`200` The board.

- `object` const · required  
  Always analyst_leaderboard.  
  Always `"analyst_leaderboard"`.
- `window` object · required  
  The game days read (New York).
  - `days` integer · required · nullable  
    The window's length in days of games; null for a range.
  - `from` string · required · nullable  
    The first game date; null when open.  
    format date
  - `to` string · required · nullable  
    The last game date; null when open.  
    format date
- `origins` array of string · required  
  Which picks count: live (published as they were said), and backfill (the back catalogue, read later) with origin=all.
- `sports` array of string · required  
  The sports kept; empty for every sport.
- `markets` array of string · required  
  The markets kept; empty for every market.
- `firmness` array of string · required  
  The firmness kept; empty for all.
- `kinds` array of string · required  
  The kinds of analyst kept (kind); empty for all. The ranks, the bar and the labels are read among them alone.
- `sort` string · required  
  What the ranked rows are ordered by.  
  One of: `units`, `roi`, `win_rate`, `clv`, `picks` (open: new values may be added).
- `min_picks` integer · required  
  The bar: priced, decided picks to be ranked.
- `alpha` number · required  
  The e-BH level the labels are read at.
- `ranked` array of object · required  
  The analysts over the bar, by sort; ties by name.
  - `rank` integer · required · nullable  
    Their place by sort, from 1; null under the bar.
  - `analyst` object · required  
    Who.
    - `id` string · required  
      The analyst's ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The analyst's, show's or outlet's name.
    - `followed` string · required  
      seed, or heard: Kelly started following after hearing them state picks.  
      One of: `seed`, `heard` (open: new values may be added).
    - `kind` string · required  
      person, show or outlet.  
      One of: `person`, `show`, `outlet` (open: new values may be added).
    - `image` object · nullable  
      Its picture, or null: the show's podcast or YouTube artwork, the outlet's own site icon or the analyst's own X picture, as a square WebP served from Kelly's API host. Draw the name's initials where null.
      - `url` string · required  
        The picture's URL on Kelly's API host; its `v` changes with the picture.  
        format uri
      - `source` string · required  
        Where it came from.  
        One of: `override`, `podcast`, `apple`, `youtube`, `site`, `x` (open: new values may be added).
  - `label` string · required  
    beats the market so far (e-BH across the board at alpha), too early to tell, or not enough picks yet (under the bar).  
    One of: `beats the market so far`, `too early to tell`, `not enough picks yet` (open: new values may be added).
  - `record` object · required  
    Their record in the window: every factor.
    - `open` integer · required  
      Picks published on games in the window (or with no game date yet), not settled yet.
    - `removed` integer · required  
      Picks Kelly removed as extraction errors, ever (the removals rule).
    - `picks` integer · required  
      Picks graded win, loss or push in the window.
    - `wins` integer · required  
      Wins.
    - `losses` integer · required  
      Losses.
    - `pushes` integer · required  
      Pushes.
    - `win_rate` number · required · nullable  
      Wins over wins and losses, 0–1; null with none.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated; null with no priced pick.
    - `roi` number · required · nullable  
      Units won over units risked; null with none risked.
    - `units_stated_only` number · required · nullable  
      Units won on the picks with a stated price only; null with none.
    - `priced_picks` integer · required  
      Decided picks with a price (stated, or −110 assumed for a spread or total).
    - `stated_price_picks` integer · required  
      Decided picks with a price the analyst stated.
    - `assumed_price_picks` integer · required  
      Decided spreads and totals graded at −110 because no price was stated.
    - `average_price` integer · required · nullable  
      The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
    - `clv_points` number · required · nullable  
      Mean closing-line value in points (+ is better than the close); null with no close.
    - `clv_points_picks` integer · required  
      Decided picks with a closing line.
    - `clv_prob` number · required · nullable  
      Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
    - `clv_prob_picks` integer · required  
      Decided picks with a closing price at the same line.
    - `no_edge_match_prob` number · required · nullable  
      How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
    - `e_value` number · required · nullable  
      The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
    - `units_at_stated` number · required · nullable  
      Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
    - `roi_at_stated` number · required · nullable  
      Units won at stated stakes over units risked at stated stakes; null with none risked.
    - `stated_units_picks` integer · required  
      Decided, priced picks with a stake the analyst stated in units.
    - `late` integer · required  
      Picks left out because they were said after the start.
    - `void` integer · required  
      Picks void (a cancelled game, a player who did not play).
    - `ungraded` integer · required  
      Picks Kelly could not grade (futures, parlays, a line or side not stated).
  - `activity` object · required  
    What they are doing now (ADR-K256), read on every request.
    - `channels` array of object · required  
      Their active channels.
      - `name` string · required · nullable  
        The channel's name.
      - `url` string · required · nullable  
        Its public page.
      - `kind` string · required · nullable  
        youtube, podcast, site, x and so on.
    - `sports` array of string · required  
      The competitions of their published picks over the last 90 days, most first.
    - `picks_today` integer · required  
      Their picks said today (New York).
    - `latest_pick` object · required · nullable  
      Their newest published pick.
      - `id` string · required  
        The pick's ID (apck_…).
      - `label` string · required · nullable  
        The pick in plain words.
      - `market` string · required · nullable  
        The market as said.
      - `price_american` integer · required · nullable  
        The price said, American.
      - `said_at` string · required · nullable  
        When its source was published.  
        format date-time
      - `game_id` string · required · nullable  
        Its game (gm_…), or null.
  - `same_as` object · required · nullable  
    The outlet's one show whose picks in the window are exactly the outlet's: listed once, on the outlet's row (Jon, Oct 29, 2026); null otherwise.
    - `id` string · required  
      The show's ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The show's name.
    - `kind` const · required  
      Always show.  
      Always `"show"`.
- `not_enough` array of object · required  
  The analysts under the bar, most graded picks first, then by name, with their records.
  - `rank` integer · required · nullable  
    Their place by sort, from 1; null under the bar.
  - `analyst` object · required  
    Who.
    - `id` string · required  
      The analyst's ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The analyst's, show's or outlet's name.
    - `followed` string · required  
      seed, or heard: Kelly started following after hearing them state picks.  
      One of: `seed`, `heard` (open: new values may be added).
    - `kind` string · required  
      person, show or outlet.  
      One of: `person`, `show`, `outlet` (open: new values may be added).
    - `image` object · nullable  
      Its picture, or null: the show's podcast or YouTube artwork, the outlet's own site icon or the analyst's own X picture, as a square WebP served from Kelly's API host. Draw the name's initials where null.
      - `url` string · required  
        The picture's URL on Kelly's API host; its `v` changes with the picture.  
        format uri
      - `source` string · required  
        Where it came from.  
        One of: `override`, `podcast`, `apple`, `youtube`, `site`, `x` (open: new values may be added).
  - `label` string · required  
    beats the market so far (e-BH across the board at alpha), too early to tell, or not enough picks yet (under the bar).  
    One of: `beats the market so far`, `too early to tell`, `not enough picks yet` (open: new values may be added).
  - `record` object · required  
    Their record in the window: every factor.
    - `open` integer · required  
      Picks published on games in the window (or with no game date yet), not settled yet.
    - `removed` integer · required  
      Picks Kelly removed as extraction errors, ever (the removals rule).
    - `picks` integer · required  
      Picks graded win, loss or push in the window.
    - `wins` integer · required  
      Wins.
    - `losses` integer · required  
      Losses.
    - `pushes` integer · required  
      Pushes.
    - `win_rate` number · required · nullable  
      Wins over wins and losses, 0–1; null with none.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated; null with no priced pick.
    - `roi` number · required · nullable  
      Units won over units risked; null with none risked.
    - `units_stated_only` number · required · nullable  
      Units won on the picks with a stated price only; null with none.
    - `priced_picks` integer · required  
      Decided picks with a price (stated, or −110 assumed for a spread or total).
    - `stated_price_picks` integer · required  
      Decided picks with a price the analyst stated.
    - `assumed_price_picks` integer · required  
      Decided spreads and totals graded at −110 because no price was stated.
    - `average_price` integer · required · nullable  
      The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
    - `clv_points` number · required · nullable  
      Mean closing-line value in points (+ is better than the close); null with no close.
    - `clv_points_picks` integer · required  
      Decided picks with a closing line.
    - `clv_prob` number · required · nullable  
      Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
    - `clv_prob_picks` integer · required  
      Decided picks with a closing price at the same line.
    - `no_edge_match_prob` number · required · nullable  
      How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
    - `e_value` number · required · nullable  
      The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
    - `units_at_stated` number · required · nullable  
      Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
    - `roi_at_stated` number · required · nullable  
      Units won at stated stakes over units risked at stated stakes; null with none risked.
    - `stated_units_picks` integer · required  
      Decided, priced picks with a stake the analyst stated in units.
    - `late` integer · required  
      Picks left out because they were said after the start.
    - `void` integer · required  
      Picks void (a cancelled game, a player who did not play).
    - `ungraded` integer · required  
      Picks Kelly could not grade (futures, parlays, a line or side not stated).
  - `activity` object · required  
    What they are doing now (ADR-K256), read on every request.
    - `channels` array of object · required  
      Their active channels.
      - `name` string · required · nullable  
        The channel's name.
      - `url` string · required · nullable  
        Its public page.
      - `kind` string · required · nullable  
        youtube, podcast, site, x and so on.
    - `sports` array of string · required  
      The competitions of their published picks over the last 90 days, most first.
    - `picks_today` integer · required  
      Their picks said today (New York).
    - `latest_pick` object · required · nullable  
      Their newest published pick.
      - `id` string · required  
        The pick's ID (apck_…).
      - `label` string · required · nullable  
        The pick in plain words.
      - `market` string · required · nullable  
        The market as said.
      - `price_american` integer · required · nullable  
        The price said, American.
      - `said_at` string · required · nullable  
        When its source was published.  
        format date-time
      - `game_id` string · required · nullable  
        Its game (gm_…), or null.
  - `same_as` object · required · nullable  
    The outlet's one show whose picks in the window are exactly the outlet's: listed once, on the outlet's row (Jon, Oct 29, 2026); null otherwise.
    - `id` string · required  
      The show's ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      The show's name.
    - `kind` const · required  
      Always show.  
      Always `"show"`.
- `counts` object · required  
  The whole board's counts, before limit.
  - `ranked` integer · required  
    Analysts over the bar.
  - `not_enough` integer · required  
    Analysts under it.
  - `analysts` integer · required  
    Analysts with a graded pick in the window.
  - `beats_market` integer · required  
    Ranked analysts whose record beats the market so far.
  - `by_kind` object · required  
    Analysts with a graded pick in the window by kind, over the whole board (before kind).
    - `person` integer · required  
      Individuals.
    - `show` integer · required  
      Shows.
    - `outlet` integer · required  
      Outlets.
- `has_more` boolean · required  
  True when ranked or not_enough was cut to limit.
- `notice` string · required  
  What the records are: Kelly's grades of the picks as stated, at the stated price or -110 when none was stated.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/analysts/leaderboard?since=2026-09-01&until=2026-10-31&min_picks=1
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_leaderboard",
  "window": {
    "days": null,
    "from": "2026-09-01",
    "to": "2026-10-31"
  },
  "origins": [
    "live"
  ],
  "sports": [],
  "markets": [],
  "firmness": [],
  "kinds": [],
  "sort": "units",
  "min_picks": 1,
  "alpha": 0.05,
  "ranked": [],
  "not_enough": [],
  "counts": {
    "ranked": 0,
    "not_enough": 0,
    "analysts": 0,
    "beats_market": 0,
    "by_kind": {
      "person": 0,
      "show": 0,
      "outlet": 0
    }
  },
  "has_more": false,
  "notice": "Records from Kelly's grades of the picks the analysts stated in public content, at the stated price or -110 when none was stated. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_a4ae9d6af55a0e0b8c3c7648",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00Z · Picks as stated by the analysts named, with links to the sources

```http
GET https://api.askkelly.ai/v1/analysts/leaderboard?days=7&since=2026-09-01
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "type": "https://docs.askkelly.ai/problems/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "Send days or since and until, not both.",
  "param": "days",
  "doc_url": "https://docs.askkelly.ai/problems/invalid_request",
  "request_id": "req_77fa00817981f65d34e3ca9d",
  "retryable": false,
  "display_message": "Something in that request was not understood."
}
```

`GET /v1/analysts/{analyst_id}`

## Get one analyst and their record
scope `read:odds` · 1 credit, not charged during the beta · MCP tool `get_analyst_record` · status live

One analyst Kelly follows: name, kind and channels, their record in the window with what is open and removed, the record split by firmness, market, sport and series, and their place on the leaderboard with the same filters.

### Parameters
- `analyst_id` string · path · required  
  The analyst's ID (anl_…).  
  pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$

- `days` integer · query  
  The last N days of games to today (New York); default 30. Not with since or until.  
  min 1 · max 3650
- `since` string · query  
  A range's first game day.  
  format date
- `until` string · query  
  A range's last game day.  
  format date
- `origin` string · query  
  live (default): picks Kelly published as they were said; all: with the back catalogue.  
  One of: `live`, `all` (open: new values may be added).
- `sport` string · query  
  Only these sports, comma-separated (nfl,ncaaf).  
  min length 1 · max length 80
- `market` string · query  
  Only these markets, comma-separated.  
  min length 1 · max length 80
- `firmness` string · query  
  official, lean, mention, comma-separated.  
  min length 1 · max length 40

### Response
`200` The analyst.

- `object` const · required  
  Always analyst_profile.  
  Always `"analyst_profile"`.
- `analyst` any · required  
  Who they are and their channels.
- `window` object · required  
  The game days read (New York).
  - `days` integer · required · nullable  
    The window's length in days of games; null for a range.
  - `from` string · required · nullable  
    The first game date; null when open.  
    format date
  - `to` string · required · nullable  
    The last game date; null when open.  
    format date
- `origins` array of string · required  
  Which picks count: live (published as they were said), and backfill (the back catalogue, read later) with origin=all.
- `sports` array of string · required  
  The sports kept; empty for every sport.
- `markets` array of string · required  
  The markets kept; empty for every market.
- `firmness` array of string · required  
  The firmness kept; empty for all.
- `record` object · required  
  Their record in the window: every factor.
  - `open` integer · required  
    Picks published on games in the window (or with no game date yet), not settled yet.
  - `removed` integer · required  
    Picks Kelly removed as extraction errors, ever (the removals rule).
  - `picks` integer · required  
    Picks graded win, loss or push in the window.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1; null with none.
  - `units` number · required · nullable  
    Units won at the stated price, or −110 when none was stated; null with no priced pick.
  - `roi` number · required · nullable  
    Units won over units risked; null with none risked.
  - `units_stated_only` number · required · nullable  
    Units won on the picks with a stated price only; null with none.
  - `priced_picks` integer · required  
    Decided picks with a price (stated, or −110 assumed for a spread or total).
  - `stated_price_picks` integer · required  
    Decided picks with a price the analyst stated.
  - `assumed_price_picks` integer · required  
    Decided spreads and totals graded at −110 because no price was stated.
  - `average_price` integer · required · nullable  
    The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
  - `clv_points` number · required · nullable  
    Mean closing-line value in points (+ is better than the close); null with no close.
  - `clv_points_picks` integer · required  
    Decided picks with a closing line.
  - `clv_prob` number · required · nullable  
    Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
  - `clv_prob_picks` integer · required  
    Decided picks with a closing price at the same line.
  - `no_edge_match_prob` number · required · nullable  
    How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
  - `e_value` number · required · nullable  
    The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
  - `units_at_stated` number · required · nullable  
    Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
  - `roi_at_stated` number · required · nullable  
    Units won at stated stakes over units risked at stated stakes; null with none risked.
  - `stated_units_picks` integer · required  
    Decided, priced picks with a stake the analyst stated in units.
  - `late` integer · required  
    Picks left out because they were said after the start.
  - `void` integer · required  
    Picks void (a cancelled game, a player who did not play).
  - `ungraded` integer · required  
    Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `withdrawn` object · required  
  The picks they dropped before the game started (or replaced at a new line), dropped in the window: not graded, each with when and where it was dropped.
  - `count` integer · required  
    How many.
  - `picks` array of object · required  
    The newest 50, newest drop first, each with withdrawn.
    - `object` const · required  
      Always analyst_pick.  
      Always `"analyst_pick"`.
    - `id` string · required  
      The pick's ID (apck_…).  
      pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$
    - `analyst` object · required  
      Who the pick is credited to.
      - `id` string · required  
        The analyst's ID (anl_…).  
        pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
      - `name` string · required  
        The analyst's, show's or outlet's name.
      - `kind` string · required  
        person, show or outlet: a show or outlet is credited when the person who said it is not one Kelly follows (stated_by names them).  
        One of: `person`, `show`, `outlet` (open: new values may be added).
    - `stated_by` string · required  
      Who said it, as named in the source.
    - `outlet` object · required · nullable  
      The outlet or show the pick was published on, when that is not who it is credited to: the pick counts for both records. Null otherwise.
      - `id` string · required  
        The outlet's or show's analyst ID (anl_…).  
        pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
      - `name` string · required  
        The outlet's or show's name.
      - `kind` string · required  
        outlet or show.  
        One of: `outlet`, `show` (open: new values may be added).
    - `show` object · required · nullable  
      The show it was said on, when an outlet carries that show and the show is not who it is credited to: the pick counts for the show too. Null otherwise.
      - `id` string · required  
        The show's analyst ID (anl_…).  
        pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
      - `name` string · required  
        The show's name.
    - `sport` string · required · nullable  
      The sport, e.g. nfl.
    - `event` string · required  
      The game or event as said.
    - `game` object · required · nullable  
      Kelly's game when the pick was matched to one, else null.
      - `id` string · required  
        The game's ID (gm_…).  
        pattern ^gm_[0-9a-hjkmnp-tv-z]{20}$
      - `name` string · required · nullable  
        The game's name.
      - `start_time` string · required  
        The scheduled start.  
        format date-time
    - `market` object · required  
      The market as said, and Kelly's market when matched.
      - `id` string · required · nullable  
        Kelly's market ID (mkt_…), or null.
      - `kind` string · required  
        spread, total, moneyline, prop, future, parlay or other.  
        One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
    - `selection` string · required  
      The side as said, e.g. Steelers +3.
    - `label` string · required  
      The pick in plain words, built from the market, side, stated line and the team or player named: Over 5.5 goals, Cameron Boozer over 8.5 rebounds, Minnesota Wild moneyline. The price is not in it.
    - `stat` string · required · nullable  
      A prop's stat as said (rebounds, passing yards) or what a game total counts (points, goals, runs); null for other markets.
    - `side` string · required · nullable  
      home, away, over, under, yes, no or draw; null when not stated.  
      One of: `home`, `away`, `over`, `under`, `yes`, `no`, `draw` (open: new values may be added).
    - `team_id` string · required · nullable  
      The team picked (tm_…), when matched.
    - `player_id` string · required · nullable  
      The player picked (plr_…), when matched.
    - `line` number · required · nullable  
      The line as stated; never computed.
    - `line_text` string · required · nullable  
      The line as written: +3, pk, 44.5.
    - `price_american` integer · required · nullable  
      The price as stated, American odds.
    - `units` number · nullable  
      The stake as stated, in units ('2u', 'half a unit'); null when none was stated (never inferred from how strongly the pick was put).
    - `firmness` string · required  
      official, lean or mention: how firmly it was put.  
      One of: `official`, `lean`, `mention` (open: new values may be added).
    - `series` string · nullable  
      The named set of picks it was given in, as the source names it (Road to 272, Teaser of the Week); null when none was named. Each series has its own record.
    - `said_in` object · required  
      Where it was said.
      - `kind` string · required  
        episode, video, article or post.  
        One of: `episode`, `video`, `article`, `post` (open: new values may be added).
      - `title` string · required  
        The item's title.
      - `url` string · required  
        The item's public link, at the moment it was said when known.  
        format uri
      - `published_at` string · required  
        When the item was published.  
        format date-time
      - `moment_seconds` integer · required · nullable  
        Seconds into the show, when known.
      - `channel` object · required  
        The channel the item was published on.
        - `name` string · required · nullable  
          The channel's name.
        - `url` string · required  
          The channel's public page.  
          format uri
        - `kind` string · required  
          youtube, podcast, rss, web, x, tiktok, instagram or threads.  
          One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
      - `platform` string · required  
        The platform it was said on, for its icon: x, youtube, podcast, tiktok, instagram, threads, discord, reddit, newsletter, video (elsewhere) or article.  
        One of: `x`, `youtube`, `podcast`, `tiktok`, `instagram`, `threads`, `discord`, `reddit`, `newsletter`, `video`, `article` (open: new values may be added).
    - `said_at` string · required  
      When the pick was said in public: its source's publish time (ADR-K247).  
      format date-time
    - `released_at` string · required  
      When its source was released (the same time as said_at until Kelly knows a recording time).  
      format date-time
    - `reported_at` string · required  
      When Kelly published the pick.  
      format date-time
    - `corrects` string · required · nullable  
      The pick this one corrects (apck_…), or null.
    - `withdrawn` object  
      Only on a pick its analyst dropped before the game started, or replaced at a new line: when and where they dropped it. It is not graded and is on no list or count; the analyst's profile and the pick's own page show it.
      - `at` string · required  
        When it was dropped: the publish time of the item it was dropped in.  
        format date-time
      - `said_in` object · required  
        Where it was dropped.
        - `kind` string · required  
          episode, video, article or post.  
          One of: `episode`, `video`, `article`, `post` (open: new values may be added).
        - `title` string · required  
          The item's title.
        - `url` string · required  
          The item's public link.  
          format uri
        - `published_at` string · required  
          When the item was published.  
          format date-time
        - `channel` object · required  
          The channel the item was published on.
          - `name` string · required · nullable  
            The channel's name.
          - `url` string · required  
            The channel's public page.  
            format uri
          - `kind` string · required  
            youtube, podcast, rss, web, x, tiktok, instagram or threads.  
            One of: `youtube`, `podcast`, `rss`, `web`, `x`, `tiktok`, `instagram`, `threads` (open: new values may be added).
        - `platform` string · required  
          The platform it was said on, for its icon: x, youtube, podcast, tiktok, instagram, threads, discord, reddit, newsletter, video (elsewhere) or article.  
          One of: `x`, `youtube`, `podcast`, `tiktok`, `instagram`, `threads`, `discord`, `reddit`, `newsletter`, `video`, `article` (open: new values may be added).
    - `detail` object  
      With include=detail (ADR-K254): pick (the picks card's shape, with label, now, move, out, close, grade and fair), summary (Kelly's own summary of where it was said, never a quote, or null), analyst (id, name, channels, sports), record (the last 90 days, or null), groups (the show and outlet it was published on when not who it is credited to, each with id, name, kind and its record), game (state, score, teams, consensus, or null), others (the game's other picks) and url (the pick's page).
    - `share` object · required  
      How to share the pick: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
      - `url` string · required  
        The link to the pick's page.  
        format uri
      - `image` string · required  
        The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
        format uri
      - `title` string · required  
        The title the link carries.
      - `text` string · required  
        A message ready to send: the title, then the link.
    - `notice` string · required  
      What the picks are and are not: as stated, credited and linked, never rated or ranked.
    - `as_of` string · required  
      When the value was true; for a derived value, its newest input's time.  
      format date-time
    - `source` string · required  
      Who produced the value, as shown to readers.  
      min length 1
    - `attribution` string · nullable  
      Attribution the source's terms require.
    - `request_id` string · required · nullable  
      The request that produced this response.
    - `live_topics` array of string  
      Kelly Wire topics that update this resource (API and cards only).
    - `rg_line` string · nullable  
      The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
- `splits` object · required  
  The record split four ways; series lists only the named series their picks were given in (Road to 272, Teaser of the Week), empty when none.
  - `firmness` array of object · required  
    The record by firmness, most picks first.
    - `value` string · required  
      The firmness.
    - `picks` integer · required  
      Picks graded win, loss or push in the window.
    - `wins` integer · required  
      Wins.
    - `losses` integer · required  
      Losses.
    - `pushes` integer · required  
      Pushes.
    - `win_rate` number · required · nullable  
      Wins over wins and losses, 0–1; null with none.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated; null with no priced pick.
    - `roi` number · required · nullable  
      Units won over units risked; null with none risked.
    - `units_stated_only` number · required · nullable  
      Units won on the picks with a stated price only; null with none.
    - `priced_picks` integer · required  
      Decided picks with a price (stated, or −110 assumed for a spread or total).
    - `stated_price_picks` integer · required  
      Decided picks with a price the analyst stated.
    - `assumed_price_picks` integer · required  
      Decided spreads and totals graded at −110 because no price was stated.
    - `average_price` integer · required · nullable  
      The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
    - `clv_points` number · required · nullable  
      Mean closing-line value in points (+ is better than the close); null with no close.
    - `clv_points_picks` integer · required  
      Decided picks with a closing line.
    - `clv_prob` number · required · nullable  
      Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
    - `clv_prob_picks` integer · required  
      Decided picks with a closing price at the same line.
    - `no_edge_match_prob` number · required · nullable  
      How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
    - `e_value` number · required · nullable  
      The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
    - `units_at_stated` number · required · nullable  
      Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
    - `roi_at_stated` number · required · nullable  
      Units won at stated stakes over units risked at stated stakes; null with none risked.
    - `stated_units_picks` integer · required  
      Decided, priced picks with a stake the analyst stated in units.
    - `late` integer · required  
      Picks left out because they were said after the start.
    - `void` integer · required  
      Picks void (a cancelled game, a player who did not play).
    - `ungraded` integer · required  
      Picks Kelly could not grade (futures, parlays, a line or side not stated).
  - `market` array of object · required  
    The record by market, most picks first.
    - `value` string · required  
      The market.
    - `picks` integer · required  
      Picks graded win, loss or push in the window.
    - `wins` integer · required  
      Wins.
    - `losses` integer · required  
      Losses.
    - `pushes` integer · required  
      Pushes.
    - `win_rate` number · required · nullable  
      Wins over wins and losses, 0–1; null with none.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated; null with no priced pick.
    - `roi` number · required · nullable  
      Units won over units risked; null with none risked.
    - `units_stated_only` number · required · nullable  
      Units won on the picks with a stated price only; null with none.
    - `priced_picks` integer · required  
      Decided picks with a price (stated, or −110 assumed for a spread or total).
    - `stated_price_picks` integer · required  
      Decided picks with a price the analyst stated.
    - `assumed_price_picks` integer · required  
      Decided spreads and totals graded at −110 because no price was stated.
    - `average_price` integer · required · nullable  
      The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
    - `clv_points` number · required · nullable  
      Mean closing-line value in points (+ is better than the close); null with no close.
    - `clv_points_picks` integer · required  
      Decided picks with a closing line.
    - `clv_prob` number · required · nullable  
      Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
    - `clv_prob_picks` integer · required  
      Decided picks with a closing price at the same line.
    - `no_edge_match_prob` number · required · nullable  
      How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
    - `e_value` number · required · nullable  
      The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
    - `units_at_stated` number · required · nullable  
      Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
    - `roi_at_stated` number · required · nullable  
      Units won at stated stakes over units risked at stated stakes; null with none risked.
    - `stated_units_picks` integer · required  
      Decided, priced picks with a stake the analyst stated in units.
    - `late` integer · required  
      Picks left out because they were said after the start.
    - `void` integer · required  
      Picks void (a cancelled game, a player who did not play).
    - `ungraded` integer · required  
      Picks Kelly could not grade (futures, parlays, a line or side not stated).
  - `sport` array of object · required  
    The record by sport, most picks first.
    - `value` string · required  
      The sport.
    - `picks` integer · required  
      Picks graded win, loss or push in the window.
    - `wins` integer · required  
      Wins.
    - `losses` integer · required  
      Losses.
    - `pushes` integer · required  
      Pushes.
    - `win_rate` number · required · nullable  
      Wins over wins and losses, 0–1; null with none.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated; null with no priced pick.
    - `roi` number · required · nullable  
      Units won over units risked; null with none risked.
    - `units_stated_only` number · required · nullable  
      Units won on the picks with a stated price only; null with none.
    - `priced_picks` integer · required  
      Decided picks with a price (stated, or −110 assumed for a spread or total).
    - `stated_price_picks` integer · required  
      Decided picks with a price the analyst stated.
    - `assumed_price_picks` integer · required  
      Decided spreads and totals graded at −110 because no price was stated.
    - `average_price` integer · required · nullable  
      The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
    - `clv_points` number · required · nullable  
      Mean closing-line value in points (+ is better than the close); null with no close.
    - `clv_points_picks` integer · required  
      Decided picks with a closing line.
    - `clv_prob` number · required · nullable  
      Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
    - `clv_prob_picks` integer · required  
      Decided picks with a closing price at the same line.
    - `no_edge_match_prob` number · required · nullable  
      How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
    - `e_value` number · required · nullable  
      The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
    - `units_at_stated` number · required · nullable  
      Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
    - `roi_at_stated` number · required · nullable  
      Units won at stated stakes over units risked at stated stakes; null with none risked.
    - `stated_units_picks` integer · required  
      Decided, priced picks with a stake the analyst stated in units.
    - `late` integer · required  
      Picks left out because they were said after the start.
    - `void` integer · required  
      Picks void (a cancelled game, a player who did not play).
    - `ungraded` integer · required  
      Picks Kelly could not grade (futures, parlays, a line or side not stated).
  - `series` array of object · required  
    The record by series, most picks first.
    - `value` string · required  
      The series.
    - `picks` integer · required  
      Picks graded win, loss or push in the window.
    - `wins` integer · required  
      Wins.
    - `losses` integer · required  
      Losses.
    - `pushes` integer · required  
      Pushes.
    - `win_rate` number · required · nullable  
      Wins over wins and losses, 0–1; null with none.
    - `units` number · required · nullable  
      Units won at the stated price, or −110 when none was stated; null with no priced pick.
    - `roi` number · required · nullable  
      Units won over units risked; null with none risked.
    - `units_stated_only` number · required · nullable  
      Units won on the picks with a stated price only; null with none.
    - `priced_picks` integer · required  
      Decided picks with a price (stated, or −110 assumed for a spread or total).
    - `stated_price_picks` integer · required  
      Decided picks with a price the analyst stated.
    - `assumed_price_picks` integer · required  
      Decided spreads and totals graded at −110 because no price was stated.
    - `average_price` integer · required · nullable  
      The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
    - `clv_points` number · required · nullable  
      Mean closing-line value in points (+ is better than the close); null with no close.
    - `clv_points_picks` integer · required  
      Decided picks with a closing line.
    - `clv_prob` number · required · nullable  
      Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
    - `clv_prob_picks` integer · required  
      Decided picks with a closing price at the same line.
    - `no_edge_match_prob` number · required · nullable  
      How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
    - `e_value` number · required · nullable  
      The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
    - `units_at_stated` number · required · nullable  
      Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
    - `roi_at_stated` number · required · nullable  
      Units won at stated stakes over units risked at stated stakes; null with none risked.
    - `stated_units_picks` integer · required  
      Decided, priced picks with a stake the analyst stated in units.
    - `late` integer · required  
      Picks left out because they were said after the start.
    - `void` integer · required  
      Picks void (a cancelled game, a player who did not play).
    - `ungraded` integer · required  
      Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `outlets` array of object · required  
  Their record at each outlet or show that published their picks, most picks first; empty for an outlet or show credited itself.
  - `analyst` object · required  
    Who.
    - `id` string · required  
      Their analyst ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      Their name.
    - `kind` string · required  
      person, show or outlet.  
      One of: `person`, `show`, `outlet` (open: new values may be added).
  - `picks` integer · required  
    Picks graded win, loss or push in the window.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1; null with none.
  - `units` number · required · nullable  
    Units won at the stated price, or −110 when none was stated; null with no priced pick.
  - `roi` number · required · nullable  
    Units won over units risked; null with none risked.
  - `units_stated_only` number · required · nullable  
    Units won on the picks with a stated price only; null with none.
  - `priced_picks` integer · required  
    Decided picks with a price (stated, or −110 assumed for a spread or total).
  - `stated_price_picks` integer · required  
    Decided picks with a price the analyst stated.
  - `assumed_price_picks` integer · required  
    Decided spreads and totals graded at −110 because no price was stated.
  - `average_price` integer · required · nullable  
    The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
  - `clv_points` number · required · nullable  
    Mean closing-line value in points (+ is better than the close); null with no close.
  - `clv_points_picks` integer · required  
    Decided picks with a closing line.
  - `clv_prob` number · required · nullable  
    Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
  - `clv_prob_picks` integer · required  
    Decided picks with a closing price at the same line.
  - `no_edge_match_prob` number · required · nullable  
    How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
  - `e_value` number · required · nullable  
    The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
  - `units_at_stated` number · required · nullable  
    Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
  - `roi_at_stated` number · required · nullable  
    Units won at stated stakes over units risked at stated stakes; null with none risked.
  - `stated_units_picks` integer · required  
    Decided, priced picks with a stake the analyst stated in units.
  - `late` integer · required  
    Picks left out because they were said after the start.
  - `void` integer · required  
    Picks void (a cancelled game, a player who did not play).
  - `ungraded` integer · required  
    Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `people` array of object · required  
  For an outlet or show: each person's record on it, most picks first (their picks count for the outlet too); empty for a person.
  - `analyst` object · required  
    Who.
    - `id` string · required  
      Their analyst ID (anl_…).  
      pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
    - `name` string · required  
      Their name.
    - `kind` string · required  
      person, show or outlet.  
      One of: `person`, `show`, `outlet` (open: new values may be added).
  - `picks` integer · required  
    Picks graded win, loss or push in the window.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1; null with none.
  - `units` number · required · nullable  
    Units won at the stated price, or −110 when none was stated; null with no priced pick.
  - `roi` number · required · nullable  
    Units won over units risked; null with none risked.
  - `units_stated_only` number · required · nullable  
    Units won on the picks with a stated price only; null with none.
  - `priced_picks` integer · required  
    Decided picks with a price (stated, or −110 assumed for a spread or total).
  - `stated_price_picks` integer · required  
    Decided picks with a price the analyst stated.
  - `assumed_price_picks` integer · required  
    Decided spreads and totals graded at −110 because no price was stated.
  - `average_price` integer · required · nullable  
    The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
  - `clv_points` number · required · nullable  
    Mean closing-line value in points (+ is better than the close); null with no close.
  - `clv_points_picks` integer · required  
    Decided picks with a closing line.
  - `clv_prob` number · required · nullable  
    Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
  - `clv_prob_picks` integer · required  
    Decided picks with a closing price at the same line.
  - `no_edge_match_prob` number · required · nullable  
    How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
  - `e_value` number · required · nullable  
    The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
  - `units_at_stated` number · required · nullable  
    Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
  - `roi_at_stated` number · required · nullable  
    Units won at stated stakes over units risked at stated stakes; null with none risked.
  - `stated_units_picks` integer · required  
    Decided, priced picks with a stake the analyst stated in units.
  - `late` integer · required  
    Picks left out because they were said after the start.
  - `void` integer · required  
    Picks void (a cancelled game, a player who did not play).
  - `ungraded` integer · required  
    Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `activity` object · required  
  What they are doing now (ADR-K256), read on every request.
  - `channels` array of object · required  
    Their active channels.
    - `name` string · required · nullable  
      The channel's name.
    - `url` string · required · nullable  
      Its public page.
    - `kind` string · required · nullable  
      youtube, podcast, site, x and so on.
  - `sports` array of string · required  
    The competitions of their published picks over the last 90 days, most first.
  - `picks_today` integer · required  
    Their picks said today (New York).
  - `latest_pick` object · required · nullable  
    Their newest published pick.
    - `id` string · required  
      The pick's ID (apck_…).
    - `label` string · required · nullable  
      The pick in plain words.
    - `market` string · required · nullable  
      The market as said.
    - `price_american` integer · required · nullable  
      The price said, American.
    - `said_at` string · required · nullable  
      When its source was published.  
      format date-time
    - `game_id` string · required · nullable  
      Its game (gm_…), or null.
- `board` object · required · nullable  
  Their place on the leaderboard with these filters (sort units, bar 100); null when they have no graded pick in the window.
  - `rank` integer · required · nullable  
    Their rank; null under the bar.
  - `of` integer · required  
    How many analysts are ranked.
  - `label` string · required  
    Their label.  
    One of: `beats the market so far`, `too early to tell`, `not enough picks yet` (open: new values may be added).
  - `sort` string · required  
    The sort.
  - `min_picks` integer · required  
    The bar: priced, decided picks to be ranked.
- `share` object · required  
  How to share the analyst's page: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
  - `url` string · required  
    The link to the analyst's page's page.  
    format uri
  - `image` string · required  
    The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
    format uri
  - `title` string · required  
    The title the link carries.
  - `text` string · required  
    A message ready to send: the title, then the link.
- `notice` string · required  
  What the records are: Kelly's grades of the picks as stated, at the stated price or -110 when none was stated.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/analysts/anl_samp1eana1ystsamp1e0?since=2026-09-01&until=2026-10-31
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_profile",
  "analyst": {
    "id": "anl_samp1eana1ystsamp1e0",
    "object": "analyst",
    "name": "Sample Analyst",
    "kind": "person",
    "channels": [],
    "followed": "seed",
    "heard_at": null,
    "image": null
  },
  "window": {
    "days": null,
    "from": "2026-09-01",
    "to": "2026-10-31"
  },
  "origins": [
    "live"
  ],
  "sports": [],
  "markets": [],
  "firmness": [],
  "activity": {
    "channels": [],
    "sports": [
      "nfl"
    ],
    "picks_today": 1,
    "latest_pick": {
      "id": "apck_samp1estakesamp1e000",
      "label": "Chiefs -3",
      "market": "spread",
      "price_american": -110,
      "said_at": "2026-10-04T17:30:00+00:00",
      "game_id": null
    }
  },
  "record": {
    "picks": 0,
    "wins": 0,
    "losses": 0,
    "pushes": 0,
    "win_rate": null,
    "units": null,
    "roi": null,
    "units_stated_only": null,
    "priced_picks": 0,
    "stated_price_picks": 0,
    "assumed_price_picks": 0,
    "average_price": null,
    "clv_points": null,
    "clv_points_picks": 0,
    "clv_prob": null,
    "clv_prob_picks": 0,
    "no_edge_match_prob": null,
    "e_value": null,
    "units_at_stated": null,
    "roi_at_stated": null,
    "stated_units_picks": 0,
    "late": 0,
    "void": 0,
    "ungraded": 0,
    "open": 1,
    "removed": 0
  },
  "withdrawn": {
    "count": 0,
    "picks": []
  },
  "splits": {
    "firmness": [],
    "market": [],
    "sport": [],
    "series": []
  },
  "outlets": [],
  "people": [],
  "board": null,
  "share": {
    "url": "https://askkelly.ai/picks/analysts/anl_samp1eana1ystsamp1e0",
    "image": "https://askkelly.ai/picks/analysts/anl_samp1eana1ystsamp1e0/opengraph-image",
    "title": "Sample Analyst: picks record",
    "text": "Sample Analyst: picks record https://askkelly.ai/picks/analysts/anl_samp1eana1ystsamp1e0"
  },
  "notice": "Records from Kelly's grades of the picks the analysts stated in public content, at the stated price or -110 when none was stated. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_209dbc05b8a41b2d07580e08",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00Z · Picks as stated by the analysts named, with links to the sources

`GET /v1/analysts/{analyst_id}/record`

## Get an analyst's record by period
scope `read:odds` · 1 credit, not charged during the beta · MCP tool `get_analyst_record` · status live

One analyst's record in the window, then by period (day, week, month, year, season, league_week) or split (firmness, market, sport, series), each with every factor, and their last decided picks.

### Parameters
- `analyst_id` string · path · required  
  The analyst's ID (anl_…).  
  pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$

- `grain` string · query  
  day, week (default), month, year, season or league_week; or a split: firmness, market, sport or series.  
  One of: `day`, `week`, `month`, `year`, `season`, `league_week`, `firmness`, `market`, `sport`, `series` (open: new values may be added).
- `last` integer · query  
  How many of their last decided picks to list; default 0.  
  min 0 · max 50
- `days` integer · query  
  The last N days of games to today (New York); default 30. Not with since or until.  
  min 1 · max 3650
- `since` string · query  
  A range's first game day.  
  format date
- `until` string · query  
  A range's last game day.  
  format date
- `origin` string · query  
  live (default): picks Kelly published as they were said; all: with the back catalogue.  
  One of: `live`, `all` (open: new values may be added).
- `sport` string · query  
  Only these sports, comma-separated (nfl,ncaaf).  
  min length 1 · max length 80
- `market` string · query  
  Only these markets, comma-separated.  
  min length 1 · max length 80
- `firmness` string · query  
  official, lean, mention, comma-separated.  
  min length 1 · max length 40

### Response
`200` Their record by period.

- `object` const · required  
  Always analyst_record.  
  Always `"analyst_record"`.
- `analyst` object · required  
  Who.
  - `id` string · required  
    The analyst's ID (anl_…).  
    pattern ^anl_[0-9a-hjkmnp-tv-z]{20}$
  - `name` string · required  
    The analyst's, show's or outlet's name.
  - `followed` string · required  
    seed, or heard: Kelly started following after hearing them state picks.  
    One of: `seed`, `heard` (open: new values may be added).
  - `kind` string · required  
    person, show or outlet.  
    One of: `person`, `show`, `outlet` (open: new values may be added).
  - `image` object · nullable  
    Its picture, or null: the show's podcast or YouTube artwork, the outlet's own site icon or the analyst's own X picture, as a square WebP served from Kelly's API host. Draw the name's initials where null.
    - `url` string · required  
      The picture's URL on Kelly's API host; its `v` changes with the picture.  
      format uri
    - `source` string · required  
      Where it came from.  
      One of: `override`, `podcast`, `apple`, `youtube`, `site`, `x` (open: new values may be added).
- `window` object · required  
  The game days read (New York).
  - `days` integer · required · nullable  
    The window's length in days of games; null for a range.
  - `from` string · required · nullable  
    The first game date; null when open.  
    format date
  - `to` string · required · nullable  
    The last game date; null when open.  
    format date
- `origins` array of string · required  
  Which picks count: live (published as they were said), and backfill (the back catalogue, read later) with origin=all.
- `sports` array of string · required  
  The sports kept; empty for every sport.
- `markets` array of string · required  
  The markets kept; empty for every market.
- `firmness` array of string · required  
  The firmness kept; empty for all.
- `record` object · required  
  Their record in the window.
  - `picks` integer · required  
    Picks graded win, loss or push in the window.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1; null with none.
  - `units` number · required · nullable  
    Units won at the stated price, or −110 when none was stated; null with no priced pick.
  - `roi` number · required · nullable  
    Units won over units risked; null with none risked.
  - `units_stated_only` number · required · nullable  
    Units won on the picks with a stated price only; null with none.
  - `priced_picks` integer · required  
    Decided picks with a price (stated, or −110 assumed for a spread or total).
  - `stated_price_picks` integer · required  
    Decided picks with a price the analyst stated.
  - `assumed_price_picks` integer · required  
    Decided spreads and totals graded at −110 because no price was stated.
  - `average_price` integer · required · nullable  
    The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
  - `clv_points` number · required · nullable  
    Mean closing-line value in points (+ is better than the close); null with no close.
  - `clv_points_picks` integer · required  
    Decided picks with a closing line.
  - `clv_prob` number · required · nullable  
    Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
  - `clv_prob_picks` integer · required  
    Decided picks with a closing price at the same line.
  - `no_edge_match_prob` number · required · nullable  
    How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
  - `e_value` number · required · nullable  
    The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
  - `units_at_stated` number · required · nullable  
    Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
  - `roi_at_stated` number · required · nullable  
    Units won at stated stakes over units risked at stated stakes; null with none risked.
  - `stated_units_picks` integer · required  
    Decided, priced picks with a stake the analyst stated in units.
  - `late` integer · required  
    Picks left out because they were said after the start.
  - `void` integer · required  
    Picks void (a cancelled game, a player who did not play).
  - `ungraded` integer · required  
    Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `grain` string · required · nullable  
  The grain or split the periods are cut by.
- `periods` array of object · required  
  Each period in time order, or each split value, most picks first.
  - `period` string · required  
    The period's label (2026-W42 (from 2026-10-12), 2026-10, 2026 Week 7, …) or the split's value.
  - `picks` integer · required  
    Picks graded win, loss or push in the window.
  - `wins` integer · required  
    Wins.
  - `losses` integer · required  
    Losses.
  - `pushes` integer · required  
    Pushes.
  - `win_rate` number · required · nullable  
    Wins over wins and losses, 0–1; null with none.
  - `units` number · required · nullable  
    Units won at the stated price, or −110 when none was stated; null with no priced pick.
  - `roi` number · required · nullable  
    Units won over units risked; null with none risked.
  - `units_stated_only` number · required · nullable  
    Units won on the picks with a stated price only; null with none.
  - `priced_picks` integer · required  
    Decided picks with a price (stated, or −110 assumed for a spread or total).
  - `stated_price_picks` integer · required  
    Decided picks with a price the analyst stated.
  - `assumed_price_picks` integer · required  
    Decided spreads and totals graded at −110 because no price was stated.
  - `average_price` integer · required · nullable  
    The average price taken, American odds (the mean of the decimal prices); null with no priced pick.
  - `clv_points` number · required · nullable  
    Mean closing-line value in points (+ is better than the close); null with no close.
  - `clv_points_picks` integer · required  
    Decided picks with a closing line.
  - `clv_prob` number · required · nullable  
    Mean closing-line value in break-even chance at the same line, 0–1 scale; null with none.
  - `clv_prob_picks` integer · required  
    Decided picks with a closing price at the same line.
  - `no_edge_match_prob` number · required · nullable  
    How often a bettor with no edge matches or beats this record at these prices, 0–1 (the luck read); null with no priced pick.
  - `e_value` number · required · nullable  
    The record as a test martingale in time order: large values are evidence against luck; null with no priced pick.
  - `units_at_stated` number · required · nullable  
    Units won with each priced pick weighed by the stake the analyst stated (one unit when none was stated); null with no priced pick.
  - `roi_at_stated` number · required · nullable  
    Units won at stated stakes over units risked at stated stakes; null with none risked.
  - `stated_units_picks` integer · required  
    Decided, priced picks with a stake the analyst stated in units.
  - `late` integer · required  
    Picks left out because they were said after the start.
  - `void` integer · required  
    Picks void (a cancelled game, a player who did not play).
  - `ungraded` integer · required  
    Picks Kelly could not grade (futures, parlays, a line or side not stated).
- `last_picks` array of object  
  With last: their last decided picks, newest first.
  - `pick_id` string · required  
    The pick (apck_…).  
    pattern ^apck_[0-9a-hjkmnp-tv-z]{20}$
  - `sport` string · required · nullable  
    The sport.
  - `market` string · required  
    The market.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
  - `firmness` string · required  
    How firmly.  
    One of: `official`, `lean`, `mention` (open: new values may be added).
  - `said_at` string · required  
    When the source was published.  
    format date-time
  - `game_date` string · required · nullable  
    The game's date (New York).  
    format date
  - `result` string · required  
    win, loss or push.  
    One of: `win`, `loss`, `push` (open: new values may be added).
  - `price_american` integer · required · nullable  
    The price graded at.
  - `price_basis` string · required  
    stated, or assumed (−110).
  - `units` number · required · nullable  
    Units won.
  - `clv_points` number · required · nullable  
    Closing-line value in points.
  - `label` string · nullable  
    The pick in plain words (Bills −3.5, Over 47.5, Josh Allen over 1.5 passing TDs).
  - `line_text` string · nullable  
    The line as stated (−3.5, O 47.5), or null with none.
  - `line` number · nullable  
    The line it was graded at, or null when none applies.
  - `line_basis` string · nullable  
    stated (the analyst's line), release (none was said: Kelly's consensus line when the pick came out) or first_after (none was said and no book had quoted it yet: Kelly's first consensus line after it).  
    One of: `stated`, `release`, `first_after` (open: new values may be added).
  - `game` object · nullable  
    The game: id, name and start_time; null when no game matched.
  - `stated_by` string · nullable  
    Who said it on the show, when not the analyst.
  - `said_in` object · nullable  
    Where it was said: kind, title, url, channel (name, url, kind) and platform (x, youtube, podcast, tiktok, instagram, threads, newsletter, video, article, …).
- `notice` string · required  
  What the records are: Kelly's grades of the picks as stated, at the stated price or -110 when none was stated.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/analysts/anl_samp1eana1ystsamp1e0/record?since=2026-09-01&until=2026-10-31&grain=week&last=5
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_record",
  "analyst": {
    "id": "anl_samp1eana1ystsamp1e0",
    "name": "Sample Analyst",
    "followed": "seed",
    "kind": "person"
  },
  "window": {
    "days": null,
    "from": "2026-09-01",
    "to": "2026-10-31"
  },
  "origins": [
    "live"
  ],
  "sports": [],
  "markets": [],
  "firmness": [],
  "record": {
    "picks": 0,
    "wins": 0,
    "losses": 0,
    "pushes": 0,
    "win_rate": null,
    "units": null,
    "roi": null,
    "units_stated_only": null,
    "priced_picks": 0,
    "stated_price_picks": 0,
    "assumed_price_picks": 0,
    "average_price": null,
    "clv_points": null,
    "clv_points_picks": 0,
    "clv_prob": null,
    "clv_prob_picks": 0,
    "no_edge_match_prob": null,
    "e_value": null,
    "units_at_stated": null,
    "roi_at_stated": null,
    "stated_units_picks": 0,
    "late": 0,
    "void": 0,
    "ungraded": 0
  },
  "grain": "week",
  "periods": [],
  "last_picks": [],
  "notice": "Records from Kelly's grades of the picks the analysts stated in public content, at the stated price or -110 when none was stated. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_839f6caef096bb3f0f58f763",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00Z · Picks as stated by the analysts named, with links to the sources

`GET /v1/analyst-picks/weeks/{competition}/{season}/{week}`

## Get a week's analyst picks
scope `read:odds` · 1 credit, not charged during the beta · MCP tool `get_analyst_picks_week` · status live

One football week (NFL or college football, by season and week number): each game in kickoff order with its published picks grouped by side (the side in words, the pick and analyst counts, the lines said, the pick IDs and Kelly's grades: won, lost, push, void or open), and the week's totals with units at the stated price or -110, plus every week of the season with its pick count. Sides come most-picked first, never ordered by a result; get_analyst_pick reads each pick with its source.

### Parameters
- `competition` string · path · required  
  The competition, as Kelly's slug (nfl, ncaaf).  
  pattern ^[a-z0-9_]{2,32}$
- `season` string · path · required  
  The season's label (2026).  
  pattern ^[0-9]{4}(-[0-9]{2})?$
- `week` integer · path · required  
  The week number.  
  min 0 · max 99

- `season_type` string · query  
  REG or POST, as the source names it; the type with the most games that week by default.  
  pattern ^[A-Za-z_]{1,24}$

### Response
`200` The week's picks.

- `object` const · required  
  Always analyst_picks_week.  
  Always `"analyst_picks_week"`.
- `competition` string · required  
  The competition slug (nfl, ncaaf).
- `season` string · required  
  The season's label.
- `season_type` string · nullable  
  The season type, as the source names it (REG, POST).
- `week` integer · required  
  The week number.
- `starts` string  
  The week's first kickoff, RFC 3339 UTC.  
  format date-time
- `ends` string  
  Its last kickoff.  
  format date-time
- `picks` integer · required  
  Published picks on the week's games.
- `analysts` integer  
  Analysts with a pick on them.
- `games_with_picks` integer  
  Games with at least one pick.
- `graded` object  
  Kelly's grades of the week's picks.
  - `picks` integer  
    Picks decided (won, lost or pushed).
  - `won` integer  
    Picks won.
  - `lost` integer  
    Picks lost.
  - `push` integer  
    Picks pushed.
  - `void` integer  
    Picks voided.
  - `open` integer  
    Picks not graded yet (open, late or ungraded).
  - `units` number · nullable  
    Units won over the decided picks, at the stated price or -110; null with none.
- `games` array of object · required  
  The week's games in kickoff order.
  - `game` object  
    The game.
    - `id` string  
      Game ID (gm_).
    - `name` string  
      The game's name.
    - `start_time` string  
      Kickoff, RFC 3339 UTC.  
      format date-time
    - `status` string  
      scheduled, live, final, postponed or suspended.
    - `home` object  
      A team.
      - `id` string  
        Team ID (tm_).
      - `name` string · nullable  
        Team name.
    - `away` object  
      A team.
      - `id` string  
        Team ID (tm_).
      - `name` string · nullable  
        Team name.
    - `score` object · nullable  
      The final score; null until the game is final.
      - `home` integer  
        Home points.
      - `away` integer  
        Away points.
  - `picks` integer  
    Published picks on the game.
  - `analysts` integer  
    Analysts with a pick on it.
  - `sides` array of object  
    Its sides, most-picked first, then by label; never ordered by a result.
    - `label` string · nullable  
      The side in words, as most of its picks say it (Bills -3.5, Over 44.5).
    - `market` string  
      The market as said.  
      One of: `spread`, `total`, `moneyline`, `prop`, `future`, `parlay`, `other` (open: new values may be added).
    - `player_id` string · nullable  
      A prop's player (plr_), else null.
    - `picks` integer  
      Published picks on this side.
    - `analysts` integer  
      Analysts behind them.
    - `lines` array of number  
      The lines said, lowest to highest.
    - `pick_ids` array of string  
      The picks (apck_), newest first: get_analyst_pick reads each with its source.
    - `won` integer  
      Picks on this side won.
    - `lost` integer  
      Picks on this side lost.
    - `push` integer  
      Picks on this side pushed.
    - `void` integer  
      Picks on this side voided.
    - `open` integer  
      Picks on this side not graded yet (open, late or ungraded).
- `notice` string · required  
  How the records are made: Kelly's grades of picks stated in public, at the stated price or -110.
- `weeks` array of object · required  
  Every week of the season and type, in order, for a week menu.
  - `week` integer  
    The week number.
  - `games` integer  
    Its games.
  - `picks` integer  
    Its published picks.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/analyst-picks/weeks/nfl/2026/60
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "type": "https://docs.askkelly.ai/problems/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "Kelly holds no nfl game in 2026 week 60.",
  "param": "week",
  "doc_url": "https://docs.askkelly.ai/problems/not_found",
  "request_id": "req_a890edd9b295f21c224cd3b5",
  "retryable": false,
  "display_message": "That could not be found."
}
```

```http
GET https://api.askkelly.ai/v1/analyst-picks/weeks/nfl/2026/4
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "object": "analyst_picks_week",
  "competition": "nfl",
  "season": "2026",
  "season_type": "REG",
  "week": 4,
  "starts": "2026-10-04T13:30:00Z",
  "ends": "2026-10-05T00:20:00Z",
  "picks": 0,
  "analysts": 0,
  "games_with_picks": 0,
  "graded": {
    "picks": 0,
    "won": 0,
    "lost": 0,
    "push": 0,
    "void": 0,
    "open": 0,
    "units": null
  },
  "games": [
    {
      "game": {
        "id": "gm_hwxy9tewzag7fee8hb01",
        "name": "Indianapolis Colts at Washington Commanders",
        "start_time": "2026-10-04T13:30:00Z",
        "status": "final",
        "home": {
          "id": "tm_djajaghvddks6vyzqqd7",
          "name": "Washington Commanders"
        },
        "away": {
          "id": "tm_sk506ccpxwra4vkkdqch",
          "name": "Indianapolis Colts"
        },
        "score": {
          "home": 13,
          "away": 30
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_5t1kg2twycs4tymwyvgd",
        "name": "New England Patriots at Buffalo Bills",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_xxq34syya7a322s20xqm",
          "name": "Buffalo Bills"
        },
        "away": {
          "id": "tm_bd0kys7yd28x4t2dva2j",
          "name": "New England Patriots"
        },
        "score": {
          "home": 26,
          "away": 29
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_81gmdw74d1g7tvcbmdpn",
        "name": "New York Jets at Chicago Bears",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_r46ra6zqhcwmgn5c8b46",
          "name": "Chicago Bears"
        },
        "away": {
          "id": "tm_j02qsvk4m574y4kpq3ez",
          "name": "New York Jets"
        },
        "score": {
          "home": 23,
          "away": 12
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_9p87ezms1s9vy004ddmn",
        "name": "Los Angeles Rams at Philadelphia Eagles",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_awt40s5gvkjw2f19stej",
          "name": "Philadelphia Eagles"
        },
        "away": {
          "id": "tm_h58pv28fshc724nn8b3v",
          "name": "Los Angeles Rams"
        },
        "score": {
          "home": 20,
          "away": 24
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_dpqae2k5kr995c81a6js",
        "name": "Tennessee Titans at Baltimore Ravens",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_3yae5jw96705e0wkbvqb",
          "name": "Baltimore Ravens"
        },
        "away": {
          "id": "tm_zebnan0dwjnr2hnp2pt1",
          "name": "Tennessee Titans"
        },
        "score": {
          "home": 24,
          "away": 18
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_j0t4f97xx18f21cer1qv",
        "name": "Dallas Cowboys at Houston Texans",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_73t1293cnn73tnqshkp7",
          "name": "Houston Texans"
        },
        "away": {
          "id": "tm_gxtkrznsm1zkvednjmbw",
          "name": "Dallas Cowboys"
        },
        "score": {
          "home": 30,
          "away": 34
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_nmnaa47rf94jk7ak2nj6",
        "name": "Green Bay Packers at Tampa Bay Buccaneers",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_gsw60avbm5m6zc5bdnbf",
          "name": "Tampa Bay Buccaneers"
        },
        "away": {
          "id": "tm_cg8n8h98pv9n318706gt",
          "name": "Green Bay Packers"
        },
        "score": {
          "home": 14,
          "away": 17
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_tjvz4w3e0xw3bk1t7htz",
        "name": "Arizona Cardinals at New York Giants",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_skscq590dhjsfw0q6xjw",
          "name": "New York Giants"
        },
        "away": {
          "id": "tm_52bjf251k4pe9rg7m5qy",
          "name": "Arizona Cardinals"
        },
        "score": {
          "home": 36,
          "away": 24
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_yqg4jbfd5yn1dg9n9vhq",
        "name": "Jacksonville Jaguars at Cincinnati Bengals",
        "start_time": "2026-10-04T17:00:00Z",
        "status": "final",
        "home": {
          "id": "tm_sjvwsrehafwzfn3e10d1",
          "name": "Cincinnati Bengals"
        },
        "away": {
          "id": "tm_4hby0ykr516ggkvgq81v",
          "name": "Jacksonville Jaguars"
        },
        "score": {
          "home": 17,
          "away": 22
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_wqh7bym2t7xy1t4cndd8",
        "name": "Miami Dolphins at Minnesota Vikings",
        "start_time": "2026-10-04T20:05:00Z",
        "status": "final",
        "home": {
          "id": "tm_cxr52zgkjysd404at34g",
          "name": "Minnesota Vikings"
        },
        "away": {
          "id": "tm_hfazk43zamdszm8snmxa",
          "name": "Miami Dolphins"
        },
        "score": {
          "home": 15,
          "away": 10
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_55zc8ywp3mzwg79py6mv",
        "name": "Kansas City Chiefs at Las Vegas Raiders",
        "start_time": "2026-10-04T20:25:00Z",
        "status": "final",
        "home": {
          "id": "tm_mp49sdajkwdncngf5twg",
          "name": "Las Vegas Raiders"
        },
        "away": {
          "id": "tm_0xcwddhkbjaqggrxg4xg",
          "name": "Kansas City Chiefs"
        },
        "score": {
          "home": 27,
          "away": 30
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_dg2acgm4yqf2vr2t9p08",
        "name": "Los Angeles Chargers at Seattle Seahawks",
        "start_time": "2026-10-04T20:25:00Z",
        "status": "final",
        "home": {
          "id": "tm_6tnbpb7482923nb3sg1c",
          "name": "Seattle Seahawks"
        },
        "away": {
          "id": "tm_szswdq5mys2cx8dhz3ep",
          "name": "Los Angeles Chargers"
        },
        "score": {
          "home": 30,
          "away": 23
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_q9v7mfjjt880872g5862",
        "name": "Denver Broncos at San Francisco 49ers",
        "start_time": "2026-10-04T20:25:00Z",
        "status": "final",
        "home": {
          "id": "tm_354fe6hptje107yhsq5m",
          "name": "San Francisco 49ers"
        },
        "away": {
          "id": "tm_835wtwy3ckc4abesw4w8",
          "name": "Denver Broncos"
        },
        "score": {
          "home": 24,
          "away": 14
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    },
    {
      "game": {
        "id": "gm_43sbx3sykk8ykkn2e4qx",
        "name": "Detroit Lions at Carolina Panthers",
        "start_time": "2026-10-05T00:20:00Z",
        "status": "final",
        "home": {
          "id": "tm_k6ccnx0e3pav9n88bkq1",
          "name": "Carolina Panthers"
        },
        "away": {
          "id": "tm_3hpn7jwsnvttb1h0c1cf",
          "name": "Detroit Lions"
        },
        "score": {
          "home": 32,
          "away": 26
        }
      },
      "picks": 0,
      "analysts": 0,
      "sides": []
    }
  ],
  "weeks": [
    {
      "week": 4,
      "games": 14,
      "picks": 0
    }
  ],
  "notice": "Records from Kelly's grades of the picks the analysts stated in public content, at the stated price or -110 when none was stated. Odds are information, not advice.",
  "as_of": "2026-10-04T17:30:00Z",
  "source": "analyst_channels",
  "attribution": "Picks as stated by the analysts named, with links to the sources",
  "request_id": "req_c93823bd53599cb6e830b9ac",
  "live_topics": [],
  "rg_line": "21+ · Help: 1-800-MY-RESET"
}
```

Where each value comes from:

1. analyst_channels · as of 2026-10-04T17:30:00Z · Picks as stated by the analysts named, with links to the sources

Generated from Kelly API 2026-10-05.

---

Generated from Kelly API 2026-10-05

Support: support@askkelly.ai · Security and disclosure: https://docs.askkelly.ai/security

Data is the edge. Odds are information, not advice · 21+ · Get help
