@clear-street/clearstreet 0.76.0 → 0.78.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/client.d.mts +2 -2
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +2 -2
  5. package/client.d.ts.map +1 -1
  6. package/client.js +9 -1
  7. package/client.js.map +1 -1
  8. package/client.mjs +9 -1
  9. package/client.mjs.map +1 -1
  10. package/package.json +1 -1
  11. package/resources/index.d.mts +1 -1
  12. package/resources/index.d.mts.map +1 -1
  13. package/resources/index.d.ts +1 -1
  14. package/resources/index.d.ts.map +1 -1
  15. package/resources/index.js.map +1 -1
  16. package/resources/index.mjs.map +1 -1
  17. package/resources/v1/accounts.d.mts +38 -13
  18. package/resources/v1/accounts.d.mts.map +1 -1
  19. package/resources/v1/accounts.d.ts +38 -13
  20. package/resources/v1/accounts.d.ts.map +1 -1
  21. package/resources/v1/calendar.d.mts +10 -5
  22. package/resources/v1/calendar.d.mts.map +1 -1
  23. package/resources/v1/calendar.d.ts +10 -5
  24. package/resources/v1/calendar.d.ts.map +1 -1
  25. package/resources/v1/index.d.mts +3 -2
  26. package/resources/v1/index.d.mts.map +1 -1
  27. package/resources/v1/index.d.ts +3 -2
  28. package/resources/v1/index.d.ts.map +1 -1
  29. package/resources/v1/index.js +3 -1
  30. package/resources/v1/index.js.map +1 -1
  31. package/resources/v1/index.mjs +1 -0
  32. package/resources/v1/index.mjs.map +1 -1
  33. package/resources/v1/instrument-data/instrument-data.d.mts +90 -45
  34. package/resources/v1/instrument-data/instrument-data.d.mts.map +1 -1
  35. package/resources/v1/instrument-data/instrument-data.d.ts +90 -45
  36. package/resources/v1/instrument-data/instrument-data.d.ts.map +1 -1
  37. package/resources/v1/instrument-data/instrument-data.js.map +1 -1
  38. package/resources/v1/instrument-data/instrument-data.mjs.map +1 -1
  39. package/resources/v1/instrument-data/market-data.d.mts +29 -14
  40. package/resources/v1/instrument-data/market-data.d.mts.map +1 -1
  41. package/resources/v1/instrument-data/market-data.d.ts +29 -14
  42. package/resources/v1/instrument-data/market-data.d.ts.map +1 -1
  43. package/resources/v1/instrument-data/news.d.mts +10 -5
  44. package/resources/v1/instrument-data/news.d.mts.map +1 -1
  45. package/resources/v1/instrument-data/news.d.ts +10 -5
  46. package/resources/v1/instrument-data/news.d.ts.map +1 -1
  47. package/resources/v1/instruments.d.mts +44 -22
  48. package/resources/v1/instruments.d.mts.map +1 -1
  49. package/resources/v1/instruments.d.ts +44 -22
  50. package/resources/v1/instruments.d.ts.map +1 -1
  51. package/resources/v1/omni-ai/index.d.mts +1 -1
  52. package/resources/v1/omni-ai/index.d.mts.map +1 -1
  53. package/resources/v1/omni-ai/index.d.ts +1 -1
  54. package/resources/v1/omni-ai/index.d.ts.map +1 -1
  55. package/resources/v1/omni-ai/index.js.map +1 -1
  56. package/resources/v1/omni-ai/index.mjs.map +1 -1
  57. package/resources/v1/omni-ai/messages.d.mts +4 -0
  58. package/resources/v1/omni-ai/messages.d.mts.map +1 -1
  59. package/resources/v1/omni-ai/messages.d.ts +4 -0
  60. package/resources/v1/omni-ai/messages.d.ts.map +1 -1
  61. package/resources/v1/omni-ai/omni-ai.d.mts +27 -29
  62. package/resources/v1/omni-ai/omni-ai.d.mts.map +1 -1
  63. package/resources/v1/omni-ai/omni-ai.d.ts +27 -29
  64. package/resources/v1/omni-ai/omni-ai.d.ts.map +1 -1
  65. package/resources/v1/omni-ai/omni-ai.js.map +1 -1
  66. package/resources/v1/omni-ai/omni-ai.mjs.map +1 -1
  67. package/resources/v1/omni-ai/responses.d.mts +9 -2
  68. package/resources/v1/omni-ai/responses.d.mts.map +1 -1
  69. package/resources/v1/omni-ai/responses.d.ts +9 -2
  70. package/resources/v1/omni-ai/responses.d.ts.map +1 -1
  71. package/resources/v1/omni-ai/threads.d.mts +1 -1
  72. package/resources/v1/omni-ai/threads.d.ts +1 -1
  73. package/resources/v1/orders.d.mts +30 -15
  74. package/resources/v1/orders.d.mts.map +1 -1
  75. package/resources/v1/orders.d.ts +30 -15
  76. package/resources/v1/orders.d.ts.map +1 -1
  77. package/resources/v1/positions.d.mts +33 -14
  78. package/resources/v1/positions.d.mts.map +1 -1
  79. package/resources/v1/positions.d.ts +33 -14
  80. package/resources/v1/positions.d.ts.map +1 -1
  81. package/resources/v1/screener.d.mts +396 -0
  82. package/resources/v1/screener.d.mts.map +1 -0
  83. package/resources/v1/screener.d.ts +396 -0
  84. package/resources/v1/screener.d.ts.map +1 -0
  85. package/resources/v1/screener.js +107 -0
  86. package/resources/v1/screener.js.map +1 -0
  87. package/resources/v1/screener.mjs +103 -0
  88. package/resources/v1/screener.mjs.map +1 -0
  89. package/resources/v1/v1.d.mts +11 -3
  90. package/resources/v1/v1.d.mts.map +1 -1
  91. package/resources/v1/v1.d.ts +11 -3
  92. package/resources/v1/v1.d.ts.map +1 -1
  93. package/resources/v1/v1.js +4 -0
  94. package/resources/v1/v1.js.map +1 -1
  95. package/resources/v1/v1.mjs +4 -0
  96. package/resources/v1/v1.mjs.map +1 -1
  97. package/resources/v1/watchlist.d.mts +4 -2
  98. package/resources/v1/watchlist.d.mts.map +1 -1
  99. package/resources/v1/watchlist.d.ts +4 -2
  100. package/resources/v1/watchlist.d.ts.map +1 -1
  101. package/src/client.ts +11 -3
  102. package/src/resources/index.ts +1 -1
  103. package/src/resources/v1/accounts.ts +41 -13
  104. package/src/resources/v1/calendar.ts +10 -5
  105. package/src/resources/v1/index.ts +31 -2
  106. package/src/resources/v1/instrument-data/instrument-data.ts +90 -45
  107. package/src/resources/v1/instrument-data/market-data.ts +29 -14
  108. package/src/resources/v1/instrument-data/news.ts +10 -5
  109. package/src/resources/v1/instruments.ts +44 -22
  110. package/src/resources/v1/omni-ai/index.ts +0 -1
  111. package/src/resources/v1/omni-ai/messages.ts +4 -0
  112. package/src/resources/v1/omni-ai/omni-ai.ts +27 -32
  113. package/src/resources/v1/omni-ai/responses.ts +9 -2
  114. package/src/resources/v1/omni-ai/threads.ts +1 -1
  115. package/src/resources/v1/orders.ts +30 -15
  116. package/src/resources/v1/positions.ts +35 -14
  117. package/src/resources/v1/screener.ts +550 -0
  118. package/src/resources/v1/v1.ts +70 -3
  119. package/src/resources/v1/watchlist.ts +4 -2
  120. package/src/version.ts +1 -1
  121. package/version.d.mts +1 -1
  122. package/version.d.ts +1 -1
  123. package/version.js +1 -1
  124. package/version.mjs +1 -1
@@ -124,7 +124,8 @@ export interface MarketStatus {
124
124
  is_open: boolean;
125
125
 
126
126
  /**
127
- * Current session type if market is open, null if closed
127
+ * Current session type if market is open, null if closed When a null/undefined
128
+ * value is observed, it indicates it does not apply.
128
129
  */
129
130
  current_session?: MarketSessionType | null;
130
131
  }
@@ -150,12 +151,13 @@ export interface SessionSchedule {
150
151
 
151
152
  /**
152
153
  * ISO 8601 duration until session closes. Null if session is not currently open.
154
+ * When a null/undefined value is observed, it indicates it does not apply.
153
155
  */
154
156
  time_until_close?: string | null;
155
157
 
156
158
  /**
157
159
  * ISO 8601 duration until session opens. Null if session has already started or
158
- * closed.
160
+ * closed. When a null/undefined value is observed, it indicates it does not apply.
159
161
  */
160
162
  time_until_open?: string | null;
161
163
  }
@@ -165,17 +167,20 @@ export interface SessionSchedule {
165
167
  */
166
168
  export interface TradingSessions {
167
169
  /**
168
- * After-hours session schedule, null if not available
170
+ * After-hours session schedule, null if not available When a null/undefined value
171
+ * is observed, it indicates it does not apply.
169
172
  */
170
173
  after_hours?: SessionSchedule | null;
171
174
 
172
175
  /**
173
- * Pre-market session schedule, null if not available
176
+ * Pre-market session schedule, null if not available When a null/undefined value
177
+ * is observed, it indicates it does not apply.
174
178
  */
175
179
  pre_market?: SessionSchedule | null;
176
180
 
177
181
  /**
178
- * Regular trading session schedule, null if holiday/weekend
182
+ * Regular trading session schedule, null if holiday/weekend When a null/undefined
183
+ * value is observed, it indicates it does not apply.
179
184
  */
180
185
  regular?: SessionSchedule | null;
181
186
  }
@@ -122,7 +122,6 @@ export {
122
122
  type PrefillNewOrderAction,
123
123
  type PrefillOrderAction,
124
124
  type PromptButtonAction,
125
- type ScreenerFilter,
126
125
  type StructuredAction,
127
126
  type StructuredActionButtonAction,
128
127
  type SuggestedActionsPayload,
@@ -182,7 +181,37 @@ export {
182
181
  type PositionGetPositionsParams,
183
182
  type PositionSubmitPositionInstructionsParams,
184
183
  } from './positions';
185
- export { V1, type SecurityType } from './v1';
184
+ export {
185
+ Screener,
186
+ type FieldLookback,
187
+ type FieldPeriod,
188
+ type FieldRef,
189
+ type FieldType,
190
+ type FilterOpSpec,
191
+ type FilterOperator,
192
+ type FilterValue,
193
+ type Modifier,
194
+ type ModifierOp,
195
+ type OperatorArg,
196
+ type ScreenerColumn,
197
+ type ScreenerEntry,
198
+ type ScreenerEntryList,
199
+ type ScreenerFilter,
200
+ type ScreenerRow,
201
+ type ScreenerRowList,
202
+ type SearchFilter,
203
+ type SortSpec,
204
+ type Variable,
205
+ type ScreenerCreateScreenerResponse,
206
+ type ScreenerGetScreenerByIDResponse,
207
+ type ScreenerGetScreenersResponse,
208
+ type ScreenerReplaceScreenerResponse,
209
+ type ScreenerSearchScreenerResponse,
210
+ type ScreenerCreateScreenerParams,
211
+ type ScreenerReplaceScreenerParams,
212
+ type ScreenerSearchScreenerParams,
213
+ } from './screener';
214
+ export { V1, type SecurityType, type SortDirection } from './v1';
186
215
  export {
187
216
  Watchlist,
188
217
  type AddWatchlistItemData,
@@ -264,17 +264,20 @@ export interface InstrumentAnalystConsensus {
264
264
  date: string;
265
265
 
266
266
  /**
267
- * Count of individual analyst recommendations by category
267
+ * Count of individual analyst recommendations by category When a null/undefined
268
+ * value is observed, it indicates that there is no available data.
268
269
  */
269
270
  distribution?: AnalystDistribution | null;
270
271
 
271
272
  /**
272
- * Aggregated analyst price target statistics
273
+ * Aggregated analyst price target statistics When a null/undefined value is
274
+ * observed, it indicates that there is no available data.
273
275
  */
274
276
  price_target?: PriceTarget | null;
275
277
 
276
278
  /**
277
- * Consensus analyst rating
279
+ * Consensus analyst rating When a null/undefined value is observed, it indicates
280
+ * that there is no available data.
278
281
  */
279
282
  rating?: AnalystRating | null;
280
283
  }
@@ -823,35 +826,41 @@ export interface InstrumentDividendEvent {
823
826
  ex_date: string;
824
827
 
825
828
  /**
826
- * The declaration date of the dividend
829
+ * The declaration date of the dividend When a null/undefined value is observed, it
830
+ * indicates that there is no available data.
827
831
  */
828
832
  declaration_date?: string | null;
829
833
 
830
834
  /**
831
- * The dividend amount per share.
835
+ * The dividend amount per share. When a null/undefined value is observed, it
836
+ * indicates that there is no available data.
832
837
  */
833
838
  dividend_amount?: string | null;
834
839
 
835
840
  /**
836
- * The dividend yield as a percentage of the stock price.
841
+ * The dividend yield as a percentage of the stock price. When a null/undefined
842
+ * value is observed, it indicates that there is no available data.
837
843
  */
838
844
  dividend_yield?: string | null;
839
845
 
840
846
  /**
841
- * The frequency of the dividend payments (e.g., "Quarterly", "Annual").
847
+ * The frequency of the dividend payments (e.g., "Quarterly", "Annual"). When a
848
+ * null/undefined value is observed, it indicates that there is no available data.
842
849
  */
843
850
  frequency?: string | null;
844
851
 
845
852
  /**
846
853
  * The payment date is the date on which a declared stock dividend is scheduled to
847
- * be paid.
854
+ * be paid. When a null/undefined value is observed, it indicates that there is no
855
+ * available data.
848
856
  */
849
857
  payment_date?: string | null;
850
858
 
851
859
  /**
852
860
  * The record date, set by a company's board of directors, is when a company
853
861
  * compiles a list of shareholders of the stock for which it has declared a
854
- * dividend.
862
+ * dividend. When a null/undefined value is observed, it indicates that there is no
863
+ * available data.
855
864
  */
856
865
  record_date?: string | null;
857
866
  }
@@ -866,32 +875,38 @@ export interface InstrumentEarnings {
866
875
  date: string;
867
876
 
868
877
  /**
869
- * The actual earnings per share (EPS) for the period
878
+ * The actual earnings per share (EPS) for the period When a null/undefined value
879
+ * is observed, it indicates that there is no available data.
870
880
  */
871
881
  eps_actual?: string | null;
872
882
 
873
883
  /**
874
- * The estimated earnings per share (EPS) for the period
884
+ * The estimated earnings per share (EPS) for the period When a null/undefined
885
+ * value is observed, it indicates that there is no available data.
875
886
  */
876
887
  eps_estimate?: string | null;
877
888
 
878
889
  /**
879
- * The percentage difference between actual and estimated EPS
890
+ * The percentage difference between actual and estimated EPS When a null/undefined
891
+ * value is observed, it indicates that there is no available data.
880
892
  */
881
893
  eps_surprise_percent?: string | null;
882
894
 
883
895
  /**
884
- * The actual total revenue for the period
896
+ * The actual total revenue for the period When a null/undefined value is observed,
897
+ * it indicates that there is no available data.
885
898
  */
886
899
  revenue_actual?: string | null;
887
900
 
888
901
  /**
889
- * The estimated total revenue for the period
902
+ * The estimated total revenue for the period When a null/undefined value is
903
+ * observed, it indicates that there is no available data.
890
904
  */
891
905
  revenue_estimate?: string | null;
892
906
 
893
907
  /**
894
- * The percentage difference between actual and estimated revenue
908
+ * The percentage difference between actual and estimated revenue When a
909
+ * null/undefined value is observed, it indicates that there is no available data.
895
910
  */
896
911
  revenue_surprise_percent?: string | null;
897
912
  }
@@ -911,37 +926,44 @@ export interface InstrumentEventEnvelope {
911
926
  type: AllEventsEventType;
912
927
 
913
928
  /**
914
- * Dividend payload when type is DIVIDEND.
929
+ * Dividend payload when type is DIVIDEND. When a null/undefined value is observed,
930
+ * it indicates it does not apply.
915
931
  */
916
932
  dividend_event_data?: InstrumentDividendEvent | null;
917
933
 
918
934
  /**
919
- * Earnings payload when type is EARNINGS.
935
+ * Earnings payload when type is EARNINGS. When a null/undefined value is observed,
936
+ * it indicates it does not apply.
920
937
  */
921
938
  earnings_event_data?: InstrumentEarnings | null;
922
939
 
923
940
  /**
924
- * Instrument identifier, when available.
941
+ * Instrument identifier, when available. When a null/undefined value is observed,
942
+ * it indicates that there is no available data.
925
943
  */
926
944
  instrument_id?: string | null;
927
945
 
928
946
  /**
929
- * IPO payload when type is IPO.
947
+ * IPO payload when type is IPO. When a null/undefined value is observed, it
948
+ * indicates it does not apply.
930
949
  */
931
950
  ipo_event_data?: InstrumentEventIpoItem | null;
932
951
 
933
952
  /**
934
- * Instrument name associated with the event, when available.
953
+ * Instrument name associated with the event, when available. When a null/undefined
954
+ * value is observed, it indicates that there is no available data.
935
955
  */
936
956
  name?: string | null;
937
957
 
938
958
  /**
939
- * The currency used for reporting financial data.
959
+ * The currency used for reporting financial data. When a null/undefined value is
960
+ * observed, it indicates that there is no available data.
940
961
  */
941
962
  reporting_currency?: string | null;
942
963
 
943
964
  /**
944
- * Stock split payload when type is STOCK_SPLIT.
965
+ * Stock split payload when type is STOCK_SPLIT. When a null/undefined value is
966
+ * observed, it indicates it does not apply.
945
967
  */
946
968
  stock_split_event_data?: InstrumentSplitEvent | null;
947
969
  }
@@ -951,37 +973,44 @@ export interface InstrumentEventEnvelope {
951
973
  */
952
974
  export interface InstrumentEventIpoItem {
953
975
  /**
954
- * IPO action.
976
+ * IPO action. When a null/undefined value is observed, it indicates that there is
977
+ * no available data.
955
978
  */
956
979
  actions?: string | null;
957
980
 
958
981
  /**
959
- * IPO announced timestamp.
982
+ * IPO announced timestamp. When a null/undefined value is observed, it indicates
983
+ * that there is no available data.
960
984
  */
961
985
  announced_at?: string | null;
962
986
 
963
987
  /**
964
- * IPO company name.
988
+ * IPO company name. When a null/undefined value is observed, it indicates that
989
+ * there is no available data.
965
990
  */
966
991
  company?: string | null;
967
992
 
968
993
  /**
969
- * IPO exchange.
994
+ * IPO exchange. When a null/undefined value is observed, it indicates that there
995
+ * is no available data.
970
996
  */
971
997
  exchange?: string | null;
972
998
 
973
999
  /**
974
- * IPO market cap.
1000
+ * IPO market cap. When a null/undefined value is observed, it indicates that there
1001
+ * is no available data.
975
1002
  */
976
1003
  market_cap?: string | null;
977
1004
 
978
1005
  /**
979
- * IPO price range.
1006
+ * IPO price range. When a null/undefined value is observed, it indicates that
1007
+ * there is no available data.
980
1008
  */
981
1009
  price_range?: string | null;
982
1010
 
983
1011
  /**
984
- * IPO shares offered.
1012
+ * IPO shares offered. When a null/undefined value is observed, it indicates that
1013
+ * there is no available data.
985
1014
  */
986
1015
  shares?: string | null;
987
1016
  }
@@ -1026,7 +1055,8 @@ export interface InstrumentEventsData {
1026
1055
  splits: Array<InstrumentSplitEvent>;
1027
1056
 
1028
1057
  /**
1029
- * The currency used for reporting financial data
1058
+ * The currency used for reporting financial data When a null/undefined value is
1059
+ * observed, it indicates that there is no available data.
1030
1060
  */
1031
1061
  reporting_currency?: string | null;
1032
1062
  }
@@ -1036,78 +1066,93 @@ export interface InstrumentEventsData {
1036
1066
  */
1037
1067
  export interface InstrumentFundamentals {
1038
1068
  /**
1039
- * The average daily trading volume over the past 30 days
1069
+ * The average daily trading volume over the past 30 days When a null/undefined
1070
+ * value is observed, it indicates that there is no available data.
1040
1071
  */
1041
1072
  average_volume?: number | null;
1042
1073
 
1043
1074
  /**
1044
1075
  * The beta value, measuring the instrument's volatility relative to the overall
1045
- * market
1076
+ * market When a null/undefined value is observed, it indicates that there is no
1077
+ * available data.
1046
1078
  */
1047
1079
  beta?: string | null;
1048
1080
 
1049
1081
  /**
1050
- * A detailed description of the instrument or company
1082
+ * A detailed description of the instrument or company When a null/undefined value
1083
+ * is observed, it indicates that there is no available data.
1051
1084
  */
1052
1085
  description?: string | null;
1053
1086
 
1054
1087
  /**
1055
- * The trailing twelve months (TTM) dividend yield
1088
+ * The trailing twelve months (TTM) dividend yield When a null/undefined value is
1089
+ * observed, it indicates that there is no available data.
1056
1090
  */
1057
1091
  dividend_yield?: string | null;
1058
1092
 
1059
1093
  /**
1060
- * The trailing twelve months (TTM) earnings per share
1094
+ * The trailing twelve months (TTM) earnings per share When a null/undefined value
1095
+ * is observed, it indicates that there is no available data.
1061
1096
  */
1062
1097
  earnings_per_share?: string | null;
1063
1098
 
1064
1099
  /**
1065
- * The highest price over the last 52 weeks
1100
+ * The highest price over the last 52 weeks When a null/undefined value is
1101
+ * observed, it indicates that there is no available data.
1066
1102
  */
1067
1103
  fifty_two_week_high?: string | null;
1068
1104
 
1069
1105
  /**
1070
- * The lowest price over the last 52 weeks
1106
+ * The lowest price over the last 52 weeks When a null/undefined value is observed,
1107
+ * it indicates that there is no available data.
1071
1108
  */
1072
1109
  fifty_two_week_low?: string | null;
1073
1110
 
1074
1111
  /**
1075
- * The specific industry of the instrument's issuer
1112
+ * The specific industry of the instrument's issuer When a null/undefined value is
1113
+ * observed, it indicates that there is no available data.
1076
1114
  */
1077
1115
  industry?: string | null;
1078
1116
 
1079
1117
  /**
1080
- * The date the instrument was first listed
1118
+ * The date the instrument was first listed When a null/undefined value is
1119
+ * observed, it indicates that there is no available data.
1081
1120
  */
1082
1121
  list_date?: string | null;
1083
1122
 
1084
1123
  /**
1085
- * URL to a representative logo image for the instrument or issuer
1124
+ * URL to a representative logo image for the instrument or issuer When a
1125
+ * null/undefined value is observed, it indicates that there is no available data.
1086
1126
  */
1087
1127
  logo_url?: string | null;
1088
1128
 
1089
1129
  /**
1090
- * The total market capitalization
1130
+ * The total market capitalization When a null/undefined value is observed, it
1131
+ * indicates that there is no available data.
1091
1132
  */
1092
1133
  market_cap?: string | null;
1093
1134
 
1094
1135
  /**
1095
- * The closing price from the previous trading day
1136
+ * The closing price from the previous trading day When a null/undefined value is
1137
+ * observed, it indicates that there is no available data.
1096
1138
  */
1097
1139
  previous_close?: string | null;
1098
1140
 
1099
1141
  /**
1100
- * The price-to-earnings (P/E) ratio for the trailing twelve months (TTM)
1142
+ * The price-to-earnings (P/E) ratio for the trailing twelve months (TTM) When a
1143
+ * null/undefined value is observed, it indicates that there is no available data.
1101
1144
  */
1102
1145
  price_to_earnings?: string | null;
1103
1146
 
1104
1147
  /**
1105
- * The currency used for reporting financial data
1148
+ * The currency used for reporting financial data When a null/undefined value is
1149
+ * observed, it indicates that there is no available data.
1106
1150
  */
1107
1151
  reporting_currency?: string | null;
1108
1152
 
1109
1153
  /**
1110
- * The business sector of the instrument's issuer
1154
+ * The business sector of the instrument's issuer When a null/undefined value is
1155
+ * observed, it indicates that there is no available data.
1111
1156
  */
1112
1157
  sector?: string | null;
1113
1158
  }
@@ -69,32 +69,38 @@ export interface DailySummary {
69
69
  instrument_id: string;
70
70
 
71
71
  /**
72
- * Session high.
72
+ * Session high. When a null/undefined value is observed, it indicates that there
73
+ * is no available data.
73
74
  */
74
75
  high?: string | null;
75
76
 
76
77
  /**
77
- * Session low.
78
+ * Session low. When a null/undefined value is observed, it indicates that there is
79
+ * no available data.
78
80
  */
79
81
  low?: string | null;
80
82
 
81
83
  /**
82
- * Opening price for the session.
84
+ * Opening price for the session. When a null/undefined value is observed, it
85
+ * indicates that there is no available data.
83
86
  */
84
87
  open?: string | null;
85
88
 
86
89
  /**
87
- * Display symbol for the security. `None` for unresolvable IDs.
90
+ * Display symbol for the security. `None` for unresolvable IDs. When a
91
+ * null/undefined value is observed, it indicates that there is no available data.
88
92
  */
89
93
  symbol?: string | null;
90
94
 
91
95
  /**
92
- * Session date the OHLV represents, US/Eastern.
96
+ * Session date the OHLV represents, US/Eastern. When a null/undefined value is
97
+ * observed, it indicates that there is no available data.
93
98
  */
94
99
  trade_date?: string | null;
95
100
 
96
101
  /**
97
- * Session cumulative trading volume.
102
+ * Session cumulative trading volume. When a null/undefined value is observed, it
103
+ * indicates that there is no available data.
98
104
  */
99
105
  volume?: number | null;
100
106
  }
@@ -117,33 +123,40 @@ export interface MarketDataSnapshot {
117
123
 
118
124
  /**
119
125
  * Cumulative traded volume reported on the most recent trade, in shares for
120
- * equities or contracts for options. Absent when no trade is available.
126
+ * equities or contracts for options. Absent when no trade is available. When a
127
+ * null/undefined value is observed, it indicates that there is no available data.
121
128
  */
122
129
  cumulative_volume?: number | null;
123
130
 
124
131
  /**
125
132
  * Theoretical price and Greeks for option instruments. `None` for equities, and
126
- * for options whose Greeks have not yet been observed
133
+ * for options whose Greeks have not yet been observed When a null/undefined value
134
+ * is observed, it indicates that there is no available data.
127
135
  */
128
136
  greeks?: SnapshotGreeks | null;
129
137
 
130
138
  /**
131
- * Most recent quote if available.
139
+ * Most recent quote if available. When a null/undefined value is observed, it
140
+ * indicates that there is no available data.
132
141
  */
133
142
  last_quote?: SnapshotQuote | null;
134
143
 
135
144
  /**
136
- * Most recent last-sale trade if available.
145
+ * Most recent last-sale trade if available. When a null/undefined value is
146
+ * observed, it indicates that there is no available data.
137
147
  */
138
148
  last_trade?: SnapshotLastTrade | null;
139
149
 
140
150
  /**
141
- * Security name if available.
151
+ * Security name if available. When a null/undefined value is observed, it
152
+ * indicates that there is no available data.
142
153
  */
143
154
  name?: string | null;
144
155
 
145
156
  /**
146
- * Session metrics computed from previous close and last trade, if available.
157
+ * Session metrics computed from previous close and last trade, if available. When
158
+ * a null/undefined value is observed, it indicates that there is no available
159
+ * data.
147
160
  */
148
161
  session?: SnapshotSession | null;
149
162
  }
@@ -231,12 +244,14 @@ export interface SnapshotQuote {
231
244
  midpoint: string;
232
245
 
233
246
  /**
234
- * Size at the best ask, in shares.
247
+ * Size at the best ask, in shares. When a null/undefined value is observed, it
248
+ * indicates that there is no available data.
235
249
  */
236
250
  ask_size?: number | null;
237
251
 
238
252
  /**
239
- * Size at the best bid, in shares.
253
+ * Size at the best bid, in shares. When a null/undefined value is observed, it
254
+ * indicates that there is no available data.
240
255
  */
241
256
  bid_size?: number | null;
242
257
  }
@@ -37,12 +37,14 @@ export interface NewsInstrument {
37
37
  instrument_id: string;
38
38
 
39
39
  /**
40
- * Instrument name/description, if available.
40
+ * Instrument name/description, if available. When a null/undefined value is
41
+ * observed, it indicates that there is no available data.
41
42
  */
42
43
  name?: string | null;
43
44
 
44
45
  /**
45
- * Trading symbol, if available.
46
+ * Trading symbol, if available. When a null/undefined value is observed, it
47
+ * indicates that there is no available data.
46
48
  */
47
49
  symbol?: string | null;
48
50
  }
@@ -82,17 +84,20 @@ export interface NewsItem {
82
84
  url: string;
83
85
 
84
86
  /**
85
- * URL of an associated image if provided by the source.
87
+ * URL of an associated image if provided by the source. When a null/undefined
88
+ * value is observed, it indicates that there is no available data.
86
89
  */
87
90
  image_url?: string | null;
88
91
 
89
92
  /**
90
- * The primary domain/site of the publisher.
93
+ * The primary domain/site of the publisher. When a null/undefined value is
94
+ * observed, it indicates that there is no available data.
91
95
  */
92
96
  site?: string | null;
93
97
 
94
98
  /**
95
- * The full or excerpted article body.
99
+ * The full or excerpted article body. When a null/undefined value is observed, it
100
+ * indicates that there is no available data.
96
101
  */
97
102
  text?: string | null;
98
103
  }