Read-only Novig market data: order books, trades, line history, fair prices, +EV and devig.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer nv_... (optional for search, fetch and devig)
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Answer the onboarding questions for your user, from what you know about their project. Ask them what you do not know; never guess. Answering again replaces the answers; the same answers twice change nothing. Your user sees them on their dashboard, marked as answered by their agent. Costs no quota.
Question id to answer. A select question takes one of its options.
Your name, such as Claude Code or Cursor.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http novigapi https://novigapi.com/api/mcp
Headers
Authorization (optional, not in the config above): Bearer nv_... (optional for search, fetch and devig)Answer the onboarding questions for your user, from what you know about their project. Ask them what you do not know; never guess. Answering again replaces the answers; the same answers twice change nothing. Your user sees them on their dashboard, marked as answered by their agent. Costs no quota.
| Argument | Type | Description |
|---|---|---|
| client | string | Your name, such as Claude Code or Cursor. |
| answers* | object | Question id to answer. A select question takes one of its options. |
{
"type": "object",
"required": [
"answers"
],
"properties": {
"client": {
"type": "string",
"description": "Your name, such as Claude Code or Cursor."
},
"answers": {
"type": "object",
"required": [
"data_wanted",
"use_case"
],
"properties": {
"notes": {
"type": "string",
"description": "Anything else we should know?"
},
"found_us": {
"type": "string",
"description": "How did you find us?"
},
"use_case": {
"type": "string",
"description": "What do you want to do with it?"
},
"data_wanted": {
"type": "string",
"description": "What Novig data are you looking for?"
}
},
"description": "Question id to answer. A select question takes one of its options."
}
}
}Cancel your user's paid plan at the end of the current billing period. Only call this when your user asked to cancel. A reason is required: ask your user why they are cancelling and pass their answer; never pick a reason for them. Reasons: got_what_i_needed (I got the data I needed), too_expensive (Too expensive), missing_data (Missing data or features I need), reliability (Errors or slow responses), not_using (Not using it enough), switched (Switched to another service), other (Something else). "other" needs a comment. keep_subscription undoes it. Costs no quota.
| Argument | Type | Description |
|---|---|---|
| client | string | Your name, such as Claude Code or Cursor. |
| reason* | string | Why your user is cancelling, in their words mapped to one id. Ask them; never guess. |
| comment | string | Your user's own words about why. Required when reason is other. |
{
"type": "object",
"required": [
"reason"
],
"properties": {
"client": {
"type": "string",
"description": "Your name, such as Claude Code or Cursor."
},
"reason": {
"enum": [
"got_what_i_needed",
"too_expensive",
"missing_data",
"reliability",
"not_using",
"switched",
"other"
],
"type": "string",
"description": "Why your user is cancelling, in their words mapped to one id. Ask them; never guess."
},
"comment": {
"type": "string",
"maxLength": 500,
"description": "Your user's own words about why. Required when reason is other."
}
}
}One Novig market beside FanDuel and DraftKings on exactly the same line: Novig bid, ask and fair price, each book's American and decimal odds, implied probability, age and EV%. Costs 1 credit. Same data as GET /api/v1/compare/{market_id}. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| market_id* | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"market_id",
"user_request"
],
"properties": {
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Create one of your Watchlists.
| Argument | Type | Description |
|---|---|---|
| name* | string | What this watchlist tracks |
| league | string | League code such as NFL or NBA |
| targets* | string | Player names |
| user_request* | string | The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data. |
| move_threshold | number | Minimum price move in percentage points before an alert fires |
{
"type": "object",
"required": [
"name",
"targets",
"user_request"
],
"properties": {
"name": {
"type": "string",
"description": "What this watchlist tracks"
},
"league": {
"type": "string",
"description": "League code such as NFL or NBA"
},
"targets": {
"type": "string",
"description": "Player names"
},
"user_request": {
"type": "string",
"description": "The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."
},
"move_threshold": {
"type": "number",
"description": "Minimum price move in percentage points before an alert fires"
}
},
"additionalProperties": false
}Delete one of your Watchlists. Cannot be undone, so confirm with your user first.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| user_request* | string | The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"id",
"user_request"
],
"properties": {
"id": {
"type": "string"
},
"user_request": {
"type": "string",
"description": "The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."
}
}
}Remove the vig from a set of odds and return fair probabilities and fair odds, by the multiplicative, additive, power or Shin method. Needs no key and costs no credits. For a live Novig market's fair price, use fair_price. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| method | string | |
| outcomes* | array | Each outcome as american (-110), decimal (1.91) or probability (0.52). |
| user_request | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"outcomes"
],
"properties": {
"method": {
"enum": [
"multiplicative",
"additive",
"power",
"shin"
],
"type": "string"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"decimal": {
"type": "number"
},
"american": {
"type": "number"
},
"probability": {
"type": "number"
}
}
},
"maxItems": 20,
"minItems": 2,
"description": "Each outcome as american (-110), decimal (1.91) or probability (0.52)."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
}
}The fair no-vig price of one market: the two-sided mid, with the formula and the taker fee coefficient, plus meta.devig with the fair price by every devig method (multiplicative, additive, power, Shin) applied to the market's implied asks. Costs 1 credit. Same data as GET /api/v1/fair-price. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| method | string | Devig method to mark as selected in meta.devig. Default additive, which equals the two-sided mid. |
| market_id* | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"market_id",
"user_request"
],
"properties": {
"method": {
"enum": [
"multiplicative",
"additive",
"power",
"shin"
],
"type": "string",
"description": "Devig method to mark as selected in meta.devig. Default additive, which equals the two-sided mid."
},
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Read one search result by id: current Novig markets with prices and fair prices, or a page of this site, as text with a citation URL. Needs no key and costs no credits.
| Argument | Type | Description |
|---|---|---|
| id* | string | An id from search. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "An id from search."
}
}
}Two-way arbitrage across Novig, FanDuel and DraftKings (both legs, the stake split for 100 units and the guaranteed margin), or middles where lines differ (type=middles). Production and Scale. Costs 3 credits per 100 rows requested. Same data as GET /api/v1/arbitrage. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| type | string | arbitrage (default) or middles. |
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code. |
| min_profit | number | Smallest guaranteed margin, percent. |
| market_type | string | moneyline, spread, total or player_prop. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"type": {
"enum": [
"arbitrage",
"middles"
],
"type": "string",
"description": "arbitrage (default) or middles."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code."
},
"min_profit": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Smallest guaranteed margin, percent."
},
"market_type": {
"enum": [
"moneyline",
"spread",
"total",
"player_prop"
],
"type": "string",
"description": "moneyline, spread, total or player_prop."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Positive expected value bets: FanDuel and DraftKings prices that pay more than the Novig fair (no-vig) probability, with EV%, edge in cents, Kelly stake, freshness and a confidence flag. Default view: fair probability at least 15%, main lines only, high confidence only, best EV first; override with min_prob, alt_lines, confidence and sort. Free keys read the top rows 10 minutes late; live rows need Developer. Costs 2 credits per 100 rows requested. Same data as GET /api/v1/ev. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| sort | string | ev (default), edge_cents or kelly. |
| books | string | Comma list of book codes: fd (FanDuel), dk (DraftKings). |
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, such as NBA or NFL. |
| player | string | Player slug, such as lebron-james. |
| min_edge | number | Smallest EV% to return, default 0. |
| min_prob | number | Smallest Novig fair probability, percent. Default 15. |
| alt_lines | boolean | Include alternate lines, not only the main line of each market. Default false. |
| market_id | string | Only this Novig market. |
| confidence | string | high (default) or any. |
| market_type | string | moneyline, spread, total or player_prop. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"sort": {
"enum": [
"ev",
"edge_cents",
"kelly"
],
"type": "string",
"description": "ev (default), edge_cents or kelly."
},
"books": {
"type": "string",
"description": "Comma list of book codes: fd (FanDuel), dk (DraftKings)."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA or NFL."
},
"player": {
"type": "string",
"description": "Player slug, such as lebron-james."
},
"min_edge": {
"type": "number",
"maximum": 100,
"minimum": -3,
"description": "Smallest EV% to return, default 0."
},
"min_prob": {
"type": "number",
"maximum": 95,
"minimum": 0,
"description": "Smallest Novig fair probability, percent. Default 15."
},
"alt_lines": {
"type": "boolean",
"description": "Include alternate lines, not only the main line of each market. Default false."
},
"market_id": {
"type": "string",
"description": "Only this Novig market."
},
"confidence": {
"enum": [
"high",
"any"
],
"type": "string",
"description": "high (default) or any."
},
"market_type": {
"enum": [
"moneyline",
"spread",
"total",
"player_prop"
],
"type": "string",
"description": "moneyline, spread, total or player_prop."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Collect the API key after your user approved at approval_url. Poll every 5 seconds with device_code. Pending returns AUTHORIZATION_PENDING; the key is returned once. Costs nothing.
| Argument | Type | Description |
|---|---|---|
| device_code* | string | nvd_... from start_signup |
{
"type": "object",
"required": [
"device_code"
],
"properties": {
"device_code": {
"type": "string",
"description": "nvd_... from start_signup"
}
}
}Closing-line value: each outcome's opening and closing fair price before the start, the move between them and the result once graded, for one market, a player, a league or a date. Kept for every market recorded two-sided before its start. Costs 5 credits per 100 rows requested. Same data as GET /api/v1/clv. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD: markets starting that day (US Eastern). |
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| since | string | ISO 8601 time. Free reads only the last 7 days. |
| until | string | ISO 8601 time: markets starting at or before it. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, such as NBA. |
| player | string | Player slug, such as lebron-james. |
| settled | boolean | Only markets with a grade. |
| market_id | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD: markets starting that day (US Eastern)."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"since": {
"type": "string",
"description": "ISO 8601 time. Free reads only the last 7 days."
},
"until": {
"type": "string",
"description": "ISO 8601 time: markets starting at or before it."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA."
},
"player": {
"type": "string",
"description": "Player slug, such as lebron-james."
},
"settled": {
"type": "boolean",
"description": "Only markets with a grade."
},
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Novig events (games) with teams, start time and status, filtered by league and status. Costs 1 credit per 100 rows requested. Same data as GET /api/v1/events. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, such as NBA or NFL. |
| status | string | open, closed, settled, suspended or all. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA or NFL."
},
"status": {
"enum": [
"open",
"closed",
"settled",
"suspended",
"all"
],
"type": "string",
"description": "open, closed, settled, suspended or all."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Real Novig markets with no key: bid, ask, last price, the no-vig fair price, American and decimal odds, volume and the last update time, for every league (NFL, NBA, NHL, NCAAF, NCAAB, UFC, tennis, soccer and more). The free delayed 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, at most 50 rows a call. Filter by league, market_id, market_type or a text query. Needs no key and costs no credits; the answer links to a free key for live prices and every market. Same data as GET /api/v1/free/markets.
| Argument | Type | Description |
|---|---|---|
| q | string | Words to match in the market, event, player or team, such as "lebron points". |
| limit | integer | Rows, default 25, at most 50. |
| league | string | League code or slug, such as NBA, NFL or la-liga. Omit for all leagues. |
| market_id | string | One Novig market id. |
| market_type | string | Market type code, such as MONEY, SPREAD, TOTAL or POINTS. |
| user_request | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Words to match in the market, event, player or team, such as \"lebron points\"."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Rows, default 25, at most 50."
},
"league": {
"type": "string",
"description": "League code or slug, such as NBA, NFL or la-liga. Omit for all leagues."
},
"market_id": {
"type": "string",
"description": "One Novig market id."
},
"market_type": {
"type": "string",
"description": "Market type code, such as MONEY, SPREAD, TOTAL or POINTS."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Leagues Novig lists markets for, with their codes. Costs 1 credit per 100 rows requested. Same data as GET /api/v1/leagues. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Intraday price history (every recorded change of best bid, last price, volume) for one market or outcome. Costs 5 credits per 100 rows requested. Same data as GET /api/v1/line-history. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| since | string | ISO 8601 time. Free reads only the last 7 days. |
| until | string | ISO 8601 time. |
| cursor | string | next_cursor from the previous page. |
| market_id | string | Novig market id. |
| outcome_id | string | Novig outcome id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"since": {
"type": "string",
"description": "ISO 8601 time. Free reads only the last 7 days."
},
"until": {
"type": "string",
"description": "ISO 8601 time."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"market_id": {
"type": "string",
"description": "Novig market id."
},
"outcome_id": {
"type": "string",
"description": "Novig outcome id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Recorded line moves and steam moves, newest first, by league and minimum size in percentage points. Costs 3 credits per 100 rows requested. Same data as GET /api/v1/line-moves. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| kind | string | move or steam. |
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| since | string | ISO 8601 time. Free reads only the last 7 days. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code. |
| market_id | string | Only this Novig market. |
| min_delta_pp | number | Smallest move to return, in percentage points. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"kind": {
"enum": [
"move",
"steam"
],
"type": "string",
"description": "move or steam."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"since": {
"type": "string",
"description": "ISO 8601 time. Free reads only the last 7 days."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code."
},
"market_id": {
"type": "string",
"description": "Only this Novig market."
},
"min_delta_pp": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Smallest move to return, in percentage points."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}One Novig market by id, with its outcomes and current prices. Costs 1 credit. Same data as GET /api/v1/markets/{id}. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| market_id* | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"market_id",
"user_request"
],
"properties": {
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Daily market summary from Novig's daily files: straight markets by league and market type (markets, contracts traded, open interest) and parlays (COMBO) per day with taker trades, notional and the legs histogram. Costs 3 credits per 100 rows requested. Same data as GET /api/v1/market-summary/daily. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD. Free reads only the last 7 days. |
| kind | string | straight, total or combo. |
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| since | string | ISO 8601 time. Free reads only the last 7 days. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, or ALL for the day totals and parlays. |
| market_type | string | Market type, such as POINTS, or COMBO for parlays. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD. Free reads only the last 7 days."
},
"kind": {
"enum": [
"straight",
"total",
"combo"
],
"type": "string",
"description": "straight, total or combo."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"since": {
"type": "string",
"description": "ISO 8601 time. Free reads only the last 7 days."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, or ALL for the day totals and parlays."
},
"market_type": {
"type": "string",
"description": "Market type, such as POINTS, or COMBO for parlays."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}List Novig markets with best bid, implied ask, last price, volume and open interest, filtered by league, event, market type, player, team or status. Costs 1 credit per 100 rows requested. Same data as GET /api/v1/markets. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| team | string | Team slug. |
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, such as NBA or NFL. |
| player | string | Player slug, such as lebron-james. |
| status | string | open, closed, settled, suspended or all. |
| event_id | string | Novig event id. |
| market_type | string | Market type code. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"team": {
"type": "string",
"description": "Team slug."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA or NFL."
},
"player": {
"type": "string",
"description": "Player slug, such as lebron-james."
},
"status": {
"enum": [
"open",
"closed",
"settled",
"suspended",
"all"
],
"type": "string",
"description": "open, closed, settled, suspended or all."
},
"event_id": {
"type": "string",
"description": "Novig event id."
},
"market_type": {
"type": "string",
"description": "Market type code."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Daily open, high, low and close with volume and open interest, for one market or for every market on one date. Costs 3 credits per 100 rows requested. Same data as GET /api/v1/ohlc/daily. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD. Free reads only the last 7 days. |
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| market_id | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD. Free reads only the last 7 days."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}The questions that finish setting up your user's account, with their ids and options. With a key, also the answers already given. Costs no quota.
No arguments.
{
"type": "object",
"properties": {}
}The full resting order book for one market: every price level and quantity on both sides. Costs 1 credit. Same data as GET /api/v1/orderbook/{id}. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| market_id* | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"market_id",
"user_request"
],
"properties": {
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Current Novig player prop markets for one player, with fair prices. Costs 1 credit per 100 rows requested. Same data as GET /api/v1/player-props. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league* | string | League code, such as NBA. |
| player* | string | Player slug, such as lebron-james. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"league",
"player",
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA."
},
"player": {
"type": "string",
"description": "Player slug, such as lebron-james."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Players with Novig markets, by league or name search. Returns the slugs other tools take. Costs 1 credit per 100 rows requested. Same data as GET /api/v1/players. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| q | string | Part of a player name. |
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, such as NBA. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"q": {
"type": "string",
"description": "Part of a player name."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Settled markets with the winning outcome and closing price: each row says how it was graded (box score, final price or Novig's file) and how sure the grade is. Costs 3 credits per 100 rows requested. Same data as GET /api/v1/results. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| since | string | ISO 8601 time. Free reads only the last 7 days. |
| cursor | string | next_cursor from the previous page. |
| graded | boolean | Only rows with a decided grade: a winner, a void or a push. |
| league | string | League code. |
| market_id | string | Only this Novig market. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"since": {
"type": "string",
"description": "ISO 8601 time. Free reads only the last 7 days."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"graded": {
"type": "boolean",
"description": "Only rows with a decided grade: a winner, a void or a push."
},
"league": {
"type": "string",
"description": "League code."
},
"market_id": {
"type": "string",
"description": "Only this Novig market."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Your user's plan and subscription status, including a scheduled cancellation, and the reasons cancel_subscription accepts. Costs no quota.
No arguments.
{
"type": "object",
"properties": {}
}Teams with Novig markets, by league. Returns the slugs other tools take. Costs 1 credit per 100 rows requested. Same data as GET /api/v1/teams. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 50. Free returns at most 100. |
| cursor | string | next_cursor from the previous page. |
| league | string | League code, such as NBA. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 50. Free returns at most 100."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"league": {
"type": "string",
"description": "League code, such as NBA."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Fills on Novig, newest first, optionally for one market and since a time. Costs 3 credits per 100 rows requested. Same data as GET /api/v1/trades. Needs a key; without one, get_free_markets returns delayed markets. Pass user_request: your user's current task in one sentence (3 to 500 characters, no secrets or personal data). It is saved so the team builds what people need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page, default 100. Free returns at most 100. |
| since | string | ISO 8601 time. Free reads only the last 7 days. |
| cursor | string | next_cursor from the previous page. |
| market_id | string | Novig market id. |
| user_request* | string | Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page, default 100. Free returns at most 100."
},
"since": {
"type": "string",
"description": "ISO 8601 time. Free reads only the last 7 days."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"market_id": {
"type": "string",
"description": "Novig market id."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Your user's current task in one sentence. Saved for 35 days so the team can decide what to build. Leave out secrets and personal data."
}
},
"additionalProperties": false
}Read one of your Watchlists by id.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| user_request* | string | The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"id",
"user_request"
],
"properties": {
"id": {
"type": "string"
},
"user_request": {
"type": "string",
"description": "The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."
}
}
}Undo a scheduled cancellation, so your user's plan renews as normal. Only when your user asks. Costs no quota.
No arguments.
{
"type": "object",
"properties": {}
}List Watchlists. A saved set of players, teams or markets you want line-move alerts on.
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| offset | number | |
| user_request* | string | The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"user_request": {
"type": "string",
"description": "The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."
}
}
}Rate how well the last result served your user's task, 1 to 5, with an optional message. The team reads every one. Costs nothing and works while rate limited. Leave out secrets and personal data.
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| agent | string | |
| rating | integer | |
| message | string | |
| blocking | boolean | |
| endpoint | string | |
| use_case | string |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"missing_data",
"missing_feature",
"wrong_data",
"bug",
"docs",
"praise",
"other"
],
"type": "string"
},
"agent": {
"type": "string"
},
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"message": {
"type": "string"
},
"blocking": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"use_case": {
"type": "string"
}
}
}Search Novig players and their per-stat prop pages (such as "LeBron James points"), current markets, teams, leagues, and this site's calculators, guides, glossary and API docs. Returns ids to pass to fetch. Needs no key and costs no credits.
| Argument | Type | Description |
|---|---|---|
| query* | string | A player (optionally with a stat), team, league, market, calculator, guide or docs topic. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "A player (optionally with a stat), team, league, market, calculator, guide or docs topic."
}
}
}Tell the team what is missing or wrong. The team reads every one. Costs no quota.
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| contact | string | |
| message* | string |
{
"type": "object",
"required": [
"kind",
"message"
],
"properties": {
"kind": {
"enum": [
"missing_feature",
"missing_data",
"bug",
"other"
],
"type": "string"
},
"contact": {
"type": "string"
},
"message": {
"type": "string"
}
}
}Create a Novig API account for your user and get a key without a password. Returns approval_url: show it to your user, who approves in one click (free, no card). Then call finish_signup every 5 seconds with device_code. Costs nothing.
| Argument | Type | Description |
|---|---|---|
| agent | string | Your name, such as Claude Code (optional) |
| details | object | |
| found_us | string | How they found us (optional, up to 300) |
| use_case* | string | What they will do with it (3-1000, required) |
| data_wanted* | string | What Novig data your user wants (3-1000 characters, required) |
| agent_found_us | string | How you, the agent, found us (optional, up to 300) |
{
"type": "object",
"required": [
"data_wanted",
"use_case"
],
"properties": {
"agent": {
"type": "string",
"description": "Your name, such as Claude Code (optional)"
},
"details": {
"type": "object",
"properties": {
"notes": {
"type": "string"
}
}
},
"found_us": {
"type": "string",
"description": "How they found us (optional, up to 300)"
},
"use_case": {
"type": "string",
"description": "What they will do with it (3-1000, required)"
},
"data_wanted": {
"type": "string",
"description": "What Novig data your user wants (3-1000 characters, required)"
},
"agent_found_us": {
"type": "string",
"description": "How you, the agent, found us (optional, up to 300)"
}
}
}Change fields on one of your Watchlists.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| name | string | What this watchlist tracks |
| league | string | League code such as NFL or NBA |
| targets | string | Player names |
| user_request* | string | The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data. |
| move_threshold | number | Minimum price move in percentage points before an alert fires |
{
"type": "object",
"required": [
"id",
"user_request"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string",
"description": "What this watchlist tracks"
},
"league": {
"type": "string",
"description": "League code such as NFL or NBA"
},
"targets": {
"type": "string",
"description": "Player names"
},
"user_request": {
"type": "string",
"description": "The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."
},
"move_threshold": {
"type": "number",
"description": "Minimum price move in percentage points before an alert fires"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.