snaptrade 2.0.186 → 2.0.188

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 (36) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile.lock +1 -1
  3. data/README.md +39 -48
  4. data/lib/snaptrade/api/account_information_api.rb +103 -0
  5. data/lib/snaptrade/api/experimental_endpoints_api.rb +8 -137
  6. data/lib/snaptrade/configuration.rb +1 -1
  7. data/lib/snaptrade/models/account_order_record.rb +23 -1
  8. data/lib/snaptrade/models/account_order_record_v2.rb +57 -1
  9. data/lib/snaptrade/models/adr_instrument.rb +311 -0
  10. data/lib/snaptrade/models/adr_instrument_kind.rb +36 -0
  11. data/lib/snaptrade/models/all_account_positions_response.rb +3 -40
  12. data/lib/snaptrade/models/cef_instrument.rb +311 -0
  13. data/lib/snaptrade/models/cef_instrument_kind.rb +36 -0
  14. data/lib/snaptrade/models/complex_order_leg.rb +1 -1
  15. data/lib/snaptrade/models/complex_order_leg_order_role.rb +38 -0
  16. data/lib/snaptrade/models/instrument.rb +6 -0
  17. data/lib/snaptrade/models/mutual_fund_instrument.rb +311 -0
  18. data/lib/snaptrade/models/mutual_fund_instrument_kind.rb +36 -0
  19. data/lib/snaptrade/models/order_updated_response_order.rb +23 -1
  20. data/lib/snaptrade/models/underlying_option_instrument.rb +6 -0
  21. data/lib/snaptrade/version.rb +1 -1
  22. data/lib/snaptrade.rb +7 -0
  23. data/spec/api/account_information_api_spec.rb +14 -0
  24. data/spec/api/experimental_endpoints_api_spec.rb +1 -17
  25. data/spec/models/account_order_record_spec.rb +12 -0
  26. data/spec/models/account_order_record_v2_spec.rb +16 -0
  27. data/spec/models/adr_instrument_kind_spec.rb +23 -0
  28. data/spec/models/adr_instrument_spec.rb +71 -0
  29. data/spec/models/all_account_positions_response_spec.rb +0 -18
  30. data/spec/models/cef_instrument_kind_spec.rb +23 -0
  31. data/spec/models/cef_instrument_spec.rb +71 -0
  32. data/spec/models/complex_order_leg_order_role_spec.rb +23 -0
  33. data/spec/models/mutual_fund_instrument_kind_spec.rb +23 -0
  34. data/spec/models/mutual_fund_instrument_spec.rb +71 -0
  35. data/spec/models/order_updated_response_order_spec.rb +12 -0
  36. metadata +202 -181
@@ -16,6 +16,12 @@ module SnapTrade
16
16
  # Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
17
17
  attr_accessor :brokerage_order_id
18
18
 
19
+ # The brokerage-assigned identifier that links all orders within a complex order (OCO, OTO, OTOCO) together. Null for non-complex orders or when the brokerage does not return a group identifier.
20
+ attr_accessor :brokerage_group_order_id
21
+
22
+ # The role of this order within a complex order group (OCO, OTO, OTOCO). Null for non-complex orders.
23
+ attr_accessor :order_role
24
+
19
25
  # Indicates the status of an order. SnapTrade does a best effort to map brokerage statuses to statuses in this enum. Possible values include: - NONE - PENDING - ACCEPTED - FAILED - REJECTED - CANCELED - PARTIAL_CANCELED - CANCEL_PENDING - EXECUTED - PARTIAL - REPLACE_PENDING - REPLACED - EXPIRED - QUEUED - TRIGGERED - ACTIVATED
20
26
  attr_accessor :status
21
27
 
@@ -48,10 +54,34 @@ module SnapTrade
48
54
  # List of legs that make up the order.
49
55
  attr_accessor :legs
50
56
 
57
+ class EnumAttributeValidator
58
+ attr_reader :datatype
59
+ attr_reader :allowable_values
60
+
61
+ def initialize(datatype, allowable_values)
62
+ @allowable_values = allowable_values.map do |value|
63
+ case datatype.to_s
64
+ when /Integer/i
65
+ value.to_i
66
+ when /Float/i
67
+ value.to_f
68
+ else
69
+ value
70
+ end
71
+ end
72
+ end
73
+
74
+ def valid?(value)
75
+ !value || allowable_values.include?(value)
76
+ end
77
+ end
78
+
51
79
  # Attribute mapping from ruby-style variable name to JSON key.
52
80
  def self.attribute_map
53
81
  {
54
82
  :'brokerage_order_id' => :'brokerage_order_id',
83
+ :'brokerage_group_order_id' => :'brokerage_group_order_id',
84
+ :'order_role' => :'order_role',
55
85
  :'status' => :'status',
56
86
  :'order_type' => :'order_type',
57
87
  :'time_in_force' => :'time_in_force',
@@ -75,6 +105,8 @@ module SnapTrade
75
105
  def self.openapi_types
76
106
  {
77
107
  :'brokerage_order_id' => :'String',
108
+ :'brokerage_group_order_id' => :'String',
109
+ :'order_role' => :'String',
78
110
  :'status' => :'AccountOrderRecordStatus',
79
111
  :'order_type' => :'String',
80
112
  :'time_in_force' => :'String',
@@ -92,6 +124,8 @@ module SnapTrade
92
124
  # List of attributes with nullable: true
93
125
  def self.openapi_nullable
94
126
  Set.new([
127
+ :'brokerage_group_order_id',
128
+ :'order_role',
95
129
  :'order_type',
96
130
  :'time_executed',
97
131
  :'execution_price',
@@ -120,6 +154,14 @@ module SnapTrade
120
154
  self.brokerage_order_id = attributes[:'brokerage_order_id']
121
155
  end
122
156
 
157
+ if attributes.key?(:'brokerage_group_order_id')
158
+ self.brokerage_group_order_id = attributes[:'brokerage_group_order_id']
159
+ end
160
+
161
+ if attributes.key?(:'order_role')
162
+ self.order_role = attributes[:'order_role']
163
+ end
164
+
123
165
  if attributes.key?(:'status')
124
166
  self.status = attributes[:'status']
125
167
  end
@@ -177,15 +219,29 @@ module SnapTrade
177
219
  # Check to see if the all the properties in the model are valid
178
220
  # @return true if the model is valid
179
221
  def valid?
222
+ order_role_validator = EnumAttributeValidator.new('String', ["TRIGGER", "CONDITIONAL", "PEER"])
223
+ return false unless order_role_validator.valid?(@order_role)
180
224
  true
181
225
  end
182
226
 
227
+ # Custom attribute writer method checking allowed values (enum).
228
+ # @param [Object] order_role Object to be assigned
229
+ def order_role=(order_role)
230
+ validator = EnumAttributeValidator.new('String', ["TRIGGER", "CONDITIONAL", "PEER"])
231
+ unless validator.valid?(order_role)
232
+ fail ArgumentError, "invalid value for \"order_role\", must be one of #{validator.allowable_values}."
233
+ end
234
+ @order_role = order_role
235
+ end
236
+
183
237
  # Checks equality by comparing each attribute.
184
238
  # @param [Object] Object to be compared
185
239
  def ==(o)
186
240
  return true if self.equal?(o)
187
241
  self.class == o.class &&
188
242
  brokerage_order_id == o.brokerage_order_id &&
243
+ brokerage_group_order_id == o.brokerage_group_order_id &&
244
+ order_role == o.order_role &&
189
245
  status == o.status &&
190
246
  order_type == o.order_type &&
191
247
  time_in_force == o.time_in_force &&
@@ -208,7 +264,7 @@ module SnapTrade
208
264
  # Calculates hash code according to all attributes.
209
265
  # @return [Integer] Hash code
210
266
  def hash
211
- [brokerage_order_id, status, order_type, time_in_force, time_placed, time_executed, quote_currency, execution_price, limit_price, stop_price, trailing_stop, legs].hash
267
+ [brokerage_order_id, brokerage_group_order_id, order_role, status, order_type, time_in_force, time_placed, time_executed, quote_currency, execution_price, limit_price, stop_price, trailing_stop, legs].hash
212
268
  end
213
269
 
214
270
  # Builds the object from hash
@@ -0,0 +1,311 @@
1
+ =begin
2
+ #SnapTrade
3
+
4
+ #Connect brokerage accounts to your app for live positions and trading
5
+
6
+ The version of the OpenAPI document: 1.0.0
7
+ Contact: api@snaptrade.com
8
+ =end
9
+
10
+ require 'date'
11
+ require 'time'
12
+
13
+ module SnapTrade
14
+ # Security instrument metadata for ADR positions.
15
+ class AdrInstrument
16
+ # Type of security instrument.
17
+ attr_accessor :kind
18
+
19
+ # Unique identifier for the instrument.
20
+ attr_accessor :id
21
+
22
+ # The formatted trading symbol for the security.
23
+ attr_accessor :symbol
24
+
25
+ # The raw symbol without any exchange suffix.
26
+ attr_accessor :raw_symbol
27
+
28
+ # Human-readable description of the security.
29
+ attr_accessor :description
30
+
31
+ # ISO-4217 currency code for the security listing.
32
+ attr_accessor :currency
33
+
34
+ # Exchange MIC code or exchange code for the security.
35
+ attr_accessor :exchange
36
+
37
+ attr_accessor :figi_instrument
38
+
39
+ # Attribute mapping from ruby-style variable name to JSON key.
40
+ def self.attribute_map
41
+ {
42
+ :'kind' => :'kind',
43
+ :'id' => :'id',
44
+ :'symbol' => :'symbol',
45
+ :'raw_symbol' => :'raw_symbol',
46
+ :'description' => :'description',
47
+ :'currency' => :'currency',
48
+ :'exchange' => :'exchange',
49
+ :'figi_instrument' => :'figi_instrument'
50
+ }
51
+ end
52
+
53
+ # Returns all the JSON keys this model knows about
54
+ def self.acceptable_attributes
55
+ attribute_map.values
56
+ end
57
+
58
+ # Attribute type mapping.
59
+ def self.openapi_types
60
+ {
61
+ :'kind' => :'AdrInstrumentKind',
62
+ :'id' => :'String',
63
+ :'symbol' => :'String',
64
+ :'raw_symbol' => :'String',
65
+ :'description' => :'String',
66
+ :'currency' => :'String',
67
+ :'exchange' => :'String',
68
+ :'figi_instrument' => :'StockInstrumentFigiInstrument'
69
+ }
70
+ end
71
+
72
+ # List of attributes with nullable: true
73
+ def self.openapi_nullable
74
+ Set.new([
75
+ :'description',
76
+ :'currency',
77
+ :'exchange',
78
+ :'figi_instrument'
79
+ ])
80
+ end
81
+
82
+ # Initializes the object
83
+ # @param [Hash] attributes Model attributes in the form of hash
84
+ def initialize(attributes = {})
85
+ if (!attributes.is_a?(Hash))
86
+ fail ArgumentError, "The input argument (attributes) must be a hash in `SnapTrade::AdrInstrument` initialize method"
87
+ end
88
+
89
+ # check to see if the attribute exists and convert string to symbol for hash key
90
+ attributes = attributes.each_with_object({}) { |(k, v), h|
91
+ if (!self.class.attribute_map.key?(k.to_sym))
92
+ fail ArgumentError, "`#{k}` is not a valid attribute in `SnapTrade::AdrInstrument`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
93
+ end
94
+ h[k.to_sym] = v
95
+ }
96
+
97
+ if attributes.key?(:'kind')
98
+ self.kind = attributes[:'kind']
99
+ end
100
+
101
+ if attributes.key?(:'id')
102
+ self.id = attributes[:'id']
103
+ end
104
+
105
+ if attributes.key?(:'symbol')
106
+ self.symbol = attributes[:'symbol']
107
+ end
108
+
109
+ if attributes.key?(:'raw_symbol')
110
+ self.raw_symbol = attributes[:'raw_symbol']
111
+ end
112
+
113
+ if attributes.key?(:'description')
114
+ self.description = attributes[:'description']
115
+ end
116
+
117
+ if attributes.key?(:'currency')
118
+ self.currency = attributes[:'currency']
119
+ end
120
+
121
+ if attributes.key?(:'exchange')
122
+ self.exchange = attributes[:'exchange']
123
+ end
124
+
125
+ if attributes.key?(:'figi_instrument')
126
+ self.figi_instrument = attributes[:'figi_instrument']
127
+ end
128
+ end
129
+
130
+ # Show invalid properties with the reasons. Usually used together with valid?
131
+ # @return Array for valid properties with the reasons
132
+ def list_invalid_properties
133
+ invalid_properties = Array.new
134
+ if @kind.nil?
135
+ invalid_properties.push('invalid value for "kind", kind cannot be nil.')
136
+ end
137
+
138
+ if @id.nil?
139
+ invalid_properties.push('invalid value for "id", id cannot be nil.')
140
+ end
141
+
142
+ if @symbol.nil?
143
+ invalid_properties.push('invalid value for "symbol", symbol cannot be nil.')
144
+ end
145
+
146
+ if @raw_symbol.nil?
147
+ invalid_properties.push('invalid value for "raw_symbol", raw_symbol cannot be nil.')
148
+ end
149
+
150
+ invalid_properties
151
+ end
152
+
153
+ # Check to see if the all the properties in the model are valid
154
+ # @return true if the model is valid
155
+ def valid?
156
+ return false if @kind.nil?
157
+ return false if @id.nil?
158
+ return false if @symbol.nil?
159
+ return false if @raw_symbol.nil?
160
+ true
161
+ end
162
+
163
+ # Checks equality by comparing each attribute.
164
+ # @param [Object] Object to be compared
165
+ def ==(o)
166
+ return true if self.equal?(o)
167
+ self.class == o.class &&
168
+ kind == o.kind &&
169
+ id == o.id &&
170
+ symbol == o.symbol &&
171
+ raw_symbol == o.raw_symbol &&
172
+ description == o.description &&
173
+ currency == o.currency &&
174
+ exchange == o.exchange &&
175
+ figi_instrument == o.figi_instrument
176
+ end
177
+
178
+ # @see the `==` method
179
+ # @param [Object] Object to be compared
180
+ def eql?(o)
181
+ self == o
182
+ end
183
+
184
+ # Calculates hash code according to all attributes.
185
+ # @return [Integer] Hash code
186
+ def hash
187
+ [kind, id, symbol, raw_symbol, description, currency, exchange, figi_instrument].hash
188
+ end
189
+
190
+ # Builds the object from hash
191
+ # @param [Hash] attributes Model attributes in the form of hash
192
+ # @return [Object] Returns the model itself
193
+ def self.build_from_hash(attributes)
194
+ new.build_from_hash(attributes)
195
+ end
196
+
197
+ # Builds the object from hash
198
+ # @param [Hash] attributes Model attributes in the form of hash
199
+ # @return [Object] Returns the model itself
200
+ def build_from_hash(attributes)
201
+ return nil unless attributes.is_a?(Hash)
202
+ attributes = attributes.transform_keys(&:to_sym)
203
+ self.class.openapi_types.each_pair do |key, type|
204
+ if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
205
+ self.send("#{key}=", nil)
206
+ elsif type =~ /\AArray<(.*)>/i
207
+ # check to ensure the input is an array given that the attribute
208
+ # is documented as an array but the input is not
209
+ if attributes[self.class.attribute_map[key]].is_a?(Array)
210
+ self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
211
+ end
212
+ elsif !attributes[self.class.attribute_map[key]].nil?
213
+ self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
214
+ end
215
+ end
216
+
217
+ self
218
+ end
219
+
220
+ # Deserializes the data based on type
221
+ # @param string type Data type
222
+ # @param string value Value to be deserialized
223
+ # @return [Object] Deserialized data
224
+ def _deserialize(type, value)
225
+ case type.to_sym
226
+ when :Time
227
+ Time.parse(value)
228
+ when :Date
229
+ Date.parse(value)
230
+ when :String
231
+ value.to_s
232
+ when :Integer
233
+ value.to_i
234
+ when :Float
235
+ value.to_f
236
+ when :Boolean
237
+ if value.to_s =~ /\A(true|t|yes|y|1)\z/i
238
+ true
239
+ else
240
+ false
241
+ end
242
+ when :Object
243
+ # generic object (usually a Hash), return directly
244
+ value
245
+ when /\AArray<(?<inner_type>.+)>\z/
246
+ inner_type = Regexp.last_match[:inner_type]
247
+ value.map { |v| _deserialize(inner_type, v) }
248
+ when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
249
+ k_type = Regexp.last_match[:k_type]
250
+ v_type = Regexp.last_match[:v_type]
251
+ {}.tap do |hash|
252
+ value.each do |k, v|
253
+ hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
254
+ end
255
+ end
256
+ else # model
257
+ # models (e.g. Pet) or oneOf
258
+ klass = SnapTrade.const_get(type)
259
+ klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
260
+ end
261
+ end
262
+
263
+ # Returns the string representation of the object
264
+ # @return [String] String presentation of the object
265
+ def to_s
266
+ to_hash.to_s
267
+ end
268
+
269
+ # to_body is an alias to to_hash (backward compatibility)
270
+ # @return [Hash] Returns the object in the form of hash
271
+ def to_body
272
+ to_hash
273
+ end
274
+
275
+ # Returns the object in the form of hash
276
+ # @return [Hash] Returns the object in the form of hash
277
+ def to_hash
278
+ hash = {}
279
+ self.class.attribute_map.each_pair do |attr, param|
280
+ value = self.send(attr)
281
+ if value.nil?
282
+ is_nullable = self.class.openapi_nullable.include?(attr)
283
+ next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
284
+ end
285
+
286
+ hash[param] = _to_hash(value)
287
+ end
288
+ hash
289
+ end
290
+
291
+ # Outputs non-array value in the form of hash
292
+ # For object, use to_hash. Otherwise, just return the value
293
+ # @param [Object] value Any valid value
294
+ # @return [Hash] Returns the value in the form of hash
295
+ def _to_hash(value)
296
+ if value.is_a?(Array)
297
+ value.compact.map { |v| _to_hash(v) }
298
+ elsif value.is_a?(Hash)
299
+ {}.tap do |hash|
300
+ value.each { |k, v| hash[k] = _to_hash(v) }
301
+ end
302
+ elsif value.respond_to? :to_hash
303
+ value.to_hash
304
+ else
305
+ value
306
+ end
307
+ end
308
+
309
+ end
310
+
311
+ end
@@ -0,0 +1,36 @@
1
+ =begin
2
+ #SnapTrade
3
+
4
+ #Connect brokerage accounts to your app for live positions and trading
5
+
6
+ The version of the OpenAPI document: 1.0.0
7
+ Contact: api@snaptrade.com
8
+ =end
9
+
10
+ require 'date'
11
+ require 'time'
12
+
13
+ module SnapTrade
14
+ class AdrInstrumentKind
15
+ ADR = "adr".freeze
16
+
17
+ def self.all_vars
18
+ @all_vars ||= [ADR].freeze
19
+ end
20
+
21
+ # Builds the enum from string
22
+ # @param [String] The enum value in the form of the string
23
+ # @return [String] The enum value
24
+ def self.build_from_hash(value)
25
+ new.build_from_hash(value)
26
+ end
27
+
28
+ # Builds the enum from string
29
+ # @param [String] The enum value in the form of the string
30
+ # @return [String] The enum value
31
+ def build_from_hash(value)
32
+ return value if AdrInstrumentKind.all_vars.include?(value)
33
+ raise "Invalid ENUM value #{value} for class #AdrInstrumentKind"
34
+ end
35
+ end
36
+ end
@@ -11,26 +11,14 @@ require 'date'
11
11
  require 'time'
12
12
 
13
13
  module SnapTrade
14
- # A paginated list of all account positions.
14
+ # Information about all account positions.
15
15
  class AllAccountPositionsResponse
16
- # The total number of positions available across all pages.
17
- attr_accessor :count
18
-
19
- # The URL for the next page of results, or `null` if there is no next page.
20
- attr_accessor :_next
21
-
22
- # The URL for the previous page of results, or `null` if there is no previous page.
23
- attr_accessor :previous
24
-
25
- # Positions returned for the current page.
16
+ # Positions returned for the request.
26
17
  attr_accessor :results
27
18
 
28
19
  # Attribute mapping from ruby-style variable name to JSON key.
29
20
  def self.attribute_map
30
21
  {
31
- :'count' => :'count',
32
- :'_next' => :'next',
33
- :'previous' => :'previous',
34
22
  :'results' => :'results'
35
23
  }
36
24
  end
@@ -43,9 +31,6 @@ module SnapTrade
43
31
  # Attribute type mapping.
44
32
  def self.openapi_types
45
33
  {
46
- :'count' => :'Integer',
47
- :'_next' => :'String',
48
- :'previous' => :'String',
49
34
  :'results' => :'Array<AccountPosition>'
50
35
  }
51
36
  end
@@ -53,8 +38,6 @@ module SnapTrade
53
38
  # List of attributes with nullable: true
54
39
  def self.openapi_nullable
55
40
  Set.new([
56
- :'_next',
57
- :'previous',
58
41
  ])
59
42
  end
60
43
 
@@ -73,18 +56,6 @@ module SnapTrade
73
56
  h[k.to_sym] = v
74
57
  }
75
58
 
76
- if attributes.key?(:'count')
77
- self.count = attributes[:'count']
78
- end
79
-
80
- if attributes.key?(:'_next')
81
- self._next = attributes[:'_next']
82
- end
83
-
84
- if attributes.key?(:'previous')
85
- self.previous = attributes[:'previous']
86
- end
87
-
88
59
  if attributes.key?(:'results')
89
60
  if (value = attributes[:'results']).is_a?(Array)
90
61
  self.results = value
@@ -96,10 +67,6 @@ module SnapTrade
96
67
  # @return Array for valid properties with the reasons
97
68
  def list_invalid_properties
98
69
  invalid_properties = Array.new
99
- if @count.nil?
100
- invalid_properties.push('invalid value for "count", count cannot be nil.')
101
- end
102
-
103
70
  if @results.nil?
104
71
  invalid_properties.push('invalid value for "results", results cannot be nil.')
105
72
  end
@@ -110,7 +77,6 @@ module SnapTrade
110
77
  # Check to see if the all the properties in the model are valid
111
78
  # @return true if the model is valid
112
79
  def valid?
113
- return false if @count.nil?
114
80
  return false if @results.nil?
115
81
  true
116
82
  end
@@ -120,9 +86,6 @@ module SnapTrade
120
86
  def ==(o)
121
87
  return true if self.equal?(o)
122
88
  self.class == o.class &&
123
- count == o.count &&
124
- _next == o._next &&
125
- previous == o.previous &&
126
89
  results == o.results
127
90
  end
128
91
 
@@ -135,7 +98,7 @@ module SnapTrade
135
98
  # Calculates hash code according to all attributes.
136
99
  # @return [Integer] Hash code
137
100
  def hash
138
- [count, _next, previous, results].hash
101
+ [results].hash
139
102
  end
140
103
 
141
104
  # Builds the object from hash