snaptrade 1.15.0 → 1.15.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (299) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +10 -10
  3. data/Gemfile.lock +12 -10
  4. data/README.md +221 -221
  5. data/docs/APIStatusApi.md +57 -57
  6. data/docs/AccountInformationApi.md +535 -535
  7. data/docs/AuthenticationApi.md +314 -314
  8. data/docs/ConnectionsApi.md +265 -265
  9. data/docs/ErrorLogsApi.md +68 -68
  10. data/docs/OptionsApi.md +378 -378
  11. data/docs/ReferenceDataApi.md +595 -595
  12. data/docs/TradingApi.md +478 -478
  13. data/docs/TransactionsAndReportingApi.md +183 -183
  14. data/lib/snaptrade/api/account_information_api.rb +801 -801
  15. data/lib/snaptrade/api/api_status_api.rb +98 -98
  16. data/lib/snaptrade/api/authentication_api.rb +481 -481
  17. data/lib/snaptrade/api/connections_api.rb +398 -398
  18. data/lib/snaptrade/api/error_logs_api.rb +112 -112
  19. data/lib/snaptrade/api/options_api.rb +591 -591
  20. data/lib/snaptrade/api/reference_data_api.rb +894 -894
  21. data/lib/snaptrade/api/trading_api.rb +741 -741
  22. data/lib/snaptrade/api/transactions_and_reporting_api.rb +283 -283
  23. data/lib/snaptrade/api_client.rb +427 -427
  24. data/lib/snaptrade/api_client_custom.rb +32 -32
  25. data/lib/snaptrade/api_error.rb +6 -6
  26. data/lib/snaptrade/configuration.rb +334 -334
  27. data/lib/snaptrade/models/account.rb +6 -6
  28. data/lib/snaptrade/models/account_holdings.rb +6 -6
  29. data/lib/snaptrade/models/account_holdings_account.rb +6 -6
  30. data/lib/snaptrade/models/account_order_record.rb +6 -6
  31. data/lib/snaptrade/models/account_order_record_status.rb +6 -6
  32. data/lib/snaptrade/models/account_simple.rb +6 -6
  33. data/lib/snaptrade/models/account_sync_status.rb +6 -6
  34. data/lib/snaptrade/models/action.rb +6 -6
  35. data/lib/snaptrade/models/auth_type.rb +6 -6
  36. data/lib/snaptrade/models/authentication_login_snap_trade_user200_response.rb +6 -6
  37. data/lib/snaptrade/models/balance.rb +6 -6
  38. data/lib/snaptrade/models/brokerage.rb +6 -6
  39. data/lib/snaptrade/models/brokerage_authorization.rb +6 -6
  40. data/lib/snaptrade/models/brokerage_authorization_type.rb +6 -6
  41. data/lib/snaptrade/models/brokerage_authorization_type_read_only.rb +6 -6
  42. data/lib/snaptrade/models/brokerage_authorization_type_read_only_brokerage.rb +6 -6
  43. data/lib/snaptrade/models/brokerage_authorization_type_read_only_type.rb +6 -6
  44. data/lib/snaptrade/models/brokerage_authorization_type_type.rb +6 -6
  45. data/lib/snaptrade/models/brokerage_symbol.rb +6 -6
  46. data/lib/snaptrade/models/brokerage_symbol_option_symbol.rb +6 -6
  47. data/lib/snaptrade/models/brokerage_symbol_symbol.rb +6 -6
  48. data/lib/snaptrade/models/brokerage_type.rb +6 -6
  49. data/lib/snaptrade/models/calculated_trade.rb +6 -6
  50. data/lib/snaptrade/models/cash_restriction.rb +6 -6
  51. data/lib/snaptrade/models/connection_type.rb +6 -6
  52. data/lib/snaptrade/models/connections_session_events200_response_inner.rb +6 -6
  53. data/lib/snaptrade/models/currency.rb +6 -6
  54. data/lib/snaptrade/models/delete_user_response.rb +6 -6
  55. data/lib/snaptrade/models/dividend_at_date.rb +6 -6
  56. data/lib/snaptrade/models/encrypted_response.rb +6 -6
  57. data/lib/snaptrade/models/encrypted_response_encrypted_message_data.rb +6 -6
  58. data/lib/snaptrade/models/exchange.rb +6 -6
  59. data/lib/snaptrade/models/exchange_rate_pairs.rb +6 -6
  60. data/lib/snaptrade/models/excluded_asset.rb +6 -6
  61. data/lib/snaptrade/models/jwt.rb +6 -6
  62. data/lib/snaptrade/models/login_redirect_uri.rb +6 -6
  63. data/lib/snaptrade/models/manual_trade.rb +6 -6
  64. data/lib/snaptrade/models/manual_trade_and_impact.rb +6 -6
  65. data/lib/snaptrade/models/manual_trade_balance.rb +6 -6
  66. data/lib/snaptrade/models/manual_trade_form.rb +6 -6
  67. data/lib/snaptrade/models/manual_trade_symbol.rb +6 -6
  68. data/lib/snaptrade/models/model400_failed_request_response.rb +6 -6
  69. data/lib/snaptrade/models/model401_failed_request_response.rb +6 -6
  70. data/lib/snaptrade/models/model403_failed_request_response.rb +6 -6
  71. data/lib/snaptrade/models/model404_failed_request_response.rb +6 -6
  72. data/lib/snaptrade/models/model_asset_class.rb +6 -6
  73. data/lib/snaptrade/models/model_asset_class_details.rb +6 -6
  74. data/lib/snaptrade/models/model_asset_class_target.rb +6 -6
  75. data/lib/snaptrade/models/model_portfolio.rb +6 -6
  76. data/lib/snaptrade/models/model_portfolio_asset_class.rb +6 -6
  77. data/lib/snaptrade/models/model_portfolio_details.rb +6 -6
  78. data/lib/snaptrade/models/model_portfolio_security.rb +6 -6
  79. data/lib/snaptrade/models/model_type.rb +6 -6
  80. data/lib/snaptrade/models/monthly_dividends.rb +6 -6
  81. data/lib/snaptrade/models/net_contributions.rb +6 -6
  82. data/lib/snaptrade/models/net_dividend.rb +6 -6
  83. data/lib/snaptrade/models/option_chain_inner.rb +6 -6
  84. data/lib/snaptrade/models/option_chain_inner_chain_per_root_inner.rb +6 -6
  85. data/lib/snaptrade/models/option_chain_inner_chain_per_root_inner_chain_per_strike_price_inner.rb +6 -6
  86. data/lib/snaptrade/models/option_leg.rb +6 -6
  87. data/lib/snaptrade/models/option_leg_action.rb +6 -6
  88. data/lib/snaptrade/models/option_strategy.rb +6 -6
  89. data/lib/snaptrade/models/option_strategy_legs_inner.rb +6 -6
  90. data/lib/snaptrade/models/options_get_option_strategy_request.rb +6 -6
  91. data/lib/snaptrade/models/options_holdings.rb +6 -6
  92. data/lib/snaptrade/models/options_place_option_strategy_request.rb +6 -6
  93. data/lib/snaptrade/models/options_position.rb +6 -6
  94. data/lib/snaptrade/models/options_position_currency.rb +6 -6
  95. data/lib/snaptrade/models/options_symbol.rb +6 -6
  96. data/lib/snaptrade/models/order_strategy_execute_body_order_type.rb +6 -6
  97. data/lib/snaptrade/models/order_strategy_execute_body_time_in_force.rb +6 -6
  98. data/lib/snaptrade/models/order_type.rb +6 -6
  99. data/lib/snaptrade/models/partner_data.rb +6 -6
  100. data/lib/snaptrade/models/past_value.rb +6 -6
  101. data/lib/snaptrade/models/performance_custom.rb +6 -6
  102. data/lib/snaptrade/models/portfolio_group.rb +6 -6
  103. data/lib/snaptrade/models/portfolio_group_info.rb +6 -6
  104. data/lib/snaptrade/models/portfolio_group_position.rb +6 -6
  105. data/lib/snaptrade/models/portfolio_group_settings.rb +6 -6
  106. data/lib/snaptrade/models/position.rb +6 -6
  107. data/lib/snaptrade/models/position_symbol.rb +6 -6
  108. data/lib/snaptrade/models/redirect_tokenand_pin.rb +6 -6
  109. data/lib/snaptrade/models/security_type.rb +6 -6
  110. data/lib/snaptrade/models/session_event.rb +6 -6
  111. data/lib/snaptrade/models/session_event_type.rb +6 -6
  112. data/lib/snaptrade/models/snap_trade_api_disclaimer_accept_status.rb +6 -6
  113. data/lib/snaptrade/models/snap_trade_holdings_account.rb +6 -6
  114. data/lib/snaptrade/models/snap_trade_holdings_account_account_id.rb +6 -6
  115. data/lib/snaptrade/models/snap_trade_holdings_total_value.rb +6 -6
  116. data/lib/snaptrade/models/snap_trade_login_user_request_body.rb +6 -6
  117. data/lib/snaptrade/models/snap_trade_register_user_request_body.rb +6 -6
  118. data/lib/snaptrade/models/state.rb +6 -6
  119. data/lib/snaptrade/models/status.rb +6 -6
  120. data/lib/snaptrade/models/strategy_impact.rb +6 -6
  121. data/lib/snaptrade/models/strategy_impact_legs_inner.rb +6 -6
  122. data/lib/snaptrade/models/strategy_order_place.rb +6 -6
  123. data/lib/snaptrade/models/strategy_order_place_orders_inner.rb +6 -6
  124. data/lib/snaptrade/models/strategy_order_place_orders_inner_legs_inner.rb +6 -6
  125. data/lib/snaptrade/models/strategy_order_record.rb +6 -6
  126. data/lib/snaptrade/models/strategy_order_record_order_type.rb +6 -6
  127. data/lib/snaptrade/models/strategy_order_record_status.rb +6 -6
  128. data/lib/snaptrade/models/strategy_order_record_time_in_force.rb +6 -6
  129. data/lib/snaptrade/models/strategy_quotes.rb +6 -6
  130. data/lib/snaptrade/models/strategy_quotes_greek.rb +6 -6
  131. data/lib/snaptrade/models/strategy_type.rb +6 -6
  132. data/lib/snaptrade/models/sub_period_return_rate.rb +6 -6
  133. data/lib/snaptrade/models/symbol.rb +6 -6
  134. data/lib/snaptrade/models/symbol_query.rb +6 -6
  135. data/lib/snaptrade/models/symbols_quotes_inner.rb +6 -6
  136. data/lib/snaptrade/models/target_asset.rb +6 -6
  137. data/lib/snaptrade/models/time_in_force.rb +6 -6
  138. data/lib/snaptrade/models/trade.rb +6 -6
  139. data/lib/snaptrade/models/trade_action.rb +6 -6
  140. data/lib/snaptrade/models/trade_execution_status.rb +6 -6
  141. data/lib/snaptrade/models/trade_execution_status_action.rb +6 -6
  142. data/lib/snaptrade/models/trade_impact.rb +6 -6
  143. data/lib/snaptrade/models/trading_cancel_user_account_order_request.rb +6 -6
  144. data/lib/snaptrade/models/trading_place_oco_order_request.rb +6 -6
  145. data/lib/snaptrade/models/transactions_status.rb +6 -6
  146. data/lib/snaptrade/models/type.rb +6 -6
  147. data/lib/snaptrade/models/underlying_symbol.rb +6 -6
  148. data/lib/snaptrade/models/universal_activity.rb +6 -6
  149. data/lib/snaptrade/models/universal_symbol.rb +6 -6
  150. data/lib/snaptrade/models/universal_symbol_ticker.rb +6 -6
  151. data/lib/snaptrade/models/us_exchange.rb +6 -6
  152. data/lib/snaptrade/models/user_error_log.rb +6 -6
  153. data/lib/snaptrade/models/user_i_dand_secret.rb +6 -6
  154. data/lib/snaptrade/models/user_settings.rb +6 -6
  155. data/lib/snaptrade/version.rb +13 -13
  156. data/lib/snaptrade.rb +214 -214
  157. data/snaptrade.gemspec +41 -41
  158. data/spec/api/account_information_api_spec.rb +135 -135
  159. data/spec/api/api_status_api_spec.rb +42 -42
  160. data/spec/api/authentication_api_spec.rb +88 -88
  161. data/spec/api/connections_api_spec.rb +82 -82
  162. data/spec/api/error_logs_api_spec.rb +43 -43
  163. data/spec/api/options_api_spec.rb +101 -101
  164. data/spec/api/reference_data_api_spec.rb +150 -150
  165. data/spec/api/trading_api_spec.rb +112 -112
  166. data/spec/api/transactions_and_reporting_api_spec.rb +67 -67
  167. data/spec/api_client_spec.rb +193 -193
  168. data/spec/configuration_spec.rb +6 -6
  169. data/spec/getting_started_spec.rb +108 -108
  170. data/spec/models/account_holdings_account_spec.rb +54 -54
  171. data/spec/models/account_holdings_spec.rb +48 -48
  172. data/spec/models/account_order_record_spec.rb +132 -132
  173. data/spec/models/account_order_record_status_spec.rb +24 -24
  174. data/spec/models/account_simple_spec.rb +48 -48
  175. data/spec/models/account_spec.rb +84 -84
  176. data/spec/models/account_sync_status_spec.rb +30 -30
  177. data/spec/models/action_spec.rb +24 -24
  178. data/spec/models/auth_type_spec.rb +24 -24
  179. data/spec/models/authentication_login_snap_trade_user200_response_spec.rb +27 -27
  180. data/spec/models/balance_spec.rb +36 -36
  181. data/spec/models/brokerage_authorization_spec.rb +78 -78
  182. data/spec/models/brokerage_authorization_type_read_only_brokerage_spec.rb +42 -42
  183. data/spec/models/brokerage_authorization_type_read_only_spec.rb +48 -48
  184. data/spec/models/brokerage_authorization_type_read_only_type_spec.rb +24 -24
  185. data/spec/models/brokerage_authorization_type_spec.rb +30 -30
  186. data/spec/models/brokerage_authorization_type_type_spec.rb +24 -24
  187. data/spec/models/brokerage_spec.rb +132 -132
  188. data/spec/models/brokerage_symbol_option_symbol_spec.rb +72 -72
  189. data/spec/models/brokerage_symbol_spec.rb +60 -60
  190. data/spec/models/brokerage_symbol_symbol_spec.rb +72 -72
  191. data/spec/models/brokerage_type_spec.rb +36 -36
  192. data/spec/models/calculated_trade_spec.rb +36 -36
  193. data/spec/models/cash_restriction_spec.rb +54 -54
  194. data/spec/models/connection_type_spec.rb +24 -24
  195. data/spec/models/connections_session_events200_response_inner_spec.rb +66 -66
  196. data/spec/models/currency_spec.rb +42 -42
  197. data/spec/models/delete_user_response_spec.rb +36 -36
  198. data/spec/models/dividend_at_date_spec.rb +42 -42
  199. data/spec/models/encrypted_response_encrypted_message_data_spec.rb +42 -42
  200. data/spec/models/encrypted_response_spec.rb +36 -36
  201. data/spec/models/exchange_rate_pairs_spec.rb +42 -42
  202. data/spec/models/exchange_spec.rb +72 -72
  203. data/spec/models/excluded_asset_spec.rb +30 -30
  204. data/spec/models/jwt_spec.rb +30 -30
  205. data/spec/models/login_redirect_uri_spec.rb +36 -36
  206. data/spec/models/manual_trade_and_impact_spec.rb +42 -42
  207. data/spec/models/manual_trade_balance_spec.rb +42 -42
  208. data/spec/models/manual_trade_form_spec.rb +72 -72
  209. data/spec/models/manual_trade_spec.rb +72 -72
  210. data/spec/models/manual_trade_symbol_spec.rb +60 -60
  211. data/spec/models/model400_failed_request_response_spec.rb +36 -36
  212. data/spec/models/model401_failed_request_response_spec.rb +36 -36
  213. data/spec/models/model403_failed_request_response_spec.rb +36 -36
  214. data/spec/models/model404_failed_request_response_spec.rb +36 -36
  215. data/spec/models/model_asset_class_details_spec.rb +36 -36
  216. data/spec/models/model_asset_class_spec.rb +36 -36
  217. data/spec/models/model_asset_class_target_spec.rb +30 -30
  218. data/spec/models/model_portfolio_asset_class_spec.rb +36 -36
  219. data/spec/models/model_portfolio_details_spec.rb +42 -42
  220. data/spec/models/model_portfolio_security_spec.rb +36 -36
  221. data/spec/models/model_portfolio_spec.rb +42 -42
  222. data/spec/models/model_type_spec.rb +24 -24
  223. data/spec/models/monthly_dividends_spec.rb +36 -36
  224. data/spec/models/net_contributions_spec.rb +42 -42
  225. data/spec/models/net_dividend_spec.rb +42 -42
  226. data/spec/models/option_chain_inner_chain_per_root_inner_chain_per_strike_price_inner_spec.rb +42 -42
  227. data/spec/models/option_chain_inner_chain_per_root_inner_spec.rb +42 -42
  228. data/spec/models/option_chain_inner_spec.rb +54 -54
  229. data/spec/models/option_leg_action_spec.rb +24 -24
  230. data/spec/models/option_leg_spec.rb +42 -42
  231. data/spec/models/option_strategy_legs_inner_spec.rb +48 -48
  232. data/spec/models/option_strategy_spec.rb +54 -54
  233. data/spec/models/options_get_option_strategy_request_spec.rb +42 -42
  234. data/spec/models/options_holdings_spec.rb +60 -60
  235. data/spec/models/options_place_option_strategy_request_spec.rb +42 -42
  236. data/spec/models/options_position_currency_spec.rb +42 -42
  237. data/spec/models/options_position_spec.rb +66 -66
  238. data/spec/models/options_symbol_spec.rb +72 -72
  239. data/spec/models/order_strategy_execute_body_order_type_spec.rb +24 -24
  240. data/spec/models/order_strategy_execute_body_time_in_force_spec.rb +24 -24
  241. data/spec/models/order_type_spec.rb +24 -24
  242. data/spec/models/partner_data_spec.rb +96 -96
  243. data/spec/models/past_value_spec.rb +42 -42
  244. data/spec/models/performance_custom_spec.rb +138 -138
  245. data/spec/models/portfolio_group_info_spec.rb +90 -90
  246. data/spec/models/portfolio_group_position_spec.rb +42 -42
  247. data/spec/models/portfolio_group_settings_spec.rb +54 -54
  248. data/spec/models/portfolio_group_spec.rb +36 -36
  249. data/spec/models/position_spec.rb +60 -60
  250. data/spec/models/position_symbol_spec.rb +60 -60
  251. data/spec/models/redirect_tokenand_pin_spec.rb +36 -36
  252. data/spec/models/security_type_spec.rb +48 -48
  253. data/spec/models/session_event_spec.rb +66 -66
  254. data/spec/models/session_event_type_spec.rb +24 -24
  255. data/spec/models/snap_trade_api_disclaimer_accept_status_spec.rb +36 -36
  256. data/spec/models/snap_trade_holdings_account_account_id_spec.rb +78 -78
  257. data/spec/models/snap_trade_holdings_account_spec.rb +72 -72
  258. data/spec/models/snap_trade_holdings_total_value_spec.rb +36 -36
  259. data/spec/models/snap_trade_login_user_request_body_spec.rb +54 -54
  260. data/spec/models/snap_trade_register_user_request_body_spec.rb +36 -36
  261. data/spec/models/state_spec.rb +24 -24
  262. data/spec/models/status_spec.rb +42 -42
  263. data/spec/models/strategy_impact_legs_inner_spec.rb +66 -66
  264. data/spec/models/strategy_impact_spec.rb +90 -90
  265. data/spec/models/strategy_order_place_orders_inner_legs_inner_spec.rb +66 -66
  266. data/spec/models/strategy_order_place_orders_inner_spec.rb +282 -282
  267. data/spec/models/strategy_order_place_spec.rb +36 -36
  268. data/spec/models/strategy_order_record_order_type_spec.rb +24 -24
  269. data/spec/models/strategy_order_record_spec.rb +90 -90
  270. data/spec/models/strategy_order_record_status_spec.rb +24 -24
  271. data/spec/models/strategy_order_record_time_in_force_spec.rb +24 -24
  272. data/spec/models/strategy_quotes_greek_spec.rb +54 -54
  273. data/spec/models/strategy_quotes_spec.rb +60 -60
  274. data/spec/models/strategy_type_spec.rb +24 -24
  275. data/spec/models/sub_period_return_rate_spec.rb +42 -42
  276. data/spec/models/symbol_query_spec.rb +30 -30
  277. data/spec/models/symbol_spec.rb +66 -66
  278. data/spec/models/symbols_quotes_inner_spec.rb +60 -60
  279. data/spec/models/target_asset_spec.rb +60 -60
  280. data/spec/models/time_in_force_spec.rb +24 -24
  281. data/spec/models/trade_action_spec.rb +24 -24
  282. data/spec/models/trade_execution_status_action_spec.rb +24 -24
  283. data/spec/models/trade_execution_status_spec.rb +78 -78
  284. data/spec/models/trade_impact_spec.rb +54 -54
  285. data/spec/models/trade_spec.rb +72 -72
  286. data/spec/models/trading_cancel_user_account_order_request_spec.rb +30 -30
  287. data/spec/models/trading_place_oco_order_request_spec.rb +36 -36
  288. data/spec/models/transactions_status_spec.rb +36 -36
  289. data/spec/models/type_spec.rb +24 -24
  290. data/spec/models/underlying_symbol_spec.rb +66 -66
  291. data/spec/models/universal_activity_spec.rb +120 -120
  292. data/spec/models/universal_symbol_spec.rb +72 -72
  293. data/spec/models/universal_symbol_ticker_spec.rb +72 -72
  294. data/spec/models/us_exchange_spec.rb +78 -78
  295. data/spec/models/user_error_log_spec.rb +60 -60
  296. data/spec/models/user_i_dand_secret_spec.rb +36 -36
  297. data/spec/models/user_settings_spec.rb +84 -84
  298. data/spec/spec_helper.rb +6 -6
  299. metadata +116 -116
@@ -1,183 +1,183 @@
1
- # SnapTrade::TransactionsAndReportingApi
2
-
3
- All URIs are relative to *https://api.snaptrade.com/api/v1*
4
-
5
- | Method | HTTP request | Description |
6
- | ------ | ------------ | ----------- |
7
- | [**get_activities**](TransactionsAndReportingApi.md#get_activities) | **GET** /activities | Get transaction history for a user |
8
- | [**get_reporting_custom_range**](TransactionsAndReportingApi.md#get_reporting_custom_range) | **GET** /performance/custom | Get performance information for a specific timeframe |
9
-
10
- ## get_activities
11
-
12
- Get transaction history for a user
13
-
14
- Returns activities (transactions) for a user. Specifing start and end date is highly recommended for automatic calls for better performance
15
-
16
- ### Example
17
-
18
- ```ruby
19
- require 'snaptrade'
20
-
21
- SnapTrade.client_id = "YOUR_CLIENT_ID"
22
- SnapTrade.consumer_key = "YOUR_CONSUMER_KEY"
23
-
24
- user_id = "John.doe@snaptrade.com"
25
- user_secret = "USERSECRET123"
26
- start_date = "2022-01-24"
27
- end_date = "2022-01-24"
28
- accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
29
- brokerage_authorizations = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
30
- type = "DIVIDEND"
31
-
32
- begin
33
- # Get transaction history for a user
34
- result = SnapTrade::TransactionsAndReporting.get_activities(
35
- user_id: user_id,
36
- user_secret: user_secret,
37
- start_date: start_date,
38
- end_date: end_date,
39
- accounts: accounts,
40
- brokerage_authorizations: brokerage_authorizations,
41
- type: type,
42
- )
43
- p result
44
- rescue SnapTrade::ApiError => e
45
- puts "Exception when calling SnapTrade::TransactionsAndReporting.get_activities: #{e}"
46
- end
47
- ```
48
-
49
- #### Using the get_activities_with_http_info variant
50
-
51
- This returns an Array which contains the response data, status code and headers.
52
-
53
- ```ruby
54
- user_id = "John.doe@snaptrade.com"
55
- user_secret = "USERSECRET123"
56
- start_date = "2022-01-24"
57
- end_date = "2022-01-24"
58
- accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
59
- brokerage_authorizations = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
60
- type = "DIVIDEND"
61
-
62
- begin
63
- # Get transaction history for a user
64
- data, status_code, headers, response = SnapTrade::TransactionsAndReporting.get_activities_with_http_info(
65
- user_id: user_id,
66
- user_secret: user_secret,
67
- start_date: start_date,
68
- end_date: end_date,
69
- accounts: accounts,
70
- brokerage_authorizations: brokerage_authorizations,
71
- type: type,
72
- )
73
- p status_code # => 2xx
74
- p headers # => { ... }
75
- p data # => Array<UniversalActivity>
76
- rescue SnapTrade::ApiError => e
77
- puts "Exception when calling SnapTrade::TransactionsAndReporting.get_activities: #{e}"
78
- end
79
- ```
80
-
81
- ### Parameters
82
-
83
- | Name | Type | Description | Notes |
84
- | ---- | ---- | ----------- | ----- |
85
- | **user_id** | **String** | | |
86
- | **user_secret** | **String** | | |
87
- | **start_date** | **Date** | | [optional] |
88
- | **end_date** | **Date** | | [optional] |
89
- | **accounts** | **String** | Optional comma seperated list of account IDs used to filter the request on specific accounts | [optional] |
90
- | **brokerage_authorizations** | **String** | Optional comma seperated list of brokerage authorization IDs used to filter the request on only accounts that belong to those authorizations | [optional] |
91
- | **type** | **String** | Optional comma seperated list of types to filter activities by. This is not an exhaustive list, if we fail to match to these types, we will return the raw description from the brokerage. Potential values include - DIVIDEND - BUY - SELL - CONTRIBUTION - WITHDRAWAL - EXTERNAL_ASSET_TRANSFER_IN - EXTERNAL_ASSET_TRANSFER_OUT - INTERNAL_CASH_TRANSFER_IN - INTERNAL_CASH_TRANSFER_OUT - INTERNAL_ASSET_TRANSFER_IN - INTERNAL_ASSET_TRANSFER_OUT - INTEREST - REBATE - GOV_GRANT - TAX - FEE - REI - FXT | [optional] |
92
-
93
- ### Return type
94
-
95
- [**Array&lt;UniversalActivity&gt;**](UniversalActivity.md)
96
-
97
- ## get_reporting_custom_range
98
-
99
- Get performance information for a specific timeframe
100
-
101
- Returns performance information (contributions, dividends, rate of return, etc) for a specific timeframe. Total Equity Timeframe and Rate of Returns are experimental and should not be trusted to be 100% accurate
102
-
103
- ### Example
104
-
105
- ```ruby
106
- require 'snaptrade'
107
-
108
- SnapTrade.client_id = "YOUR_CLIENT_ID"
109
- SnapTrade.consumer_key = "YOUR_CONSUMER_KEY"
110
-
111
- start_date = "2022-01-24"
112
- end_date = "2022-01-24"
113
- user_id = "John.doe@snaptrade.com"
114
- user_secret = "USERSECRET123"
115
- accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
116
- detailed = True
117
- frequency = "monthly"
118
-
119
- begin
120
- # Get performance information for a specific timeframe
121
- result = SnapTrade::TransactionsAndReporting.get_reporting_custom_range(
122
- start_date: start_date,
123
- end_date: end_date,
124
- user_id: user_id,
125
- user_secret: user_secret,
126
- accounts: accounts,
127
- detailed: detailed,
128
- frequency: frequency,
129
- )
130
- p result
131
- rescue SnapTrade::ApiError => e
132
- puts "Exception when calling SnapTrade::TransactionsAndReporting.get_reporting_custom_range: #{e}"
133
- end
134
- ```
135
-
136
- #### Using the get_reporting_custom_range_with_http_info variant
137
-
138
- This returns an Array which contains the response data, status code and headers.
139
-
140
- ```ruby
141
- start_date = "2022-01-24"
142
- end_date = "2022-01-24"
143
- user_id = "John.doe@snaptrade.com"
144
- user_secret = "USERSECRET123"
145
- accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
146
- detailed = True
147
- frequency = "monthly"
148
-
149
- begin
150
- # Get performance information for a specific timeframe
151
- data, status_code, headers, response = SnapTrade::TransactionsAndReporting.get_reporting_custom_range_with_http_info(
152
- start_date: start_date,
153
- end_date: end_date,
154
- user_id: user_id,
155
- user_secret: user_secret,
156
- accounts: accounts,
157
- detailed: detailed,
158
- frequency: frequency,
159
- )
160
- p status_code # => 2xx
161
- p headers # => { ... }
162
- p data # => PerformanceCustom
163
- rescue SnapTrade::ApiError => e
164
- puts "Exception when calling SnapTrade::TransactionsAndReporting.get_reporting_custom_range: #{e}"
165
- end
166
- ```
167
-
168
- ### Parameters
169
-
170
- | Name | Type | Description | Notes |
171
- | ---- | ---- | ----------- | ----- |
172
- | **start_date** | **Date** | | |
173
- | **end_date** | **Date** | | |
174
- | **user_id** | **String** | | |
175
- | **user_secret** | **String** | | |
176
- | **accounts** | **String** | Optional comma seperated list of account IDs used to filter the request on specific accounts | [optional] |
177
- | **detailed** | **Boolean** | Optional, increases frequency of data points for the total value and contribution charts if set to true | [optional] |
178
- | **frequency** | **String** | Optional frequency for the rate of return chart (defaults to monthly). Possible values are daily, weekly, monthly, quarterly, yearly. | [optional] |
179
-
180
- ### Return type
181
-
182
- [**PerformanceCustom**](PerformanceCustom.md)
183
-
1
+ # SnapTrade::TransactionsAndReportingApi
2
+
3
+ All URIs are relative to *https://api.snaptrade.com/api/v1*
4
+
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**get_activities**](TransactionsAndReportingApi.md#get_activities) | **GET** /activities | Get transaction history for a user |
8
+ | [**get_reporting_custom_range**](TransactionsAndReportingApi.md#get_reporting_custom_range) | **GET** /performance/custom | Get performance information for a specific timeframe |
9
+
10
+ ## get_activities
11
+
12
+ Get transaction history for a user
13
+
14
+ Returns activities (transactions) for a user. Specifing start and end date is highly recommended for automatic calls for better performance
15
+
16
+ ### Example
17
+
18
+ ```ruby
19
+ require 'snaptrade'
20
+
21
+ SnapTrade.client_id = "YOUR_CLIENT_ID"
22
+ SnapTrade.consumer_key = "YOUR_CONSUMER_KEY"
23
+
24
+ user_id = "John.doe@snaptrade.com"
25
+ user_secret = "USERSECRET123"
26
+ start_date = "2022-01-24"
27
+ end_date = "2022-01-24"
28
+ accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
29
+ brokerage_authorizations = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
30
+ type = "DIVIDEND"
31
+
32
+ begin
33
+ # Get transaction history for a user
34
+ result = SnapTrade::TransactionsAndReporting.get_activities(
35
+ user_id: user_id,
36
+ user_secret: user_secret,
37
+ start_date: start_date,
38
+ end_date: end_date,
39
+ accounts: accounts,
40
+ brokerage_authorizations: brokerage_authorizations,
41
+ type: type,
42
+ )
43
+ p result
44
+ rescue SnapTrade::ApiError => e
45
+ puts "Exception when calling SnapTrade::TransactionsAndReporting.get_activities: #{e}"
46
+ end
47
+ ```
48
+
49
+ #### Using the get_activities_with_http_info variant
50
+
51
+ This returns an Array which contains the response data, status code and headers.
52
+
53
+ ```ruby
54
+ user_id = "John.doe@snaptrade.com"
55
+ user_secret = "USERSECRET123"
56
+ start_date = "2022-01-24"
57
+ end_date = "2022-01-24"
58
+ accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
59
+ brokerage_authorizations = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
60
+ type = "DIVIDEND"
61
+
62
+ begin
63
+ # Get transaction history for a user
64
+ data, status_code, headers, response = SnapTrade::TransactionsAndReporting.get_activities_with_http_info(
65
+ user_id: user_id,
66
+ user_secret: user_secret,
67
+ start_date: start_date,
68
+ end_date: end_date,
69
+ accounts: accounts,
70
+ brokerage_authorizations: brokerage_authorizations,
71
+ type: type,
72
+ )
73
+ p status_code # => 2xx
74
+ p headers # => { ... }
75
+ p data # => Array<UniversalActivity>
76
+ rescue SnapTrade::ApiError => e
77
+ puts "Exception when calling SnapTrade::TransactionsAndReporting.get_activities: #{e}"
78
+ end
79
+ ```
80
+
81
+ ### Parameters
82
+
83
+ | Name | Type | Description | Notes |
84
+ | ---- | ---- | ----------- | ----- |
85
+ | **user_id** | **String** | | |
86
+ | **user_secret** | **String** | | |
87
+ | **start_date** | **Date** | | [optional] |
88
+ | **end_date** | **Date** | | [optional] |
89
+ | **accounts** | **String** | Optional comma seperated list of account IDs used to filter the request on specific accounts | [optional] |
90
+ | **brokerage_authorizations** | **String** | Optional comma seperated list of brokerage authorization IDs used to filter the request on only accounts that belong to those authorizations | [optional] |
91
+ | **type** | **String** | Optional comma seperated list of types to filter activities by. This is not an exhaustive list, if we fail to match to these types, we will return the raw description from the brokerage. Potential values include - DIVIDEND - BUY - SELL - CONTRIBUTION - WITHDRAWAL - EXTERNAL_ASSET_TRANSFER_IN - EXTERNAL_ASSET_TRANSFER_OUT - INTERNAL_CASH_TRANSFER_IN - INTERNAL_CASH_TRANSFER_OUT - INTERNAL_ASSET_TRANSFER_IN - INTERNAL_ASSET_TRANSFER_OUT - INTEREST - REBATE - GOV_GRANT - TAX - FEE - REI - FXT | [optional] |
92
+
93
+ ### Return type
94
+
95
+ [**Array&lt;UniversalActivity&gt;**](UniversalActivity.md)
96
+
97
+ ## get_reporting_custom_range
98
+
99
+ Get performance information for a specific timeframe
100
+
101
+ Returns performance information (contributions, dividends, rate of return, etc) for a specific timeframe. Total Equity Timeframe and Rate of Returns are experimental and should not be trusted to be 100% accurate
102
+
103
+ ### Example
104
+
105
+ ```ruby
106
+ require 'snaptrade'
107
+
108
+ SnapTrade.client_id = "YOUR_CLIENT_ID"
109
+ SnapTrade.consumer_key = "YOUR_CONSUMER_KEY"
110
+
111
+ start_date = "2022-01-24"
112
+ end_date = "2022-01-24"
113
+ user_id = "John.doe@snaptrade.com"
114
+ user_secret = "USERSECRET123"
115
+ accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
116
+ detailed = True
117
+ frequency = "monthly"
118
+
119
+ begin
120
+ # Get performance information for a specific timeframe
121
+ result = SnapTrade::TransactionsAndReporting.get_reporting_custom_range(
122
+ start_date: start_date,
123
+ end_date: end_date,
124
+ user_id: user_id,
125
+ user_secret: user_secret,
126
+ accounts: accounts,
127
+ detailed: detailed,
128
+ frequency: frequency,
129
+ )
130
+ p result
131
+ rescue SnapTrade::ApiError => e
132
+ puts "Exception when calling SnapTrade::TransactionsAndReporting.get_reporting_custom_range: #{e}"
133
+ end
134
+ ```
135
+
136
+ #### Using the get_reporting_custom_range_with_http_info variant
137
+
138
+ This returns an Array which contains the response data, status code and headers.
139
+
140
+ ```ruby
141
+ start_date = "2022-01-24"
142
+ end_date = "2022-01-24"
143
+ user_id = "John.doe@snaptrade.com"
144
+ user_secret = "USERSECRET123"
145
+ accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
146
+ detailed = True
147
+ frequency = "monthly"
148
+
149
+ begin
150
+ # Get performance information for a specific timeframe
151
+ data, status_code, headers, response = SnapTrade::TransactionsAndReporting.get_reporting_custom_range_with_http_info(
152
+ start_date: start_date,
153
+ end_date: end_date,
154
+ user_id: user_id,
155
+ user_secret: user_secret,
156
+ accounts: accounts,
157
+ detailed: detailed,
158
+ frequency: frequency,
159
+ )
160
+ p status_code # => 2xx
161
+ p headers # => { ... }
162
+ p data # => PerformanceCustom
163
+ rescue SnapTrade::ApiError => e
164
+ puts "Exception when calling SnapTrade::TransactionsAndReporting.get_reporting_custom_range: #{e}"
165
+ end
166
+ ```
167
+
168
+ ### Parameters
169
+
170
+ | Name | Type | Description | Notes |
171
+ | ---- | ---- | ----------- | ----- |
172
+ | **start_date** | **Date** | | |
173
+ | **end_date** | **Date** | | |
174
+ | **user_id** | **String** | | |
175
+ | **user_secret** | **String** | | |
176
+ | **accounts** | **String** | Optional comma seperated list of account IDs used to filter the request on specific accounts | [optional] |
177
+ | **detailed** | **Boolean** | Optional, increases frequency of data points for the total value and contribution charts if set to true | [optional] |
178
+ | **frequency** | **String** | Optional frequency for the rate of return chart (defaults to monthly). Possible values are daily, weekly, monthly, quarterly, yearly. | [optional] |
179
+
180
+ ### Return type
181
+
182
+ [**PerformanceCustom**](PerformanceCustom.md)
183
+