| Both sides previous revision Previous revision Next revision | Previous revision |
| developers:apiv2:markets [2026/09/07 18:10] – [Market Data] chad | developers:apiv2:markets [2026/09/07 18:16] (current) – [What you receive] chad |
|---|
| **''ticker''** — when true, trade prints stream as [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L119|MarketTrade]] messages. | **''ticker''** — when true, trade prints stream as [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L119|MarketTrade]] messages. |
| |
| **Unsubscribe** — resend ''MarketSubscribe'' for the same market with ''quotes: QUOTES_NONE''. | **Unsubscribe** — Send a [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L9|MarketSubscribe]] for the same market with ''quotes: QUOTES_NONE''. |
| |
| ===== What you receive ===== | ===== What You Receive ===== |
| |
| **Quote Feed** (''TOP_OF_BOOK'' / ''FULL_ORDER_BOOK''): | **Quote Feed** (''TOP_OF_BOOK'' / ''FULL_ORDER_BOOK''): |
| * ''MarketSnapshot'' — full current state on subscribe (bundles depth, trades, high/low, price limits, settlement). | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L190|MarketSnapshot]] — full current state on subscribe (bundles depth, trades, high/low, price limits, settlement). |
| * ''MarketDepth'' — incremental bid/offer/implied updates thereafter. | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L79|MarketDepth]] — incremental bid/offer/implied updates thereafter. |
| |
| **Market by Order Feed** (''MARKET_BY_ORDER''): | **Market by Order Feed** (''MARKET_BY_ORDER''): |
| * ''MarketByOrderSnapshot'' — all resting orders plus ''last_sequence''. | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L213|MarketByOrderSnapshot]] — all resting orders plus ''last_sequence''. |
| * ''MarketByOrderUpdate'' — per-order changes; each has a ''sequence'' and ''updates[]'' of type ''ADD_OR_UPDATE'', ''DELETE'' or ''CLEAR''. Apply in order; on a gap, resubscribe. | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L231|MarketByOrderUpdate]] — per-order changes; each has a ''sequence'' and ''updates[]'' of type ''ADD_OR_UPDATE'', ''DELETE'' or ''CLEAR''. Apply in order; on a gap, resubscribe. |
| |
| **Ticker Feed** | **Ticker Feed** |
| * ''MarketTrade'' — when ''ticker'' is set. For an MBO subscription it also carries the trade ''sequence'' and the participating resting orders | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L119|MarketTrade]] — when ''ticker'' is set. For an MBO subscription it also carries the trade ''sequence'' and the participating resting orders |
| |
| **Always:** | **Always:** |
| * ''MarketDetails'' — the instrument definition. | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L29|MarketDetails]] — the instrument definition. |
| * ''MarketHighLow'', ''MarketPriceLimits'', ''MarketSettlement'' — as they occur. | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L144|MarketHighLow]], [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L155|MarketPriceLimits]], [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L165|MarketSettlement]] — as they occur. |
| * ''MarketSubscribeReject'' — subscription refused; check ''mode''. | * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L21|MarketSubscribeReject]] — subscription refused. |
| |
| Every message carries a ''mode'' (''MarketMode'': open, closed, halted, …) and a ''delayed'' flag. | |
| |
| ===== Reference ===== | |
| |
| Messages and every field: ''proto/t4/v2/market/market.proto''. Enums (''Quotes'', ''MarketMode'', ''BidOffer''): ''proto/t4/v2/common/enums.proto''. See the [[developers:apiv2:reference|Message Catalog]]. | |
| |