# Pinnacle Odds Scraper & Line Movement Monitor (`neverempty/pinnacle-odds-monitor`) Actor

Pinnacle sharp odds for NBA, NFL, NHL, college, soccer, tennis and UFC: moneyline, spread, total and team total with no-vig probability. Turn on monitoring and each later run returns only the lines that moved, with the previous price and the opening line.

- **URL**: https://apify.com/neverempty/pinnacle-odds-monitor.md
- **Developed by:** [NeverEmpty](https://apify.com/neverempty) (community)
- **Categories:** Sports, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.33 / 1,000 price row returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Pinnacle Odds Scraper & Line Movement Monitor

**Get Pinnacle's sharp odds as flat JSON rows: moneyline, spread, total and team total for every game in the leagues or sports you pick (NBA, NFL, NHL, college, soccer, tennis, UFC and more), with American and decimal odds, the no-vig probability and the market hold.** Turn on monitoring and each scheduled run returns only the lines that moved, with the previous price, the opening (first seen) line and the size of the move, so you get a clean line-movement feed without paying for unchanged prices.

Pinnacle is the sharpest book in the market, and its line is the reference most bettors, model builders and odds-comparison sites measure everything else against. This Actor puts that reference line in a spreadsheet, database or bot without copying it by hand.

### What you get

- **Game lines** - moneyline (with the draw in soccer), spread / handicap, total and team totals for every upcoming game.
- **Fair odds** - `noVigProbability` and `fairDecimalOdds` with the margin removed, plus `marketHold` and Pinnacle's maximum stake (`maxRiskStake`) for each market.
- **Halves, quarters, periods and sets** on request (`includePartialPeriods`), every alternate spread and total on request (`includeAlternateLines`), and side markets such as soccer corners and bookings on request (`includeOtherUnits`).
- **Line movement** - in monitoring mode a row says what changed (`new-game`, `new-line`, `line-moved`, `price-moved`, `line-and-price-moved`) and carries the previous line and price, when the previous price was seen, and the first seen line and price with the total move since then.
- **Whole sports in one go** - ask for `Tennis`, `Soccer`, `Mixed Martial Arts` or any other sport on pinnacle.com and get every league on that sport's board.

One row is one price, so the output drops straight into a sheet or a database table with no nested arrays to unpack.

### Why this Actor

- **Pay for moves, not for repeats.** With monitoring on, unchanged prices are not returned and not charged. If nothing at all moved, the run charges one small monitoring check per league instead of re-selling the same board.
- **Opening line on every move.** Each moved row carries the first price this monitor saw for that line, so you can measure closing-line value or steam without keeping your own history.
- **Stable keys.** `lineKey` identifies a line by game, period, market and side, so a spread moving from -3 to -3.5 shows up as one `line-moved` row, not as one line disappearing and another appearing.
- **Clean numbers.** Every row has real numbers (`priceAmerican: 104`, `priceDecimal: 2.04`, `line: -13`), and `pricesAsOf` says when the prices you received were posted.
- **Every empty result explains itself** in a free row: off-season league, unknown league or sport, a game that is no longer on the board, a page Pinnacle refused.

### Input

| Field | What it does |
|---|---|
| `leagues` | Short names (`nba`, `ncaab`, `nfl`, `ncaaf`, `nhl`, `ufc`, `epl`, `championship`, `laliga`, `bundesliga`, `bundesliga2`, `seriea`, `ligue1`, `eredivisie`, `primeiraliga`, `ucl`, `uel`, `mls`, `ligamx`, `brasileirao`) or the numeric league ID from a pinnacle.com league page address (`889` is the NFL). |
| `sports` | Whole sports by name or ID, for example `Tennis`, `Soccer`, `Basketball`, `Mixed Martial Arts` (or `mma`), `Boxing`, `E Sports`. |
| `marketTypes` | `moneyline`, `spread`, `total`, `team_total`. Empty = all four. |
| `includePartialPeriods`, `includeAlternateLines`, `includeOtherUnits` | Add halves and quarters, alternate lines, or corners and bookings. Off by default. |
| `teams`, `matchupIds`, `startsWithinHours` | Narrow down to teams or players, to specific games, or to games starting soon. |
| `maxRows` | Cap on returned rows (default 1000). Rows come soonest start first. |
| `monitoringMode` | Remember the prices and compare each run with the previous one and with the opening line. |
| `onlyChangedLines` | Monitoring: return only new or moved prices (default on). Off = every run returns every price, marked new, moved or unchanged. |
| `minPriceMove` | Monitoring: return a price move only once it reaches this size in decimal odds, measured from the last value you received, so small moves add up instead of being lost. Line moves and new lines are always returned. |
| `resetMonitoringState` | Start monitoring over from a fresh starting point. |

Example - tonight's NBA and NFL main lines:

```json
{ "leagues": ["nba", "nfl"], "startsWithinHours": 24 }
```

Example - a line-movement feed for the Premier League, every 15 minutes:

```json
{ "leagues": ["epl"], "monitoringMode": true, "minPriceMove": "0.03" }
```

### Output

A spread row (values as Pinnacle listed them on 2026-11-17):

```json
{
  "status": "ok",
  "sport": "Football",
  "league": "NFL",
  "leagueId": "889",
  "matchupId": "1639904657",
  "eventName": "Indianapolis Colts @ Houston Texans",
  "homeTeam": "Houston Texans",
  "awayTeam": "Indianapolis Colts",
  "startTime": "2026-11-20T01:15:00.000Z",
  "periodName": "Full game",
  "marketType": "spread",
  "isAlternateLine": false,
  "side": "home",
  "selectionLabel": "Houston Texans",
  "line": -13,
  "priceAmerican": 104,
  "priceDecimal": 2.04,
  "impliedProbability": 0.4902,
  "noVigProbability": 0.4763,
  "fairDecimalOdds": 2.1,
  "marketHold": 0.0293,
  "maxRiskStake": 20000,
  "lineKey": "1639904657|0|spread||main|home",
  "pricesAsOf": "2026-11-17T23:25:07.000Z"
}
```

In monitoring mode the same row comes back only when it changes, for example with `"changeType": "price-moved"`, `"previousPriceAmerican": 104`, `"priceAmerican": -105`, `"priceDecimalMove": -0.088`, `"firstSeenPriceAmerican": 110` and `"firstSeenAt"`.

Every row also has `sportId`, `leagueGroup`, `parentMatchupId`, `cutoffAt`, `unit`, `period`, `teamSide` and `scrapedAt`.

### Pricing

Pay per event:

- **`line-returned`** - one returned price row. Rows dropped by your filters are not charged.
- **`league-checked`** - monitoring only, and only when a run finds that nothing moved: one per league or sport compared. The first monitoring run, which only records the starting point, is free, and so is every run that returns at least one moved price.

Free rows (never charged) explain empty results: `no-such-league`, `no-such-sport`, `no-events`, `event-not-found`, `blocked`, `unreadable`, `no-filter-match`, `no-markets-yet`, `no-line-move`, `baseline-saved`, `budget-reached`, `row-limit-reached`.

### Scheduling a line-movement monitor

1. Run once with `monitoringMode: true` - it remembers the current prices and returns a free `baseline-saved` row.
2. Save the input as a task and schedule it (every 15 or 60 minutes suits Pinnacle's pre-game board).
3. Each run returns only moves and new lines. Connect the dataset to a webhook, Google Sheets, Slack or your own service.

Monitoring memory is kept per input (leagues, sports, market types and the options above), so different watch lists do not interfere. Prices that did not fit within `maxRows` or the maximum charge are not marked as seen and are returned on the next run.

### Good to know

- This is an unofficial tool and is not affiliated with Pinnacle. It reads only the public odds that pinnacle.com shows to any visitor, with no login. It is not betting advice.
- Pre-game prices only: games that are already live are left out.
- Off-season leagues return a free `no-events` row. Soccer and tennis boards are large; `teams`, `startsWithinHours` and `maxRows` keep runs short.
- A monitoring run is a snapshot at the moment it runs; moves between two runs are reported as one move from the old value to the new value.
- If Pinnacle refuses a page several times in a row, that page is reported in a free row and nothing is guessed.

### Thanks for using this Actor

We build these tools for people who run them every day, and we improve them from what users tell us.

- **Missing a field, or need another filter?** Tell us in the **Issues** tab. If the data is there, we add it.
- **Found a bug or a wrong value?** Post the run ID in the **Issues** tab. Wrong data is the thing we fix first.

If this Actor saved you time, a short review helps other people find it.

### More sports and odds data from the same developer

- [Action Network Scraper - Public Betting Splits Monitor](https://apify.com/neverempty/action-network-betting-splits) — public betting splits (bets % vs money %) by game
- [BestFightOdds Scraper - MMA Odds, UFC & Boxing Odds, Line Moves](https://apify.com/neverempty/bestfightodds-scraper) — MMA and boxing odds and line moves
- [UFC Stats Scraper: MMA Fights, Fighters, Events, Round-by-Round](https://apify.com/neverempty/ufc-stats-scraper) — UFC fights, fighters and round-by-round stats
- [Sherdog Fight History - MMA Fighter Records & Event Cards](https://apify.com/neverempty/sherdog-fight-history) — MMA fighter records and event cards
- [Sports Betting Odds Scraper - NFL, NBA, MLB, Soccer, Line Moves](https://apify.com/neverempty/sports-betting-odds-scraper) — NFL, NBA, MLB and soccer odds with line moves
- [OddsPortal Scraper - Historical Odds, Opening & Closing Lines](https://apify.com/neverempty/oddsportal-historical-odds-scraper) — historical opening and closing odds
- [Sleeper Player Props Scraper - Lines, Odds & Line Moves](https://apify.com/neverempty/sleeper-player-props-scraper) — player prop lines and line moves
- [Live Scores API - Sports Scores NBA, NFL, MLB, NHL, NCAAF, EPL](https://apify.com/neverempty/sports-scores-api) — live and final scores for major leagues
- [Tennis Elo Ratings Scraper - ATP & WTA Surface Elo, Win Odds](https://apify.com/neverempty/tennis-elo-ratings-scraper) — ATP and WTA surface Elo ratings
- [TennisExplorer Scraper & New-Result Monitor - Odds & Scores](https://apify.com/neverempty/tennisexplorer-scraper) — tennis results, odds and new results

# Actor input Schema

## `leagues` (type: `array`):

Which Pinnacle leagues to read. Use a short name (nba, ncaab, nfl, ncaaf, nhl, ufc, epl, championship, laliga, bundesliga, bundesliga2, seriea, ligue1, eredivisie, primeiraliga, ucl, uel, mls, ligamx, brasileirao) or the numeric league ID from a pinnacle.com league page address (889 is the NFL). Use Whole sports below for anything else. A name that is not recognised comes back as a free row that says so.

## `sports` (type: `array`):

Read every league of a sport at once, by name or numeric ID: Tennis, Soccer, Basketball, Football, Hockey, Baseball, Mixed Martial Arts (or mma), Boxing, E Sports, Golf and the other sports listed on pinnacle.com. Tennis returns both the match (Sets) and total games (Games) prices.

## `marketTypes` (type: `array`):

Empty = all four.

## `includePartialPeriods` (type: `boolean`):

Off = full game only. On = also 1st half, quarters, periods, innings and sets where Pinnacle prices them (periodName says which).

## `includeAlternateLines` (type: `boolean`):

Off = the main spread and total only. On = every alternate spread and total as well.

## `includeOtherUnits` (type: `boolean`):

Off = goals, points, sets and games. On = also side markets such as corners and bookings (the unit column says which).

## `teams` (type: `array`):

Keep only games where a team or player name contains one of these words (case does not matter). Empty = every game.

## `matchupIds` (type: `array`):

Keep only these games (the numeric ID in a pinnacle.com game page address, or matchupId from an earlier run). An ID that is not on the board comes back as a free row.

## `startsWithinHours` (type: `integer`):

0 = no limit. 24 = only games that start in the next 24 hours.

## `maxRows` (type: `integer`):

The run stops after this many price rows. Rows come soonest start first, so a low number keeps the nearest games.

## `monitoringMode` (type: `boolean`):

On = the run remembers every price it read. Run it on a schedule with the same input and each later run compares against the previous run and against the opening (first seen) line.

## `onlyChangedLines` (type: `boolean`):

On = the first monitoring run only saves the starting point (no rows, no charge) and each later run returns only new or moved prices. Off = every run returns every price, each marked new, moved or unchanged.

## `minPriceMove` (type: `string`):

Only with monitoring and Return only lines that changed. 0.05 = skip price moves smaller than 0.05 in decimal odds. A line (points) move or a new line is always returned. Small moves add up: once the total since the last returned price passes this, it is returned.

## `resetMonitoringState` (type: `boolean`):

On = forget what earlier runs remembered for this input and save a new starting point.

## Actor input object example

```json
{
  "leagues": [
    "nba",
    "nfl",
    "epl"
  ],
  "includePartialPeriods": false,
  "includeAlternateLines": false,
  "includeOtherUnits": false,
  "startsWithinHours": 0,
  "maxRows": 1000,
  "monitoringMode": false,
  "onlyChangedLines": true,
  "resetMonitoringState": false
}
```

# Actor output Schema

## `results` (type: `string`):

One row per Pinnacle price: sport, league, game (matchup ID, name, start time, home and away team), market type (moneyline, spread, total, team total), period, the selection, the line, American and decimal odds, implied and no-vig probability, market hold and the maximum stake. In monitoring mode each row also says what changed (new-game, new-line, line-moved, price-moved, line-and-price-moved, unchanged) with the previous and the first seen line and price. Empty results come back as free rows that say why.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "leagues": [
        "nba",
        "nfl",
        "epl"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("neverempty/pinnacle-odds-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "leagues": [
        "nba",
        "nfl",
        "epl",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("neverempty/pinnacle-odds-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "leagues": [
    "nba",
    "nfl",
    "epl"
  ]
}' |
apify call neverempty/pinnacle-odds-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neverempty/pinnacle-odds-monitor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/McS5h0gVG0Vuczk9g/builds/Hw0mftecYa8ERn9sx/openapi.json
