> ## Documentation Index
> Fetch the complete documentation index at: https://edgefinder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# edgefinder odds — Polymarket NFL and NBA betting odds

> Retrieve live Polymarket betting odds for NFL or NBA games with edgefinder odds. Filter by week number for NFL or by specific date for NBA.

The `odds` command fetches live Polymarket betting odds for NFL and NBA games. For the NFL you can pull odds for a specific week; for the NBA you can filter by a specific date. Without any filter flags, both leagues return odds for their current default period — the current NFL week or today's NBA games.

## Syntax

```bash theme={null}
edgefinder odds <nfl|nba> [--week N] [--date YYYY-MM-DD] [--json]
```

## Arguments

<ParamField path="path.league" type="string" required>
  The league to fetch odds for. Must be `nfl` or `nba`.
</ParamField>

## Options

<ParamField path="query.--week" type="number">
  NFL only. The week number to retrieve odds for (e.g. `12`). When omitted, returns odds for the current NFL week.
</ParamField>

<ParamField path="query.--date" type="string">
  NBA only. A specific date in `YYYY-MM-DD` format. When omitted, returns odds for today's NBA games.
</ParamField>

<ParamField path="query.--json" type="boolean">
  Output raw JSON. The `odds` command always outputs JSON; this flag is accepted for script consistency.
</ParamField>

## Examples

<CodeGroup>
  ```bash NFL current week theme={null}
  edgefinder odds nfl
  ```

  ```bash NFL specific week theme={null}
  edgefinder odds nfl --week 12
  ```

  ```bash NBA today theme={null}
  edgefinder odds nba
  ```

  ```bash NBA specific date theme={null}
  edgefinder odds nba --date 2026-02-20
  ```
</CodeGroup>

### Sample output

<Tabs>
  <Tab title="NFL">
    ```json theme={null}
    [
      {
        "marketId": "0xabc123",
        "question": "Will the Kansas City Chiefs win Super Bowl LXI?",
        "homeTeam": "Kansas City Chiefs",
        "awayTeam": "Las Vegas Raiders",
        "week": 12,
        "outcomes": [
          { "label": "Yes", "price": 0.72 },
          { "label": "No", "price": 0.28 }
        ],
        "volume": 148200,
        "closesAt": "2026-01-04T18:00:00Z"
      }
    ]
    ```
  </Tab>

  <Tab title="NBA">
    ```json theme={null}
    [
      {
        "marketId": "0xdef456",
        "question": "Will the Los Angeles Lakers beat the Boston Celtics?",
        "homeTeam": "Los Angeles Lakers",
        "awayTeam": "Boston Celtics",
        "date": "2026-02-20",
        "outcomes": [
          { "label": "Yes", "price": 0.45 },
          { "label": "No", "price": 0.55 }
        ],
        "volume": 83400,
        "closesAt": "2026-02-20T00:30:00Z"
      }
    ]
    ```
  </Tab>
</Tabs>

<Note>
  `--week` is only meaningful for NFL and `--date` is only meaningful for NBA. Passing the wrong flag for the league has no effect.
</Note>

<Tip>
  Combine `odds` output with `ask` for deeper context. Fetch the odds JSON, then ask EdgeFinder to interpret them:

  ```bash theme={null}
  edgefinder odds nfl --week 12 | jq '.[0]'
  edgefinder ask "Explain the value in Chiefs vs Raiders based on Polymarket prices"
  ```
</Tip>

<Warning>
  Polymarket odds reflect prediction market prices, not traditional sportsbook lines. Prices represent the implied probability of an outcome (0.0–1.0), not American or decimal odds.
</Warning>