Skip to Content
GrundkonzepteDas Feld `timestamp`

Das Feld timestamp verstehen

Jede Quotenzeile in der SharpAPI-Antwort trägt ein einziges timestamp-Feld. Es beantwortet eine Frage: Wie frisch ist dieser Wert in unserer Pipeline? Diese Seite erklärt, was timestamp tatsächlich erfasst, warum es in jedem Refresh-Zyklus weitergeschaltet wird und warum SharpAPI kein separates Feld mehr dafür bereitstellt, „wann sich der Preis zuletzt geändert hat”.

Was timestamp tatsächlich bedeutetPermalink for this section

timestamp ist der ISO-8601-Zeitpunkt, zu dem SharpAPI diese Quote zuletzt durch seine Pipeline aktualisiert hat. Es ist ein Auslieferungs- / Feed-Aktualitätssignal — es wird bei jedem Ingest-Zyklus weitergeschaltet, in dem die Zeile beobachtet wurde, unabhängig davon, ob sich der zugrunde liegende Preis bewegt hat.

Dies entspricht dem timestamp-Feld von OpticOdds: Es ist ein Liveness-Indikator, kein Preisbewegungs-Indikator. Ein frisches timestamp bedeutet, dass der Feed aktiv ist und die Zeile aktuell ist; ein veraltetes timestamp bedeutet, dass die Pipeline diese Zeile eine Weile nicht mehr gesehen hat und eine Untersuchung wert ist.

timestamp ist nicht der Zeitpunkt, zu dem sich der Preis zuletzt geändert hat. SharpAPI stellt kein separates Feld mehr dafür bereit, wann sich Preis, Linie oder das is_live-Flag zuletzt bewegt haben. Behandeln Sie timestamp ausschließlich als Aktualitäts- / Liveness-Signal.

Warum es kein separates „Preisänderungs”-Feld mehr gibtPermalink for this section

Frühere API-Versionen stellten mehrere Zeitstempel pro Zeile bereit (odds_changed_at, last_seen_at, wire_received_at), die versuchten, „wann sich der Preis bewegt hat” von „wann wir die Zeile gesehen haben” zu unterscheiden. In der Praxis war diese Unterscheidung über alle Buchmacher hinweg unzuverlässig: Nur wenige Quellen liefern einen vertrauenswürdigen quelleneigenen Preisänderungs-Zeitstempel, und die Übertragung dieser Werte über unveränderte Refreshes hinweg führte zu Verwirrung — insbesondere bei Sharp-Büchern wie Pinnacle, die Linien lange Zeit konstant halten.

Ab v3.0.0 konsolidiert SharpAPI auf ein einziges timestamp-Feld mit klarer Auslieferungs-/Aktualitätssemantik und entspricht damit dem Verhalten von OpticOdds. Wenn Sie auf eines der entfernten Felder angewiesen waren, lesen Sie stattdessen timestamp.

Warum ein frisches timestamp nicht „Preis hat sich bewegt” bedeutetPermalink for this section

Pinnacle ist ein Market-Maker. Deren Trading-Desk veröffentlicht nur dann einen neuen Preis, wenn tatsächlicher Flow eine Neubepreisung erzwingt — sie schattieren keine Linien um Retail-Action, um Marge herauszupressen, wie es Soft Books tun. Diese Disziplin ist der Grund, warum Pinnacle als Sharp-Referenz für +EV-Berechnungen verwendet wird, aber es bedeutet auch, dass Linien lange Zeit unverändert bleiben können.

Beobachtet über ein 24-Stunden-Fenster von Pinnacles eigenen CDN-Antworten variiert die Rate, mit der Pinnacle neue Daten veröffentlicht hat (anstelle eines zwischengespeicherten 304 Not Modified), enorm je nach Sportart:

SportartPinnacle CDN “neue Daten”-Rate
Fußball~94 %
Tennis~66 %
NHL~51 %
MLB~18 %
NBA~9 %

NBA- und MLB-Spielerprops zeigen häufig lange Zeiträume, in denen der Preis konstant bleibt — 30+ Minuten sind nicht ungewöhnlich — weil Pinnacles Trading-Desk die Linie nicht bewegt. Während dieser Phasen wird timestamp trotzdem in jedem Ingest-Zyklus weitergeschaltet: Der Feed ist aktiv, auch wenn sich der Preis nicht ändert. Ein frisches timestamp bestätigt, dass die Zeile aktuell ist, nicht dass sich der Preis gerade bewegt hat.

Wie timestamp zu lesen istPermalink for this section

{
  "sportsbook": "pinnacle",
  "market_type": "player_total_bases",
  "selection": "Edmundo Sosa Over",
  "line": 0.5,
  "odds_american": -129,
  "timestamp": "2026-04-21T21:35:02Z"
}

In diesem Beispiel hat die Pipeline diese Zeile wenige Sekunden vor dem Abruf durch den Client aktualisiert (timestamp ist frisch). Der angezeigte Preis ist aktuell — Pinnacles Trading-Desk hat Sosas Total-Bases-Linie möglicherweise seit Stunden nicht neu bepreist, aber der Feed liefert sie weiterhin aktiv aus.

Wenn timestamp veraltet ist (mehr als eine oder zwei Minuten alt bei einem Major-League-Markt), ist das ein Pipeline-Signal, das eine Untersuchung wert ist. Wenn timestamp frisch ist, behandeln Sie den angezeigten Preis als aktuell — auch dann, wenn Pinnacle die Linie über einen langen Zeitraum konstant gehalten hat.

Warum Pinnacle anders istPermalink for this section

Pinnacle akzeptiert Sharp-Action und bepreist basierend auf echtem Flow neu, anstatt Linien um Retail-Wetter zu schattieren. Diese Market-Maker-Disziplin ist der Grund, warum wir sie als Devig-Referenz für +EV verwenden — ihre Linien sind dem fairen Preis am Markt am nächsten. Der Kompromiss ist, dass Pre-Match-Linien lange Zeit unverändert bleiben können, wenn sich nichts am Markt bewegt hat. Da timestamp ausschließlich Feed-Aktualität misst, ist das kein Problem: Ein frisches timestamp bei einer seit Stunden stabilen Pinnacle-Linie ist genau das erwartete Verhalten.

Verwandte ThemenPermalink for this section

Last updated on
Live vs. Pre-MatchPolymarket-Auflösung