WebSocket API

Bu WebSocket, tekil fikstürlerdeki değişiklikler için gerçek zamanlı güncellemeler sağlar.

Bağlantı Detayları

• Uç nokta: wss://api.oddspapi.io/v4/ws?apiKey=YOUR_API_KEY
• Yön: Tek yönlü (sunucu → istemci)
• Kimlik Doğrulama: API Key — YOUR_API_KEY

Veri Yapısı

Tüm mesajlar şunları içerir: fixtureId. Yalnızca değişen değerler iletilir; aşağıdaki durumlar hariç: players nesneler tamamen gönderilir.

{
  "fixtureId": "string",
  "betradarId": "number?",
  "startTime": "number?",
  "participant1Id": "number?",
  "participant2Id": "number?",
  "sportId": "number?",
  "updatedAt": "string?",
  "tournamentId": "number?",
  "seasonId": "number|null",
  "sofascoreId": "number|null",
  "betgeniusId": "number|null",
  "flashscoreId": "string|null",
  "statusId": "number|null",
  "bookmakerOdds": {
    "bookmaker": {
      "bookmakerFixtureId": "string|null",
      "fixturePath": "string|null",
      "markets": {
        "marketId": {
          "bookmakerMarketId": "string|null",
          "outcomes": {
            "outcomeId": {
              "players": {
                "playerId": {
                  "limit": "number|null",
                  "price": "number",
                  "active": "boolean",
                  "oddsId": "string|null",
                  "betslip": "any|null",
                  "playerId": "number",
                  "changedAt": "string",
                  "playerName": "string|null",
                  "exchangeMeta": "any|null"
                }
              }
            }
          }
        }
      }
    }
  }
}

Temel Özellikler

• Kısmi Güncellemeler: Yalnızca değişen değerler gönderilir
• Tam Oyuncu Nesneleri: Herhangi bir değer değiştiğinde, oyuncu nesnesinin tamamı yeniden iletilir
• Tek Bahis Sitesi Güncellemeleri: Her mesaj yalnızca tek bir bahis sitesi için güncellemeler içerir
• Zaman Damgalama: updatedAt üst seviye herhangi bir alan güncellemesiyle birlikte değişir

Örnekler

Örnek 1: Fikstür Meta Verisi Güncellemesi

{
  "fixtureId": "id2704726161008023",
  "statusId": 1,
  "updatedAt": "2025-06-11T16:55:28.415401+00:00"
}

Örnek 2: Oyuncu Oranları Güncellemesi

{
  "fixtureId": "id1100097561092987",
  "bookmakerOdds": {
    "starcasino.be": {
      "markets": {
        "111": {
          "outcomes": {
            "111": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "2535416646",
                  "changedAt": "2025-06-11T16:55:30.284055+00:00",
                  "limit": null,
                  "playerName": null,
                  "price": 1.345,
                  "exchangeMeta": {},
                  "playerId": 0
                }
              }
            }
          }
        }
      }
    }
  }
}

Örnek 3: Bahis Sitesi Bilgisi Güncellemesi

{
  "fixtureId": "id1100023561139799",
  "bookmakerOdds": {
    "22bet": {
      "bookmakerFixtureId": "265591179",
      "fixturePath": "https://22bets.com/line/basketball/5226-e/265591179-kk-partizan-buducnost-podgorica"
    }
  }
}

Örnek 4: Birden Fazla Market Güncellemesi

{
  "fixtureId": "id1001509158796975",
  "bookmakerOdds": {
    "stake": {
      "markets": {
        "101": {
          "outcomes": {
            "101": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "2535416646",
                  "changedAt": "2025-06-11T16:55:30.284055+00:00",
                  "limit": null,
                  "playerName": null,
                  "price": 1.345,
                  "exchangeMeta": {},
                  "playerId": 0
                }
              }
            },
            "102": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "2535416646",
                  "changedAt": "2025-06-11T16:55:30.284055+00:00",
                  "limit": null,
                  "playerName": null,
                  "price": 1.345,
                  "exchangeMeta": {},
                  "playerId": 0
                }
              }
            }
          }
        }
      }
    }
  }
}

Örnek 5: Skor Güncellemesi

{
  "fixtureId": "id1000085362245214",
  "scores": {
    "periods": {
      "2": {
        "participant1Score": 0,
        "participant2Score": 0,
        "updatedAt": "2025-07-23T16:56:37.122614+00:00"
      }
    }
  }
}