| Both sides previous revision Previous revision Next revision | Previous revision |
| developers:apiv2:pricing [2026/09/07 22:20] – [Price format] chad | developers:apiv2:pricing [2026/09/07 22:23] (current) – [Ticks and cash value] chad |
|---|
| Set [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/common/enums.proto#L35|PriceFormat]] on [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/auth/auth.proto#L9|LoginRequest]] to choose how ''Price'' strings are formatted: | Set [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/common/enums.proto#L35|PriceFormat]] on [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/auth/auth.proto#L9|LoginRequest]] to choose how ''Price'' strings are formatted: |
| |
| | <WRAP 75%> |
| ^ PriceFormat ^ Description ^ Example (ES) ^ | ^ PriceFormat ^ Description ^ Example (ES) ^ |
| | ''PRICE_FORMAT_REAL'' | Human-readable decimal placement used by most trading UIs. | <code>5954.75</code> | | | ''PRICE_FORMAT_REAL'' | Human-readable decimal placement used by most trading UIs. | <code>5954.75</code> | |
| | ''PRICE_FORMAT_DECIMAL'' | Raw exchange representation, without UI-friendly decimal placement. | <code>595475</code> | | | ''PRICE_FORMAT_DECIMAL'' | Raw exchange representation, without UI-friendly decimal placement. | <code>595475</code> | |
| | ''PRICE_FORMAT_CLEARING_DECIMAL'' | Typically used for data imports and exports only. | <code>595475</code> | | | ''PRICE_FORMAT_CLEARING_DECIMAL'' | Typically used for data imports and exports only. | <code>595475</code> | |
| | </WRAP> |
| |
| ===== Ticks and cash value ===== | See [[developers:systempricing|System Price Format]] for more information. |
| |
| * ''min_price_increment'' (in ''MarketDetails'') is the tick — the smallest valid price step. e.g. tick ''25'' → …, 4000.00, 4025.00, 4050.00, … | |
| * ''point_value'' (in ''MarketDetails'') converts a price move to cash: ''(price2 − price1) × point_value''. e.g. 4200.00→4225.00 at ''point_value'' 0.5 = 12.50 per contract. | |
| |
| ===== Timestamps, dates and ids ===== | |
| |
| * **Timestamps** — ''google.protobuf.Timestamp'' (UTC). ''Heartbeat.timestamp'' is UTC epoch **milliseconds**. | |
| * **Dates** — ''trade_date'' and similar are ''int64'' date values. | |
| * **Ids** — ''exchange_id'', ''contract_id'', ''market_id'', ''account_id'', ''user_id'' are strings, obtained from login and the [[developers:markets|Instruments API]]. | |
| |
| ===== Reference ===== | |
| |
| ''proto/t4/v2/common/price.proto'' and ''proto/t4/v2/common/enums.proto''. | |
| |