snaptrade 2.0.7 → 2.0.8

data/docs/TransactionsAndReportingApi.md

@@ -1,183 +0,0 @@
-# SnapTrade::TransactionsAndReportingApi
-
-All URIs are relative to *https://api.snaptrade.com/api/v1*
-
-| Method | HTTP request | Description |
-| ------ | ------------ | ----------- |
-| [**get_activities**](TransactionsAndReportingApi.md#get_activities) | **GET** /activities | Get transaction history for a user |
-| [**get_reporting_custom_range**](TransactionsAndReportingApi.md#get_reporting_custom_range) | **GET** /performance/custom | Get performance information for a specific timeframe |
-
-## get_activities
-
-Get transaction history for a user
-
-Returns activities (transactions) for a user. Specifying start and end date is highly recommended for better performance
-
-### Example
-
-```ruby
-require 'snaptrade'
-
-SnapTrade.client_id = "YOUR_CLIENT_ID"
-SnapTrade.consumer_key = "YOUR_CONSUMER_KEY"
-
-user_id = "John.doe@snaptrade.com"
-user_secret = "USERSECRET123"
-start_date = "2022-01-24"
-end_date = "2022-01-24"
-accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
-brokerage_authorizations = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
-type = "DIVIDEND"
-
-begin
-  # Get transaction history for a user
-  result = SnapTrade::TransactionsAndReporting.get_activities(
-                                                                 user_id: user_id,
-                                                                 user_secret: user_secret,
-                                                                 start_date: start_date,
-                                                                 end_date: end_date,
-                                                                 accounts: accounts,
-                                                                 brokerage_authorizations: brokerage_authorizations,
-                                                                 type: type,
-                                                               )
-  p result
-rescue SnapTrade::ApiError => e
-  puts "Exception when calling SnapTrade::TransactionsAndReporting.get_activities: #{e}"
-end
-```
-
-#### Using the get_activities_with_http_info variant
-
-This returns an Array which contains the response data, status code and headers.
-
-```ruby
-user_id = "John.doe@snaptrade.com"
-user_secret = "USERSECRET123"
-start_date = "2022-01-24"
-end_date = "2022-01-24"
-accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
-brokerage_authorizations = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
-type = "DIVIDEND"
-
-begin
-  # Get transaction history for a user
-  data, status_code, headers, response = SnapTrade::TransactionsAndReporting.get_activities_with_http_info(
-                                                                                                              user_id: user_id,
-                                                                                                              user_secret: user_secret,
-                                                                                                              start_date: start_date,
-                                                                                                              end_date: end_date,
-                                                                                                              accounts: accounts,
-                                                                                                              brokerage_authorizations: brokerage_authorizations,
-                                                                                                              type: type,
-                                                                                                            )
-  p status_code # => 2xx
-  p headers # => { ... }
-  p data # => Array<UniversalActivity>
-rescue SnapTrade::ApiError => e
-  puts "Exception when calling SnapTrade::TransactionsAndReporting.get_activities: #{e}"
-end
-```
-
-### Parameters
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **user_id** | **String** |  |  |
-| **user_secret** | **String** |  |  |
-| **start_date** | **Date** |  | [optional] |
-| **end_date** | **Date** |  | [optional] |
-| **accounts** | **String** | Optional comma seperated list of account IDs used to filter the request on specific accounts | [optional] |
-| **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] |
-| **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] |
-
-### Return type
-
-[**Array&lt;UniversalActivity&gt;**](UniversalActivity.md)
-
-## get_reporting_custom_range
-
-Get performance information for a specific timeframe
-
-Returns performance information (contributions, dividends, rate of return, etc) for a specific timeframe. Please note that Total Equity Timeframe and Rate of Returns are experimental features. Please contact support@snaptrade.com if you notice any inconsistencies.
-
-### Example
-
-```ruby
-require 'snaptrade'
-
-SnapTrade.client_id = "YOUR_CLIENT_ID"
-SnapTrade.consumer_key = "YOUR_CONSUMER_KEY"
-
-start_date = "2022-01-24"
-end_date = "2022-01-24"
-user_id = "John.doe@snaptrade.com"
-user_secret = "USERSECRET123"
-accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
-detailed = True
-frequency = "monthly"
-
-begin
-  # Get performance information for a specific timeframe
-  result = SnapTrade::TransactionsAndReporting.get_reporting_custom_range(
-                                                                             start_date: start_date,
-                                                                             end_date: end_date,
-                                                                             user_id: user_id,
-                                                                             user_secret: user_secret,
-                                                                             accounts: accounts,
-                                                                             detailed: detailed,
-                                                                             frequency: frequency,
-                                                                           )
-  p result
-rescue SnapTrade::ApiError => e
-  puts "Exception when calling SnapTrade::TransactionsAndReporting.get_reporting_custom_range: #{e}"
-end
-```
-
-#### Using the get_reporting_custom_range_with_http_info variant
-
-This returns an Array which contains the response data, status code and headers.
-
-```ruby
-start_date = "2022-01-24"
-end_date = "2022-01-24"
-user_id = "John.doe@snaptrade.com"
-user_secret = "USERSECRET123"
-accounts = "917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2"
-detailed = True
-frequency = "monthly"
-
-begin
-  # Get performance information for a specific timeframe
-  data, status_code, headers, response = SnapTrade::TransactionsAndReporting.get_reporting_custom_range_with_http_info(
-                                                                                                                          start_date: start_date,
-                                                                                                                          end_date: end_date,
-                                                                                                                          user_id: user_id,
-                                                                                                                          user_secret: user_secret,
-                                                                                                                          accounts: accounts,
-                                                                                                                          detailed: detailed,
-                                                                                                                          frequency: frequency,
-                                                                                                                        )
-  p status_code # => 2xx
-  p headers # => { ... }
-  p data # => PerformanceCustom
-rescue SnapTrade::ApiError => e
-  puts "Exception when calling SnapTrade::TransactionsAndReporting.get_reporting_custom_range: #{e}"
-end
-```
-
-### Parameters
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **start_date** | **Date** |  |  |
-| **end_date** | **Date** |  |  |
-| **user_id** | **String** |  |  |
-| **user_secret** | **String** |  |  |
-| **accounts** | **String** | Optional comma seperated list of account IDs used to filter the request on specific accounts | [optional] |
-| **detailed** | **Boolean** | Optional, increases frequency of data points for the total value and contribution charts if set to true | [optional] |
-| **frequency** | **String** | Optional frequency for the rate of return chart (defaults to monthly). Possible values are daily, weekly, monthly, quarterly, yearly. | [optional] |
-
-### Return type
-
-[**PerformanceCustom**](PerformanceCustom.md)
-

data/docs/TransactionsStatus.md

@@ -1,20 +0,0 @@
-# SnapTrade::TransactionsStatus
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **initial_sync_completed** | **Boolean** |  | [optional] |
-| **last_successful_sync** | **Date** | Date in YYYY-MM-DD format or null | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::TransactionsStatus.new(
-  initial_sync_completed: null,
-  last_successful_sync: Mon Jan 24 00:00:00 UTC 2022
-)
-```
-

data/docs/Type.md

@@ -1,15 +0,0 @@
-# SnapTrade::Type
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::Type.new()
-```
-

data/docs/USExchange.md

@@ -1,34 +0,0 @@
-# SnapTrade::USExchange
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **id** | **String** |  | [optional] |
-| **code** | **String** |  | [optional] |
-| **mic_code** | **String** |  | [optional] |
-| **name** | **String** |  | [optional] |
-| **timezone** | **String** |  | [optional] |
-| **start_time** | **String** |  | [optional] |
-| **close_time** | **String** |  | [optional] |
-| **suffix** | **String** |  | [optional] |
-| **allows_cryptocurrency_symbols** | **Boolean** |  | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::USExchange.new(
-  id: 2bcd7cc3-e922-4976-bce1-9858296801c3,
-  code: ARCX,
-  mic_code: ARCA,
-  name: NYSE ARCA,
-  timezone: America/New_York,
-  start_time: 09:30:00,
-  close_time: 57600,
-  suffix: None,
-  allows_cryptocurrency_symbols: false
-)
-```
-

data/docs/UnderlyingSymbol.md

@@ -1,32 +0,0 @@
-# SnapTrade::UnderlyingSymbol
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **id** | **String** |  | [optional] |
-| **symbol** | **String** |  | [optional] |
-| **description** | **String** |  | [optional] |
-| **currency** | [**Currency**](Currency.md) |  | [optional] |
-| **exchange** | [**USExchange**](USExchange.md) |  | [optional] |
-| **type** | [**SecurityType**](SecurityType.md) |  | [optional] |
-| **currencies** | [**Array<Currency>**](Currency.md) |  | [optional] |
-| **figi_code** | **String** |  | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::UnderlyingSymbol.new(
-  id: 2bcd7cc3-e922-4976-bce1-9858296801c3,
-  symbol: SPY,
-  description: SPDR S&P 500 ETF Trust,
-  currency: null,
-  exchange: null,
-  type: null,
-  currencies: null,
-  figi_code: BBG000B9XRY4
-)
-```
-

data/docs/UniversalActivity.md

@@ -1,50 +0,0 @@
-# SnapTrade::UniversalActivity
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **id** | **String** |  | [optional] |
-| **account** | [**AccountSimple**](AccountSimple.md) |  | [optional] |
-| **amount** | **Float** |  | [optional] |
-| **currency** | [**Currency**](Currency.md) |  | [optional] |
-| **description** | **String** |  | [optional] |
-| **fee** | **Float** |  | [optional] |
-| **fx_rate** | **Float** | The forex conversion rate involved in the transaction if provided by the brokerage. Used in cases where securities of one currency are purchased in a different currency, and the forex conversion is automatic. In those cases, price, amount and fee will be in the top level currency (activity -> currency) | [optional] |
-| **institution** | **String** |  | [optional] |
-| **option_type** | **String** | If an option transaction, then it's type (BUY_TO_OPEN, SELL_TO_CLOSE, etc), otherwise empty string | [optional] |
-| **price** | **Float** |  | [optional] |
-| **settlement_date** | **String** |  | [optional] |
-| **external_reference_id** | **String** | Reference ID from brokerage used to identify related transactions. For example if an order comprises of several transactions (buy, fee, fx), they can be grouped if they share the same external_reference_id | [optional] |
-| **symbol** | [**Symbol**](Symbol.md) |  | [optional] |
-| **option_symbol** | [**OptionsSymbol**](OptionsSymbol.md) |  | [optional] |
-| **trade_date** | **String** |  | [optional] |
-| **type** | **String** | Potential values include (but are not limited to) - 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] |
-| **units** | **Float** | Usually but not necessarily an integer | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::UniversalActivity.new(
-  id: 2f7dc9b3-5c33-4668-3440-2b31e056ebe6,
-  account: null,
-  amount: 263.82,
-  currency: null,
-  description: WALT DISNEY UNIT DIST ON 21 SHS REC 12/31/21 PAY 01/06/22,
-  fee: 0,
-  fx_rate: 1.032,
-  institution: SnapTrade Investr,
-  option_type: BUY_TO_OPEN,
-  price: 0.4,
-  settlement_date: 2022-01-06T05:00:00.000Z,
-  external_reference_id: 2f7dc9b3-5c33-4668-3440-2b31e056ebe6,
-  symbol: null,
-  option_symbol: null,
-  trade_date: 2022-01-06T05:00:00.000Z,
-  type: null,
-  units: 5
-)
-```
-

data/docs/UniversalSymbol.md

@@ -1,34 +0,0 @@
-# SnapTrade::UniversalSymbol
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **id** | **String** |  |  |
-| **symbol** | **String** |  |  |
-| **raw_symbol** | **String** |  |  |
-| **description** | **String** |  | [optional] |
-| **currency** | [**Currency**](Currency.md) |  |  |
-| **exchange** | [**Exchange**](Exchange.md) |  | [optional] |
-| **type** | [**SecurityType**](SecurityType.md) |  |  |
-| **currencies** | [**Array<Currency>**](Currency.md) |  |  |
-| **figi_code** | **String** |  | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::UniversalSymbol.new(
-  id: 2bcd7cc3-e922-4976-bce1-9858296801c3,
-  symbol: VAB.TO,
-  raw_symbol: VAB,
-  description: VANGUARD CDN AGGREGATE BOND INDEX ETF,
-  currency: null,
-  exchange: null,
-  type: null,
-  currencies: null,
-  figi_code: BBG000B9XRY4
-)
-```
-

data/docs/UserErrorLog.md

@@ -1,28 +0,0 @@
-# SnapTrade::UserErrorLog
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **requested_at** | **String** |  | [optional] |
-| **response** | **String** |  | [optional] |
-| **status_code** | **Float** |  | [optional] |
-| **_query_params** | **String** |  | [optional] |
-| **http_method** | **String** |  | [optional] |
-| **endpoint** | **String** |  | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::UserErrorLog.new(
-  requested_at: 2022-01-21T20:11:19.217Z,
-  response: null,
-  status_code: 200,
-  _query_params: null,
-  http_method: POST,
-  endpoint: api/v1/snapTrade
-)
-```
-

data/docs/UserIDandSecret.md

@@ -1,20 +0,0 @@
-# SnapTrade::UserIDandSecret
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **user_id** | **String** | SnapTrade User ID. Provided by SnapTrade Partner. Can be any string, as long as it's unique to a user | [optional] |
-| **user_secret** | **String** | SnapTrade User Secret randomly generated by SnapTrade. This should be considered priviledged information and if compromised, you should delete and re-create this SnapTrade user. | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::UserIDandSecret.new(
-  user_id: snaptrade-user-123,
-  user_secret: h81@cx1lkalablakwjaltkejraj11=
-)
-```
-

data/docs/UserSettings.md

@@ -1,36 +0,0 @@
-# SnapTrade::UserSettings
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **email** | **String** |  | [optional] |
-| **name** | **String** |  | [optional] |
-| **receive_cash_notification** | **Boolean** |  | [optional] |
-| **receive_drift_notification** | **Boolean** |  | [optional] |
-| **user_trial_activated** | **Boolean** |  | [optional] |
-| **activated_trial_date** | **String** |  | [optional] |
-| **demo** | **Boolean** |  | [optional] |
-| **api_enabled** | **Boolean** |  | [optional] |
-| **drift_threshold** | **Float** |  | [optional] |
-| **preferred_currency** | [**Currency**](Currency.md) |  | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::UserSettings.new(
-  email: ops@snaptrade.com,
-  name: James Bond,
-  receive_cash_notification: true,
-  receive_drift_notification: true,
-  user_trial_activated: true,
-  activated_trial_date: 2017-07-17T15:13:07.177712+00:00,
-  demo: false,
-  api_enabled: false,
-  drift_threshold: 95,
-  preferred_currency: null
-)
-```
-

data/docs/ValidatedTradeBody.md

@@ -1,18 +0,0 @@
-# SnapTrade::ValidatedTradeBody
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **wait_to_confirm** | **Boolean** | Optional, defaults to true. Determines if a wait is performed to check on order status. If false, latency will be reduced but orders returned will be more likely to be of status PENDING as we will not wait to check on the status before responding to the request | [optional] |
-
-## Example
-
-```ruby
-require 'snaptrade'
-
-instance = SnapTrade::ValidatedTradeBody.new(
-  wait_to_confirm: true
-)
-```
-