Name: Pinnacle API: Odds, Lines, Fixtures and Live Matches
Brand: proapi
SKU: api-proapi-pinnacle
Availability: InStock
Author: API Market

JarX8

# Pinnacle API: Sports Odds, Lines & Live Scores

## Overview

The Pinnacle API returns sports odds and fixtures that are publicly visible on Pinnacle as JSON, across 8 GET endpoints. You start from the list of sports, narrow to leagues, then list a sport's or league's matches, optionally for a single day. Matches in play are a separate event at Pinnacle and are listed by their own live endpoint. A match_id from any of those lists opens the match details (periods, market counts, status) and the full market board: money line, handicap, totals, team totals and props, each with its line, status, cutoff time and outcomes.

It is aimed at odds comparison and research tools, sports data and modelling teams, sports media that show reference lines, and developers who need a compact odds feed. Every market includes the period (for example Match or 1st Half), type, line and outcomes priced in both American and decimal odds, and live matches add the current period and a live score such as sets won, games by set and points in tennis. All dates can be rendered in any IANA timezone with the timezone parameter.

## Features

*   **8 GET endpoints**: Timezones, sports, leagues, matches by sport or league, live matches, match details and match odds.
*   **Full market board**: Money line, handicap, totals, team totals and props for the full match and for periods such as the 1st half.
*   **American and decimal odds**: Every outcome carries oddsAmerican and oddsDecimal, plus the line for handicap and total markets.
*   **Live matches and scores**: /v1/sport/matches/live lists matches in play with the current period and live score fields.
*   **ID chaining**: sport_id from /v1/sport/list feeds /v1/sport/leagues, league_id and sport_id feed the match lists, and match_id feeds details and odds.
*   **Timezone support**: Pass any IANA timezone from /v1/timezones to render start times and cutoffs locally; UTC is the default.
*   **Data source**: Publicly visible data from the Pinnacle website, requested with your x-api-market-key header.
*   **Rate limit**: 10 requests/second on the free trial, 300 on pay-as-you-go

## Use Cases

*   **Odds comparison and research**: Use Pinnacle lines as a reference point next to other sources in your own odds dataset.
*   **Sports modelling**: Convert decimal odds into implied probabilities and compare them with your model's outputs for each match.
*   **Fixture lists**: List a league's upcoming matches for a given day with start times in your users' timezone.
*   **Live match trackers**: Poll live matches for a sport to show the current period and score alongside open markets.
*   **Sports media**: Show the current money line, spread and total for featured matches in previews and articles.

## Pricing

| Plan | Price | What you get | Rate limit |
|---|---|---|---|
| Free | $0 | 7-day trial with 100 API calls | 10 requests/second |
| PAYG | No monthly fee | US$0.001 per successful call, paid from your API.market wallet | 300 requests/second |

Only successful (2xx) responses count. A lookup for something that does not exist returns `404` and is not billed.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/proapi/pinnacle
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Get timezones

Returns the list of supported timezone identifiers, accepted by the "timezone" parameter of every endpoint returning a date or a time.

**Method:** `GET`

**Endpoint:** `/v1/timezones`

**Parameters:**

None.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/timezones" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  "Africa/Abidjan",
  "Africa/Accra"
]
```

#### 2. Get all available sports

Returns a list of all available sports with match counts.

**Method:** `GET`

**Endpoint:** `/v1/sport/list`

**Parameters:**

None.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/sport/list" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": 29,
    "name": "Soccer",
    "totalMatches": 967
  },
  {
    "id": 12,
    "name": "E Sports",
    "totalMatches": 70
  }
]
```

#### 3. Get leagues for a sport

Returns the leagues available for the given sport.

**Method:** `GET`

**Endpoint:** `/v1/sport/leagues`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `sport_id` | query | Example: `29`. | integer | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/sport/leagues?sport_id=29" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": 1842,
    "name": "Bundesliga",
    "totalMatches": 19
  },
  {
    "id": 2627,
    "name": "Champions League",
    "totalMatches": 19
  }
]
```

#### 4. Get matches for a sport

Returns the matches available for the given sport, optionally narrowed down to a single league and/or a single day.

**Method:** `GET`

**Endpoint:** `/v1/sport/matches`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `sport_id` | query | Example: `29`. | integer | Yes | - | - |
| `league_id` | query | Return only the matches of this league. | integer | No | - | - |
| `date` | query | Return only the matches starting on this day, in the YYYY-MM-DD format. Read in the requested timezone. | string | No | - | - |
| `timezone` | query | Render every date and time in this IANA timezone. Defaults to UTC. See the timezones endpoint for the accepted values. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/sport/matches?sport_id=29" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Response:** the image file itself, not JSON.

#### 5. Get live matches for a sport

Returns the matches of the given sport that are in play, optionally narrowed down to a single league. A match in play is a separate event at Pinnacle, so it is served from its own endpoint rather than filtered out of /sport/matches.

**Method:** `GET`

**Endpoint:** `/v1/sport/matches/live`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `sport_id` | query | Example: `33`. | integer | Yes | - | - |
| `league_id` | query | Return only the matches of this league. | integer | No | - | - |
| `timezone` | query | Render every date and time in this IANA timezone. Defaults to UTC. See the timezones endpoint for the accepted values. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/sport/matches/live?sport_id=33" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": 1637841222,
    "name": "Ninon Carpentier vs Oceane Dodin",
    "startTime": "2026-10-07T10:00:00+00:00",
    "status": {
      "isStarted": true,
      "isInProgress": true,
      "isInterrupted": false
    },
    "live": {
      "period": 2,
      "periodName": "2nd Set",
      "serving": "home"
    },
    "sport": {
      "id": 33,
      "name": "Tennis"
    },
    "league": {
      "id": 238535,
      "name": "R1",
      "country": "France"
    },
    "homeTeam": {
      "name": "Ninon Carpentier",
      "setsWon": 0,
      "gamesBySet": [
        1
      ],
      "points": "0"
    },
    "awayTeam": {
      "name": "Oceane Dodin",
      "setsWon": 1,
      "gamesBySet": [
        6
      ],
      "points": "15"
    },
    "units": "Sets",
    "periods": [
      {
        "period": 0,
        "name": "Match",
        "status": "open",
        "cutoffAt": "2026-10-08T00:31:07+00:00",
        "hasMoneyline": true,
        "hasSpread": true,
        "hasTotal": true,
        "hasTeamTotal": false
      }
    ],
    "markets": {
      "total": 0,
      "hasLive": true,
      "hasAlternativeSpread": false,
      "hasAlternativeTotal": false
    },
    "ageLimit": 0
  }
]
```

#### 6. Get matches for a league

Returns the matches available for the given league, optionally narrowed down to a single day.

**Method:** `GET`

**Endpoint:** `/v1/league/matches`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `league_id` | query | Example: `2196`. | integer | Yes | - | - |
| `sport_id` | query | The sport the league belongs to. Example: `29`. | integer | Yes | - | - |
| `date` | query | Return only the matches starting on this day, in the YYYY-MM-DD format. Read in the requested timezone. | string | No | - | - |
| `timezone` | query | Render every date and time in this IANA timezone. Defaults to UTC. See the timezones endpoint for the accepted values. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/league/matches?league_id=2196&sport_id=29" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": 1636739062,
    "name": "Malaga vs Espanyol",
    "startTime": "2026-10-09T19:00:00+00:00",
    "status": {
      "isStarted": false,
      "isInProgress": false,
      "isInterrupted": false
    },
    "live": null,
    "sport": {
      "id": 29,
      "name": "Soccer"
    },
    "league": {
      "id": 2196,
      "name": "La Liga",
      "country": "Spain"
    },
    "homeTeam": {
      "name": "Malaga"
    },
    "awayTeam": {
      "name": "Espanyol"
    },
    "units": "Regular",
    "periods": [
      {
        "period": 0,
        "name": "Match",
        "status": "open",
        "cutoffAt": "2026-10-09T19:00:00+00:00",
        "hasMoneyline": true,
        "hasSpread": true,
        "hasTotal": true,
        "hasTeamTotal": true
      }
    ],
    "markets": {
      "total": 61,
      "hasLive": true,
      "hasAlternativeSpread": true,
      "hasAlternativeTotal": true
    },
    "ageLimit": 0
  }
]
```

#### 7. Get match details

Returns the details of a single match (event).

**Method:** `GET`

**Endpoint:** `/v1/match/details`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `match_id` | query | - | integer | Yes | - | - |
| `timezone` | query | Render every date and time in this IANA timezone. Defaults to UTC. See the timezones endpoint for the accepted values. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/match/details?match_id=1637637826" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "id": 1637637826,
  "name": "Vinotinto vs Cuenca Juniors",
  "startTime": "2026-10-07T20:30:00+00:00",
  "status": {
    "isStarted": false,
    "isInProgress": false,
    "isInterrupted": false
  },
  "live": null,
  "sport": {
    "id": 29,
    "name": "Soccer"
  },
  "league": {
    "id": 197248,
    "name": "Serie B",
    "country": "Ecuador"
  },
  "homeTeam": {
    "name": "Vinotinto"
  },
  "awayTeam": {
    "name": "Cuenca Juniors"
  },
  "units": "Regular",
  "periods": [
    {
      "period": 0,
      "name": "Match",
      "status": "open",
      "cutoffAt": "2026-10-07T20:30:00+00:00",
      "hasMoneyline": true,
      "hasSpread": true,
      "hasTotal": true,
      "hasTeamTotal": true
    },
    {
      "period": 1,
      "name": "1st Half",
      "status": "open",
      "cutoffAt": "2026-10-07T20:30:00+00:00",
      "hasMoneyline": false,
      "hasSpread": true,
      "hasTotal": true,
      "hasTeamTotal": true
    }
  ],
  "markets": {
    "total": 18,
    "hasLive": true,
    "hasAlternativeSpread": true,
    "hasAlternativeTotal": true
  },
  "ageLimit": 0
}
```

#### 8. Get match odds

Returns the odds for a given match.

**Method:** `GET`

**Endpoint:** `/v1/match/odds`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `match_id` | query | - | integer | Yes | - | - |
| `timezone` | query | Render every date and time in this IANA timezone. Defaults to UTC. See the timezones endpoint for the accepted values. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/pinnacle/v1/match/odds?match_id=1637637826" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "name": "Money Line \u2013 Match",
    "type": "moneyline",
    "typeName": "Money Line",
    "period": 0,
    "periodName": "Match",
    "team": null,
    "units": "Regular",
    "special": null,
    "isLive": false,
    "line": null,
    "status": "open",
    "cutoffAt": "2026-10-07T20:30:00+00:00",
    "limits": [
      {
        "amount": 500,
        "type": "maxRiskStake"
      }
    ],
    "outcomes": [
      {
        "designation": "home",
        "name": "Vinotinto",
        "line": null,
        "oddsAmerican": -279,
        "oddsDecimal": 1.358
      },
      {
        "designation": "away",
        "name": "Cuenca Juniors",
        "line": null,
        "oddsAmerican": 841,
        "oddsDecimal": 9.41
      }
    ]
  },
  {
    "name": "Handicap \u2013 Match",
    "type": "spread",
    "typeName": "Handicap",
    "period": 0,
    "periodName": "Match",
    "team": null,
    "units": "Regular",
    "special": null,
    "isLive": false,
    "line": -2,
    "status": "open",
    "cutoffAt": "2026-10-07T20:30:00+00:00",
    "limits": [
      {
        "amount": 500,
        "type": "maxRiskStake"
      }
    ],
    "outcomes": [
      {
        "designation": "home",
        "name": "Vinotinto -2",
        "line": -2,
        "oddsAmerican": 226,
        "oddsDecimal": 3.26
      },
      {
        "designation": "away",
        "name": "Cuenca Juniors +2",
        "line": 2,
        "oddsAmerican": -315,
        "oddsDecimal": 1.317
      }
    ]
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the data is in the response body. |
| 400 | Bad Request | A required parameter is missing or invalid, or the `x-api-market-key` header is missing. The body explains which. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your API.market subscription does not include this endpoint. |
| 404 | Not Found | The requested item does not exist (`{"error":true,"message":"Not found"}`), or there is nothing to return right now. Not billed. |
| 429 | Too Many Requests | You went over 10 requests/second (free trial) or 300 requests/second (PAYG), or used all 100 trial calls. |
| 500 | Internal Server Error | Something failed while fetching the data. Retry after a short delay. |
| 503 | Service Unavailable | The data source is temporarily unavailable. Retry later. |

## Rate Limits

The free trial allows 10 requests per second and 100 API calls over 7 days. The PAYG plan allows up to 300 requests per second with no monthly quota. Requests above the limit return `429 Too Many Requests`; throttle your client, back off before retrying, and honour any `Retry-After` header.

## FAQ

**Is this the official Pinnacle API?**

No. This is an independent API that returns publicly visible data from the Pinnacle website. It is not an official Pinnacle product and is not affiliated with or endorsed by Pinnacle.

**Is there a free Pinnacle API?**

Yes, as a trial. The Free plan gives you 7 days and 100 API calls at up to 10 requests per second, so you can test the endpoints before paying.

**How much does the Pinnacle API cost?**

The pay-as-you-go plan has no monthly fee and costs US$0.001 per successful call, up to 300 requests per second, paid from your API.market wallet. Only successful (2xx) responses are billed.

**How do I find a match_id?**

Get a sport_id from /v1/sport/list, then list matches with /v1/sport/matches, /v1/league/matches (with a league_id from /v1/sport/leagues) or /v1/sport/matches/live. Each match in those lists has an id you pass as match_id.

**What happens if a match is not found?**

The API returns 404 with {"error":true,"message":"Not found"} and the call is not billed. Invalid parameters return 400. A prematch match can return 404 after kickoff, because the match in play is a separate event listed by /v1/sport/matches/live.

**Which odds formats are returned?**

Both. Every outcome has oddsAmerican and oddsDecimal, and handicap and total outcomes also include the line.

**Can I place bets through this API?**

No. The API is read-only and only returns publicly visible odds and fixtures. It has no account, betting or payment functions.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Pinnacle API for money line, handicap and totals odds in American and decimal format, plus fixtures and live matches in JSON. Free trial with 100 calls.

Pinnacle API: Odds, Lines, Fixtures and Live Matches

Free

ProAPI

PAYG

Pinnacle API for prematch and live sports odds: money line, handicap, totals and team totals in American and decimal format, with fixtures and live scores.