OddsPapi 体育博彩赔率 API 文档

本文档提供了您开始使用OddsPapi体育赔率API所需的一切信息。OddsPapi是一项实时体育数据服务,提供来自全球300多家博彩公司、涵盖60多种体育项目的实时赔率、赛前赔率、球员道具赔率、总分、让分盘口和历史赔率数据。只需几分钟,您就能学会如何使用API​​密钥进行身份验证、请求赛事和赛程、获取博彩公司赔率,并通过我们低延迟的WebSocket接口实时传输赔率变动。

步骤 1获取您的 API 密钥

Get your API key in your account settings

步骤 2获取某项运动的联赛

Get the list of tournaments for your favorite sports

详情请点击此处
curl "https://api.oddspapi.io/v4/tournaments?sportId=10&apiKey={{YOUR_API_KEY}}"
[
  {
    "tournamentId": 17,
    "tournamentSlug": "premier-league",
    "tournamentName": "Premier League",
    "categorySlug": "england",
    "categoryName": "England",
    "futureFixtures": 231,
    "upcomingFixtures": 0,
    "liveFixtures": 0
  },
  {
    "tournamentId": 8,
    "tournamentSlug": "laliga",
    "tournamentName": "LaLiga",
    "categorySlug": "spain",
    "categoryName": "Spain",
    "futureFixtures": 229,
    "upcomingFixtures": 0,
    "liveFixtures": 0
  },
  "{ /* more tournaments... */ }"
]

步骤 3按联赛获取即将举行的赛事和赔率

Get the tournaments ids from step 2 and separate them with commas to get a list of upcoming fixtures and odds from a bookmaker

Use the oddsFormat parameter to show odds in either decimal or American format

详情请点击此处
curl "https://api.oddspapi.io/v4/odds-by-tournaments?bookmaker=pinnacle&tournamentIds=17,8&apiKey={{YOUR_API_KEY}}"
[
  {
    "fixtureId": "id1000001764618978",
    "participant1Id": 3,
    "participant2Id": 35,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": 130281,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2025-12-08T20:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-12-02T08:01:48.812Z",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerIsActive": true,
        "bookmakerFixtureId": "1620599468",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1620599468/#all",
        "markets": {
          "101": {
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "home",
                    "changedAt": "2025-12-07T22:50:48.515996+00:00",
                    "limit": 5000,
                    "playerName": null,
                    "price": 5.01,
                    "exchangeMeta": {}
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "draw",
                    "changedAt": "2025-12-07T22:50:48.516257+00:00",
                    "limit": 5000,
                    "playerName": null,
                    "price": 4.32,
                    "exchangeMeta": {}
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "away",
                    "changedAt": "2025-12-07T22:50:48.516384+00:00",
                    "limit": 7704,
                    "playerName": null,
                    "price": 1.649,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "line/29/1980/1620128138/3377661430/0/moneyline"
          },
          "104": {
            "outcomes": {
              "104": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620599418",
                    "changedAt": "2025-12-07T21:33:08.962871+00:00",
                    "limit": 705,
                    "playerName": null,
                    "price": 1.709,
                    "exchangeMeta": {}
                  }
                }
              },
              "105": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620599419",
                    "changedAt": "2025-12-07T21:33:08.963137+00:00",
                    "limit": 500,
                    "playerName": null,
                    "price": 2.2,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "1620128138/5608638792/1620599417"
          }
        }
      }
    }
  },
  {
    "fixtureId": "id1000000861624232",
    "participant1Id": 2820,
    "participant2Id": 2849,
    "sportId": 10,
    "tournamentId": 8,
    "seasonId": 130805,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2025-12-08T20:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-11-30T14:00:59.994Z",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerIsActive": true,
        "bookmakerFixtureId": "1620613130",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1620613130/#all",
        "markets": {
          "101": {
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "home",
                    "changedAt": "2025-12-07T20:45:17.225169+00:00",
                    "limit": 9986,
                    "playerName": null,
                    "price": 1.751,
                    "exchangeMeta": {}
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "draw",
                    "changedAt": "2025-12-07T20:45:17.225297+00:00",
                    "limit": 7500,
                    "playerName": null,
                    "price": 3.89,
                    "exchangeMeta": {}
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "away",
                    "changedAt": "2025-12-07T20:45:17.225365+00:00",
                    "limit": 7500,
                    "playerName": null,
                    "price": 4.81,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "line/29/2196/1620122243/3377596534/0/moneyline"
          },
          "104": {
            "outcomes": {
              "104": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620613118",
                    "changedAt": "2025-12-07T20:45:15.476236+00:00",
                    "limit": 848,
                    "playerName": null,
                    "price": 1.884,
                    "exchangeMeta": {}
                  }
                }
              },
              "105": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620613119",
                    "changedAt": "2025-12-07T20:45:15.476405+00:00",
                    "limit": 773,
                    "playerName": null,
                    "price": 1.97,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "1620122243/5608474224/1620613117"
          }
        }
      }
    }
  },
  "{ /* more fixtures... */ }"
]

Host

所有请求都使用以下 host: https://api.oddspapi.io

认证方式

所有端点都要求在请求参数中传入 API 密钥:

参数
认证方式apiKey{{YOUR_API_KEY}}

联系我们

如果你有任何问题、需要帮助,或想报告问题,请发送邮件至 [email protected].

下一页GET account
报告问题
OddsPapi | 文档概览