マーケットカタログAPI

/api/v1/markets/query エンドポイントは、マーケット一覧や検索フローで使う公開マーケットカタログを返します。各項目は MarketCatalogueEntry で、マーケット識別子、アウトカム、ライフサイクル状態、作成者が設定した表示メタデータ、カテゴリタグ、取引サマリ指標を含みます。

カタログは、表示用の累計指標として次の3つを公開します。

フィールド	型	意味
liquiditySats	int64	互換性のための旧フィールド名。そのマーケットの注文板に現在残っている注文の額面合計。単位はマーケット担保の基本サブユニットで、sat マーケットでは sats、USD マーケットでは cents。
traderCount	int32	そのマーケットで約定済み取引を決済した重複なしのトレーダー数。
volumeLifetimeSats	int64	そのマーケットの履歴全体における全約定の決済済み担保額面の累計。

レスポンスには、ローリング出来高やソート用の volume24hSats と volume30dSats も含まれます。*Sats サフィックスはワイヤ互換性のために残っています。非 sat マーケットでは、これらのフィールドはマーケット担保の基本サブユニットを使います。クライアントがマーケットの Volume、Liquidity、Traders 指標を表示する場合は、volumeLifetimeSats、liquiditySats、traderCount を使ってください。

ライフサイクルのリアルタイム更新

マーケットのライフサイクル状態は、クライアントが閲覧している最中に変化することがあります。リアルタイムフィードでマーケットを購読しているクライアントは、コンディションの状態が遷移したとき—たとえばオラクルのアテステーションが到着するか解決期限を過ぎて open から closed になったとき—に MarketStatusChanged のプッシュを受け取ります。このメッセージは conditionId、新しい state（open または closed）、マーケットがクローズした後の closedAt タイムスタンプ、そしてアウトカムが確定している場合の勝利アウトカム finalOutcome を含みます。プッシュは、そのコンディションのいずれかのアウトカム別マーケットに参加しているクライアントに届きます。状態の正となるのは引き続きカタログの state フィールドです。遷移後に接続または再接続したクライアントは、プッシュを受け取っていたかどうかに依存せず、/api/v1/markets/query から現在の状態を読み取ります。