Polymarket データ：ライブオーダーブック、APIと4つのデータ層

メタデータレイヤーは、取引されている質問を定義します：条件とトークン識別子、結果ラベル、市場ウィンドウ、解決ソース、および決済ルール。PolymarketのGamma APIは、ここでの真実の情報源であり、無料です。このレイヤーは取得が安価で過小評価されがちです — 下流のほとんどの照合バグは識別子バグです。なぜなら、Polymarket市場には複数の識別子（条件ID、結果ごとのトークンID、スラグ）があり、それらは相互に交換可能ではないからです。特定の期間のトークンIDにリサーチをバインドし、スラグは表示用にのみ保持してください。

価格レイヤーは、市場が取引または見積もられた場所の時系列です。方向性、予測精度および較正に関する質問に答え、それらにとって正しい入力です。その制限は解像度と意味にあります：最終価格のシリーズはその価格で取引があったことを示すだけで、あなたの注文が成立できたことを示すものではありません。短期市場では粗いシリーズは市場の全期間で数点しか持たず、戦略が行動した瞬間に一致しないこともあります。

PolymarketはPolygon上で決済されるため、実行済み取引とウォレット活動は公開観測可能であり、オンチェーンインデクサーがこのレイヤーをよくカバーしています。これはボリューム、フロー、ウォレット調査、リーダーボード分析の正しい情報源です。回復できないのはオーダーブックです：タッチの背後に深いサイズがあるものとほとんどないものの2つの非常に異なるオーダーブックが同一の取引テープを生み出すため、スリッページは取引だけからは導出できません。

注文板は、特定の瞬間の保留中の買い注文と売り注文です：価格、サイズ、および各側のラダーの深さ。注文が約定した場合、その約定価格とサイズがいくらだったかを回答できるのはこのレイヤーだけです。また、バックフィルできない唯一のレイヤーでもあります：瞬間が過ぎると、その瞬間の注文板の状態は、何か接続されて記録されていなければ失われます。Polymarketはライブ注文板をCLOB WebSocket経由でストリームしますが、そのアーカイブは提供しないため、履歴デプスはそれを継続的にキャプチャした当事者からのみ利用可能です。

DepthFeedは記録された層を1つのRESTインターフェースで提供します。ディスカバリーは市場の識別子とメタデータを返し、スナップショットルートは市場の記録観測を返します。include_orderbookは保存された階層を公開し、intervalはバケットごとに1つの記録行を選択します。ダウンサンプリングは補間ではなく実際の記録観測を選ぶため、ギャップは数値に平滑化されずギャップとして可視化されます。

検査や小規模フラット抽出にはCSV、大規模カラム型リサーチにはParquet、境界付きまたは増分クエリにはRESTを使用してください。フォーマットはバイトの配信方法を変えるべきであり、レコードの意味を変えてはなりません：市場識別子、取引所および受信タイムスタンプ、完全なビッドおよびアスクの価格とサイズ配列、決済フィールド、データ欠損箇所の明示的マーカーを保持してください。ラダーを単一価格に平坦化したデータセットは、データセット名を冠した価格系列です。

カバレッジには下限と形状があり、どちらも見出しの行数より重要です。アーカイブはキャプチャ開始地点から始まり、Polymarket開始地点ではありません。最も長く続くシリーズは最も過去に遡り、新しいコホートは後から始まります。レイテンシー数値はサービス保証ではなく測定サンプルを示します。市場がキャプチャされていない場合、答えは補間値ではなく明示的なギャップであり、これはバックテストに依存する場合により有用です。