# GET /v1/free/markets (no key)

> Independent. Not affiliated with, endorsed by or sponsored by Novig.

Canonical: https://novigapi.com/docs/endpoints/free-markets
Facts checked: 2026-11-12

GET /v1/free/markets returns real Novig markets with no API key and no signup: bid, ask, last price, the no-vig fair price and American odds for every league. Rows are a few minutes delayed, capped at 50 a call and limited to 10 calls a minute per address. (Source: [Novig API docs](https://docs.novig.com))

## What it returns

The keyless free tier: the 40 most traded upcoming markets of each league (games and props in the next 7 days), about 3 to 6 minutes behind live. Use it to see the data before you sign up, from an agent's first call, a scraper or a spreadsheet. For live prices, every market, order books, trades, line history and pagination, send a free key to [GET /v1/markets](https://novigapi.com/docs/endpoints/markets?ref=ai-md).

The same rows come from the MCP tool `get_free_markets`, which also needs no key. See the [MCP server](https://novigapi.com/docs/endpoints/mcp?ref=ai-md).

## Parameters

Query and path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| league | string | No | League code or slug, such as `NBA`, `NFL` or `la-liga`. Omit for every league. Rows with a fair price come first, then the most traded. |
| market_id | string | No | One Novig market id. It must be in the free set; `not_found` says so when it is not. |
| market_type | string | No | Market type code, such as `MONEY`, `SPREAD`, `TOTAL` or `POINTS`. |
| q | string | No | Words to match in the market, event, player or team, such as `lebron points`. |
| limit | integer | No | Rows, 1 to 50. Default 25. |


## Request

```bash
curl -s "https://novigapi.com/api/v1/free/markets?league=NBA&limit=1"
```

## Response

A real first-half total from 12 Nov 2026, shortened: the live answer also carries `note`, `filters`, `leagues` (each league with its row count and oldest update) and links. Prices are probabilities from 0 to 1; `fair` is the no-vig price of each outcome and `american` is its fair American odds.

```json
{
  "free_tier": true,
  "delayed": true,
  "as_of": "2026-11-12T17:23:56.000Z",
  "delay_seconds": 412,
  "delayed_up_to_seconds": 600,
  "count": 1,
  "total_matching": 40,
  "data": [
    {
      "market_id": "01a1d001-e383-76c1-b24d-9646dcacfee6",
      "league": "NBA",
      "description": "TOR @ PHI t107.5 1H",
      "market_type": "TOTAL_1H",
      "strike": 107.5,
      "starts_at": "2026-11-13T00:05:00.000Z",
      "event": "Toronto Raptors @ Philadelphia 76ers",
      "player": null,
      "team": null,
      "stat": null,
      "status": "OPEN",
      "volume": 100000,
      "open_interest": 100000,
      "fair_price": 0.495,
      "outcomes": [
        {
          "name": "Over 107.5",
          "bid": 0.48,
          "ask": 0.51,
          "last": 0.5,
          "fair": 0.495,
          "american": 102,
          "decimal": 2.0202
        },
        {
          "name": "Under 107.5",
          "bid": 0.49,
          "ask": 0.52,
          "last": 0.5,
          "fair": 0.505,
          "american": -102,
          "decimal": 1.9802
        }
      ],
      "last_update": "2026-11-12T17:23:56.000Z",
      "url": "https://novigapi.com/nba"
    }
  ],
  "limits": {
    "rows_per_call": 50,
    "requests_per_minute": 10,
    "requests_per_day": 200,
    "per": "network address",
    "cached_for_seconds": 120
  },
  "get_a_key": {
    "agent_signup": "POST https://novigapi.com/api/v1/agent/signup",
    "browser_signup": "https://novigapi.com/sign-up"
  }
}
```

## Fields

Response fields

| Field | Type | Description |
| --- | --- | --- |
| free_tier, delayed | boolean | Always true: this is the delayed keyless tier. |
| as_of | string (ISO 8601) | When the oldest row returned was last read from Novig. |
| delay_seconds | integer | Seconds between `as_of` and this answer. |
| delayed_up_to_seconds | integer | The most a row can trail live prices: our copy, the client cache and one collector sweep. |
| data[].market_id, league, description, market_type, strike, starts_at | string, number | The market, as on [GET /v1/markets](https://novigapi.com/docs/endpoints/markets?ref=ai-md). |
| data[].event, player, team, stat | string or null | Names resolved from the market. |
| data[].fair_price | number or null | No-vig fair probability of the first outcome. Null when one side of the book is empty. |
| data[].outcomes[] | array | `name`, `bid`, `ask`, `last`, `fair`, and `american` and `decimal` odds of `fair` (of `last` when one side of the book is empty and `fair` is null). |
| data[].volume, open_interest | number | Contracts traded and open on Novig. |
| data[].last_update | string (ISO 8601) | When this market was last read from Novig. |
| data[].url | string or null | The public page for this market's player, team or league. |
| leagues[] | array | Each league in the free set with `code`, `slug`, `markets` and `as_of`. |


## Credit cost

Free: no key, no credits. 10 calls a minute and 200 a day per network address; a 429 `FREE_RATE_LIMITED` says how long to wait. Answers carry Cache-Control max-age 120, so a client may reuse the same rows for 2 minutes.

## Python

```python
import requests

r = requests.get("https://novigapi.com/api/v1/free/markets", params={"league": "NBA", "limit": 10}, timeout=10)
doc = r.json()
print("as of", doc["as_of"], "delayed", doc["delay_seconds"], "s")
for m in doc["data"]:
    over = m["outcomes"][0]
    print(m["description"], over["name"], "fair", over["fair"], over["american"])
```

## JavaScript

```javascript
const res = await fetch("https://novigapi.com/api/v1/free/markets?league=NBA&limit=10");
const doc = await res.json();
for (const m of doc.data) console.log(m.description, m.outcomes.map((o) => o.name + " " + o.fair));
console.log("as of " + doc.as_of);
```

## Notes and edge cases

- Delayed by design: rows are about 3 to 6 minutes behind live, plus up to 2 minutes of client cache, so check `as_of` before acting on a price. Paid REST data is at most about 10 seconds old.
- Only the 40 most traded upcoming markets of each league (games and props in the next 7 days) are in the free set; games already under way drop out. Every market, live games, closed markets and results need a key.
- A call to a keyed endpoint without a key gets 401 `INVALID_API_KEY` with `error.free_tier.url` pointing here.
- Free keys cost nothing either: 100 credits a month, no card, via [agent signup](https://novigapi.com/agents.md?ref=ai-md) or [sign up](https://novigapi.com/sign-up?ref=ai-md).

## Sources

- [Novig API docs](https://docs.novig.com)
- [Novig API reference: Get a market](https://docs.novig.com/api-reference/catalog/get-a-market.md)

---

Get a free API key: https://novigapi.com/sign-up?ref=ai-md . Docs: https://novigapi.com/docs?ref=ai-md . MCP: https://novigapi.com/api/mcp . Operated by Stunning Couches LLC. Independent. Not affiliated with, endorsed by or sponsored by Novig.
