Das Feld timestamp verstehen
Jede Quotenzeile in der SharpAPI-Antwort trägt ein 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 was price_updated_at angibt: wann sich der Preis zuletzt geändert hat.
Was timestamp tatsächlich bedeutetPermalink zu diesem Abschnitt
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 in jedem Ingest-Zyklus weitergeschaltet, in dem die Zeile ausgeliefert wird, unabhängig davon, ob sich der zugrunde liegende Preis bewegt hat.
Damit ist es ein Liveness-Indikator, kein Preisbewegungs-Indikator. Ein frisches timestamp bedeutet, dass der Feed aktiv ist und die Zeile aktiv gepflegt wird; es sagt nicht, wann der Trading-Desk den Preis zuletzt neu gesetzt hat. 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. Das gibt price_updated_at an, siehe unten. Behandeln Sie timestamp ausschließlich als Aktualitäts- / Liveness-Signal.
price_updated_at: wann sich der Preis zuletzt geändert hatPermalink zu diesem Abschnitt
Quotenzeilen tragen außerdem price_updated_at: den ISO-8601-Zeitpunkt, zu dem der Preis der Zeile zuletzt aktualisiert wurde, im selben Format wie timestamp. Das Feld steht bei /odds, /odds/batch, /odds/delta, /events/{id}/odds, /odds/best, /odds/comparison und in den Quotenzeilen der SSE- und WebSocket-Streams.
- Es rückt vor, wenn sich Preis, Linie, Live-Status oder Aussetzung ändern, und wenn sich das Orderbuch oder die verfügbare Größe ändert (bester Bid oder Ask,
best_bid_liquidity,total_liquidity,max_bet). Es rückt nicht vor, wenn SharpAPI eine unveränderte Zeile erneut liest, sodass ein seit Stunden eingefrorener Preis Stunden alt ist. - Bei den meisten Buchmachern ist es der Zeitpunkt, zu dem SharpAPI den neuen Wert zuerst gesehen hat. Bei einigen wenigen Buchmachern, die eine verlässliche eigene Änderungszeit senden, ist es deren Zeit.
- Wenn SharpAPI eine Zeile neu verfolgt, etwa nach einem Neustart, ist der erste Wert der Zeitpunkt, zu dem SharpAPI die Zeile zuerst gesehen hat, nicht unbedingt der, zu dem der Buchmacher den Preis zuletzt bewegt hat.
- Fehlt, wenn eine Zeile keine Änderungszeit hat.
- Bei
/odds/bestist es die Zeit des Preises des besten Buchmachers (des inbest_bookgenannten), nicht die jüngste Zeit über alle Buchmacher. Bei/odds/comparisonträgt jeder Buchmacher seine eigene. - Die Streams und
/odds/deltasenden eine Zeile erneut, wenn sich ihr Preis, ihre Linie, ihr Status oder andere Zeilenfelder ändern. Eine Änderung nur im Orderbuch oder an der verfügbaren Größe verschiebtprice_updated_atbei/odds, wird aber womöglich nicht allein gesendet; die neue Zeit kommt mit dem nächsten Update dieser Zeile.
Bei einer ruhigen Pinnacle-Linie rückt timestamp weiter vor, während price_updated_at Stunden alt sein kann. Beides ist korrekt.
Die früheren Felder odds_changed_at, last_seen_at und wire_received_at wurden in v3.0.0 entfernt.
Warum ein frisches timestamp nicht „Preis hat sich bewegt” bedeutetPermalink zu diesem Abschnitt
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:
| Sportart | Pinnacle 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 aktiv ausgeliefert wird — nicht dass sich der Preis gerade bewegt hat.
Wie timestamp zu lesen istPermalink zu diesem Abschnitt
{
"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 zuletzt um 21:35:02Z aktualisiert. Solange dieser Wert in jedem Zyklus weiterrückt, wird die Zeile aktiv ausgeliefert. Das sagt allein noch nicht, ob der Preis in diesem Zyklus erneut von der Quelle beobachtet wurde — Pinnacles Trading-Desk hat Sosas Total-Bases-Linie möglicherweise seit Stunden nicht neu bepreist, der Feed liefert sie aber weiterhin aktiv aus.
timestamp ist ein Auslieferungsstempel, kein Preisalter-Stempel — verwenden Sie ihn nicht als einziges Frischesignal. Wenn er bei einem Major-League-Markt aufhört, voranzuschreiten, ist das ein Signal, das eine Untersuchung wert ist. Wenn er weiter voranzuschreitet, wird die Zeile aktiv ausgeliefert; das sagt allein noch nicht, ob der Preis in diesem Zyklus erneut von der Quelle beobachtet wurde.
Warum Pinnacle anders istPermalink zu diesem Abschnitt
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 zu diesem Abschnitt
- Odds-Snapshot — das Feld
timestampin der REST-Odds-Antwort - Streaming —
timestampbeiodds:update-Deltas - Live vs. Pre-Match — Veröffentlichungstakt und Lieferungsmechanismen der Buchmacher
- EV-Berechnung — warum Pinnacle die Sharp-Referenz ist