invest_tinkoff 0.9.2 → 0.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72803a0f76ad49daa5442e51b65777d51afe7f617844362888b35889a7ac5b74
-  data.tar.gz: 28f0c3cbf5154823e1942c3a7f20a8e4cf8ac715c20b7fb6d63fa1ff94b30785
+  metadata.gz: 15075f7de0ea08c8c024ccaa2fdec3e166c8d7d4a514a128b5b09a8fe4312ef4
+  data.tar.gz: 9df8ad68ffd0a8fbbdee0afb7322a8f544af22135155cbd5517f33cc48b3a49f
 SHA512:
-  metadata.gz: 953ee207b8d3c3f53d695d6009d25adc53956dd83134b1706980aa779c6589c10b25a0529079a686029c2414122ac795db27ab30b4843f49349843bb13b25d43
-  data.tar.gz: 166879c30f0a9ed386ff2a4836df6f71e21045a51b1b32a3fef918adc2d63a0b8928d63f8b5e339b000d1e6623f1394ac158dbb64f6d5a5feb431b2b1c636e59
+  metadata.gz: 82eefd3f326f9b8e7d14a8854938c23f805a3305a9afa9bbb6780763656b1d96b82c037436e4039b30ee6ab376a897f6ca236851d2d9887073c289af2675a69b
+  data.tar.gz: 6424579f75a7504c2a4cab2c646def21ddc2840eeef0d4636474ccd57d56719f3e467a1876c650a481d8e87088b1b43465490e856f8fb499b592a7e8191dd130

data/lib/invest_tinkoff/client_base.rb

@@ -4,7 +4,7 @@ module InvestTinkoff
   class ClientBase
     include HTTParty
 
-    def initialize token:, broker_account_id:, logger: nil
+    def initialize token:, broker_account_id: nil, logger: nil
       @token = token
       @broker_account_id = broker_account_id
       @logger = logger

data/lib/invest_tinkoff/v2/candle_interval.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Интервал свечей
+# https://tinkoff.github.io/investAPI/marketdata/#candleinterval
+class InvestTinkoff::V2::CandleInterval
+  # Интервал не определён
+  UNSPECIFIED = 0
+
+  # 1 минута
+  MIN_1 = 1
+
+  # 5 минут
+  MIN_5 = 2
+
+  # 15 минут
+  MIN_15 = 3
+
+  # 1 час
+  HOUR = 4
+
+  # 1 день
+  DAY = 5
+end

data/lib/invest_tinkoff/v2/client.rb

@@ -0,0 +1,545 @@
+# frozen_string_literal: true
+
+class InvestTinkoff::V2::Client < InvestTinkoff::ClientBase
+  base_uri 'https://invest-public-api.tinkoff.ru/rest/'
+
+  TIME_FORMAT = '%Y-%m-%dT%H:%m:%S.000Z'
+
+  def initialize token:, logger: nil
+    super(
+      token: token,
+      logger: logger
+    )
+  end
+
+  # ==========================================
+  # InstrumentsService
+  # ==========================================
+
+  # Метод получения облигации по её идентификатору.
+  # https://tinkoff.github.io/investAPI/instruments/#bondby
+  #
+  # @id_type: InvestTinkoff::V2::InstrumentIdType
+  # @id: String
+  # @class_code: String (Обязателен при id_type = TICKER)
+  #
+  # client.bond_by id_type: InvestTinkoff::V2::InstrumentIdType::FIGI, id: 'BBG00T22WKV5'
+  def bond_by id_type:, id:, class_code: nil
+    body = { idType: id_type, classCode: class_code, id: id }
+    instrument_request '/BondBy', body
+  end
+
+  # Метод получения списка облигаций.
+  # https://tinkoff.github.io/investAPI/instruments/#bonds
+  #
+  # @instrument_status: InvestTinkoff::V2::InstrumentStatus
+  def bonds instrument_status: InvestTinkoff::V2::InstrumentStatus::BASE
+    instrument_request '/Bonds', { instrumentStatus: instrument_status }
+  end
+
+  # Метод получения списка валют.
+  # https://tinkoff.github.io/investAPI/instruments/#currencies
+  #
+  # @instrument_status: InvestTinkoff::V2::InstrumentStatus
+  def currencies instrument_status: InvestTinkoff::V2::InstrumentStatus::BASE
+    instrument_request '/Currencies', { instrumentStatus: instrument_status }
+  end
+
+  # Метод получения валюты по её идентификатору.
+  # https://tinkoff.github.io/investAPI/instruments/#currencyby
+  #
+  # @id_type: InvestTinkoff::V2::InstrumentIdType
+  # @id: String
+  # @class_code: String (Обязателен при id_type = TICKER)
+  #
+  # client.currency_by id_type: InvestTinkoff::V2::InstrumentIdType::FIGI, id: 'BBG0013HQ5F0'
+  # client.currency_by id_type: InvestTinkoff::V2::InstrumentIdType::TICKER, id: 'GBPRUB_TOM', class_code: 'CETS'
+  def currency_by id_type:, id:, class_code: nil
+    body = { idType: id_type, classCode: class_code, id: id }
+    instrument_request '/CurrencyBy', body
+  end
+
+  # Метод редактирования избранных инструментов.
+  # https://tinkoff.github.io/investAPI/instruments/#editfavorites
+  #
+  # @figis: String, пример: ['BBG000B9XRY4', 'BBG000BWXBC2']
+  # @action_type: InvestTinkoff::V2::EditFavoritesActionType
+  def edit_favorites figis:, action_type: InvestTinkoff::V2::EditFavoritesActionType::ADD
+    body = {
+      instruments: figis.map { |v| { figi: v } },
+      actionType: action_type
+    }
+    instrument_request '/EditFavorites', body
+  end
+
+  # Метод получения инвестиционного фонда по его идентификатору.
+  # https://tinkoff.github.io/investAPI/instruments/#etfby
+  #
+  # @id_type: InvestTinkoff::V2::InstrumentIdType
+  # @id: String
+  # @class_code: String (Обязателен при id_type = TICKER)
+  #
+  # client.etf_by id_type: InvestTinkoff::V2::InstrumentIdType::FIGI, id: 'BBG005DXDPK9'
+  def etf_by id_type:, id:, class_code: nil
+    body = { idType: id_type, classCode: class_code, id: id }
+    instrument_request '/EtfBy', body
+  end
+
+  # Метод получения списка инвестиционных фондов.
+  # https://tinkoff.github.io/investAPI/instruments/#etfs
+  #
+  # @instrument_status: InvestTinkoff::V2::InstrumentStatus
+  def etfs instrument_status: InvestTinkoff::V2::InstrumentStatus::BASE
+    instrument_request '/Etfs', { instrumentStatus: instrument_status }
+  end
+
+  # Метод получения фьючерса по его идентификатору.
+  # https://tinkoff.github.io/investAPI/instruments/#futureby
+  #
+  # @id_type: InvestTinkoff::V2::InstrumentIdType
+  # @id: String
+  # @class_code: String (Обязателен при id_type = TICKER)
+  #
+  # client.future_by id_type: InvestTinkoff::V2::InstrumentIdType::FIGI, id: 'FUTNL0422000'
+  def future_by id_type:, id:, class_code: nil
+    body = { idType: id_type, classCode: class_code, id: id }
+    instrument_request '/FutureBy', body
+  end
+
+  # Метод получения списка фьючерсов.
+  # https://tinkoff.github.io/investAPI/instruments/#futures
+  #
+  # @instrument_status: InvestTinkoff::V2::InstrumentStatus
+  def futures instrument_status: InvestTinkoff::V2::InstrumentStatus::BASE
+    instrument_request '/Futures', { instrumentStatus: instrument_status }
+  end
+
+  # Метод получения накопленного купонного дохода по облигации.
+  # https://tinkoff.github.io/investAPI/instruments/#getaccruedinterests
+  #
+  # @figi: String, пример: 'BBG00X6ZGSY7'
+  # @from: Time, пример: 1.year.ago
+  # @to: Time, пример: 2.months.from_now
+  def accrued_interests figi:, from:, to:
+    body = {
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT)
+    }
+    instrument_request '/GetAccruedInterests', body
+  end
+
+  # Метод получения актива по его идентификатору.
+  # https://tinkoff.github.io/investAPI/instruments/#getassetby
+  #
+  # @id: String, пример: '9f083982-cf4c-418a-a0bf-8b82f16db42d'
+  def asset_by id:
+    instrument_request '/GetAssetBy', { id: id }
+  end
+
+  # Метод получения списка активов.
+  # https://tinkoff.github.io/investAPI/instruments/#getassets
+  def assets
+    instrument_request '/GetAssets'
+  end
+
+  # Метод получения графика выплат купонов по облигации.
+  # https://tinkoff.github.io/investAPI/instruments/#getbondcoupons
+  #
+  # @figi: String, пример: 'BBG00X6ZGSY7'
+  # @from: Time, пример: 1.year.ago
+  # @to: Time, пример: 6.months.from_now
+  def bond_coupons figi:, from:, to:
+    body = {
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT)
+    }
+    instrument_request '/GetBondCoupons', body
+  end
+
+  # Метод для получения событий выплаты дивидендов по инструменту.
+  # https://tinkoff.github.io/investAPI/instruments/#getdividends
+  #
+  # @figi: String, пример: 'BBG000B9XRY4'
+  # @from: Time, пример: 1.year.ago
+  # @to: Time, пример: 1.month.from_now
+  def dividends figi:, from:, to:
+    body = {
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT)
+    }
+    instrument_request '/GetDividends', body
+  end
+
+  # Метод получения избранных инструментов.
+  # https://tinkoff.github.io/investAPI/instruments/#getfavorites
+  def favorites
+    instrument_request '/GetFavorites'
+  end
+
+  # Метод получения размера гарантийного обеспечения по фьючерсам.
+  # https://tinkoff.github.io/investAPI/instruments/#getfuturesmargin
+  #
+  # @figi: String
+  def futures_margin figi:
+    instrument_request '/GetFuturesMargin', { figi: figi }
+  end
+
+  # Метод получения основной информации об инструменте.
+  # https://tinkoff.github.io/investAPI/instruments/#getinstrumentby
+  #
+  # @id_type: InvestTinkoff::V2::InstrumentIdType
+  # @id: String
+  # @class_code: String (Обязателен при id_type = TICKER)
+  #
+  # client.instrument_by id_type: InvestTinkoff::V2::InstrumentIdType::FIGI, id: 'BBG000B9XRY4'
+  def instrument_by id_type:, id:, class_code: nil
+    body = { idType: id_type, classCode: class_code, id: id }
+    instrument_request '/GetInstrumentBy', body
+  end
+
+  # Метод получения акции по её идентификатору.
+  # https://tinkoff.github.io/investAPI/instruments/#shareby
+  #
+  # @id_type: InvestTinkoff::V2::InstrumentIdType
+  # @id: String
+  # @class_code: String (Обязателен при id_type = TICKER)
+  #
+  # client.share_by id_type: InvestTinkoff::V2::InstrumentIdType::FIGI, id: 'BBG000B9XRY4'
+  def share_by id_type:, id:, class_code: nil
+    body = { idType: id_type, classCode: class_code, id: id }
+    instrument_request '/ShareBy', body
+  end
+
+  # Метод получения списка акций.
+  # https://tinkoff.github.io/investAPI/instruments/#shares
+  #
+  # @instrument_status: InvestTinkoff::V2::InstrumentStatus
+  def shares instrument_status: InvestTinkoff::V2::InstrumentStatus::BASE
+    instrument_request '/Shares', { instrumentStatus: instrument_status }
+  end
+
+  # Метод получения расписания торгов торговых площадок.
+  # https://tinkoff.github.io/investAPI/instruments/#tradingschedulesrequest
+  #
+  # @exchange: String, пример: 'MOEX'
+  # @from: Time, пример: 1.day.from_now
+  # @to: Time, пример: 5.days.from_now
+  def trading_schedules exchange:, from:, to:
+    body = {
+      exchange: exchange,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT)
+    }
+    instrument_request '/TradingSchedules', body
+  end
+
+  # ==========================================
+  # MarketDataService
+  # ==========================================
+
+  # Метод запроса исторических свечей по инструменту.
+  # https://tinkoff.github.io/investAPI/marketdata/#getcandles
+  #
+  # @figi: String, пример: 'BBG000B9XRY4'
+  # @from: Time, пример: 1.hour.ago
+  # @to: Time, пример: Time.zone.now
+  # @interval: InvestTinkoff::V2::CandleInterval
+  def candles figi:, from:, to:, interval: InvestTinkoff::V2::CandleInterval::HOUR
+    body = {
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT),
+      interval: interval
+    }
+    market_request '/GetCandles', body
+  end
+
+  # Метод запроса последних цен по инструментам.
+  # https://tinkoff.github.io/investAPI/marketdata/#getlastprices
+  #
+  # @figis: String, пример: ['BBG000B9XRY4', 'BBG000BWXBC2']
+  def last_prices figis:
+    market_request '/GetLastPrices', { figi: figis }
+  end
+
+  # Метод запроса последних обезличенных сделок по инструменту.
+  # https://tinkoff.github.io/investAPI/marketdata/#getlasttrades
+  #
+  # @figi: String, пример: 'BBG000B9XRY4'
+  # @from: Time, пример: 1.hour.ago
+  # @to: Time, пример: Time.zone.now
+  def last_trades figi:, from:, to:
+    body = {
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT)
+    }
+    market_request '/GetLastTrades', body
+  end
+
+  # Метод получения стакана по инструменту.
+  # https://tinkoff.github.io/investAPI/marketdata/#getorderbook
+  #
+  # @figi: String, пример: 'BBG000B9XRY4'
+  # @depth: Integer
+  def order_book figi:, depth: 10
+    market_request '/GetOrderBook', { figi: figi, depth: depth }
+  end
+
+  # Метод запроса статуса торгов по инструментам.
+  # https://tinkoff.github.io/investAPI/marketdata/#gettradingstatus
+  #
+  # @figi: String, пример: 'BBG000B9XRY4'
+  def trading_status figi:
+    market_request '/GetTradingStatus', { figi: figi }
+  end
+
+  # ==========================================
+  # OperationsService
+  # ==========================================
+
+  # Метод получения брокерского отчёта.
+  # https://tinkoff.github.io/investAPI/operations/#getbrokerreport
+  def broker_report
+    # operation_request '/GetBrokerReport', body
+    raise NotImplementedError
+  end
+
+  # Метод получения отчёта "Справка о доходах за пределами РФ".
+  # https://tinkoff.github.io/investAPI/operations/#getdividendsforeignissuer
+  def dividends_foreign_issuer
+    # operation_request '/GetDividendsForeignIssuer', body
+    raise NotImplementedError
+  end
+
+  # Метод получения списка операций по счёту.
+  # https://tinkoff.github.io/investAPI/operations/#getoperations
+  #
+  # @account_id: String
+  # @figi: String, пример: 'BBG000B9XRY4'
+  # @from: Time
+  # @to: Time
+  # @state (опиционально): InvestTinkoff::V2::OperationState
+  def operations account_id:, figi:, from:, to:, state: InvestTinkoff::V2::OperationState::UNSPECIFIED
+    body = {
+      accountId: account_id,
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT),
+      state: state || InvestTinkoff::V2::OperationState::UNSPECIFIED
+    }
+    operation_request '/GetOperations', body
+  end
+
+  # Метод получения портфеля по счёту.
+  # https://tinkoff.github.io/investAPI/operations/#getportfolio
+  #
+  # @account_id: String
+  def portfolio account_id:
+    operation_request '/GetPortfolio', { accountId: account_id }
+  end
+
+  # Метод получения списка позиций по счёту.
+  # https://tinkoff.github.io/investAPI/operations/#getpositions
+  #
+  # @account_id: String
+  def positions account_id:
+    operation_request '/GetPositions', { accountId: account_id }
+  end
+
+  # Метод получения доступного остатка для вывода средств.
+  # https://tinkoff.github.io/investAPI/operations/#getwithdrawlimits
+  def withdraw_limits account_id:
+    operation_request '/GetWithdrawLimits', { accountId: account_id }
+  end
+
+  # ==========================================
+  # OrdersService
+  # ==========================================
+
+  # Метод получения списка активных заявок по счёту.
+  #
+  # @account_id: String
+  def orders account_id:
+    order_request '/GetOrders', { accountId: account_id }
+  end
+
+  # Метод выставления заявки.
+  # https://tinkoff.github.io/investAPI/orders/#postorder
+  #
+  # @account_id: String
+  # @figi: String
+  # @quantity: Integer
+  # @price: Float
+  # @direction: InvestTinkoff::V2::OrderDirection
+  # @order_type: InvestTinkoff::V2::OrderType
+  # @order_id: String (max length 36)
+  def create_order( # rubocop: disable Metrics/ParameterLists
+    account_id:,
+    figi:,
+    quantity:,
+    price:,
+    direction:,
+    order_type:,
+    order_id:
+  )
+    body = {
+      accountId: account_id,
+      figi: figi,
+      quantity: quantity,
+      price: InvestTinkoff::V2::Quotation.create(price),
+      direction: direction,
+      orderType: order_type,
+      orderId: order_id
+    }
+    order_request '/PostOrder', body
+  end
+
+  # Метод получения статуса торгового поручения.
+  # https://tinkoff.github.io/investAPI/orders/#getorderstate
+  #
+  # @account_id: String
+  # @order_id: String
+  def order_state account_id:, order_id:
+    body = { accountId: account_id, orderId: order_id }
+    order_request '/GetOrderState', body
+  end
+
+  # Метод отмены биржевой заявки.
+  # https://tinkoff.github.io/investAPI/orders/#cancelorder
+  #
+  # @account_id: String
+  # @order_id: String
+  def cancel_order account_id:, order_id:
+    body = { accountId: account_id, orderId: order_id }
+    order_request '/CancelOrder', body
+  end
+
+  # ==========================================
+  # StopOrdersService
+  # ==========================================
+
+  # Метод получения списка активных стоп заявок по счёту.
+  # https://tinkoff.github.io/investAPI/stoporders/#getstoporders
+  def stop_orders account_id:
+    body = { accountId: account_id }
+    stop_order_request '/GetStopOrders', body
+  end
+
+  # Метод выставления стоп-заявки.
+  # https://tinkoff.github.io/investAPI/stoporders/#poststoporder
+  def create_stop_order account_id:, figi:, quantity:, price:, stop_price:, expiration_type: nil
+    # TODO: Еще остались не проброшенными некоторые аргументы.
+    # {
+    #   "figi": "string",
+    #   "quantity": "string",
+    #   "price": {
+    #     "nano": 6,
+    #     "units": "units"
+    #   },
+    #   "stopPrice": {
+    #     "nano": 6,
+    #     "units": "units"
+    #   },
+    #   "direction": "STOP_ORDER_DIRECTION_UNSPECIFIED",
+    #   "accountId": "string",
+    #   "expirationType": "STOP_ORDER_EXPIRATION_TYPE_UNSPECIFIED",
+    #   "stopOrderType": "STOP_ORDER_TYPE_UNSPECIFIED",
+    #   "expireDate": "2022-05-15T16:08:27.339Z"
+    # }
+    body = {
+      figi: figi,
+      quantity: quantity,
+      price: InvestTinkoff::V2::Quotation.create(price),
+      stopPrice: InvestTinkoff::V2::Quotation.create(stop_price),
+      # ...
+      accountId: account_id,
+      expirationType: expiration_type || StopOrderExpirationType::UNSPECIFIED
+      # ...
+    }
+    stop_order_request '/PostStopOrder', body
+  end
+
+  # Метод отмены стоп-заявки.
+  # https://tinkoff.github.io/investAPI/stoporders/#cancelstoporder
+  def cancel_stop_order account_id:, order_id:
+    body = { accountId: account_id, stopOrderId: order_id }
+    stop_order_request '/CancelStopOrder', body
+  end
+
+  # ==========================================
+  # UsersService
+  # ==========================================
+
+  # Метод получения счетов пользователя.
+  def accounts
+    user_service_request '/GetAccounts'
+  end
+
+  # Метод получения информации о пользователе.
+  def info
+    user_service_request '/GetInfo'
+  end
+
+  # Расчёт маржинальных показателей по счёту.
+  def margin_attributes account_id:
+    body = { accountId: account_id }
+    user_service_request '/GetMarginAttributes', body
+  end
+
+  # Текущий тариф пользователя (лимиты запросов к API).
+  def user_tariff
+    user_service_request '/GetUserTariff'
+  end
+
+  private
+
+  def parse_response response
+    InvestTinkoff::V2::Response.create response
+  end
+
+  def instrument_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.InstrumentsService#{path}",
+      body: body
+    )
+  end
+
+  def market_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.MarketDataService#{path}",
+      body: body
+    )
+  end
+
+  def operation_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.OperationsService#{path}",
+      body: body
+    )
+  end
+
+  def order_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.OrdersService#{path}",
+      body: body
+    )
+  end
+
+  def stop_order_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.StopOrdersService#{path}",
+      body: body
+    )
+  end
+
+  def user_service_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.UsersService#{path}",
+      body: body
+    )
+  end
+end

data/lib/invest_tinkoff/v2/edit_favorites_action_type.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Тип действия со списком избранных инструментов
+# https://tinkoff.github.io/investAPI/instruments/#editfavoritesactiontype
+class InvestTinkoff::V2::EditFavoritesActionType
+  # Тип не определён
+  UNSPECIFIED = 0
+
+  # Добавить в список
+  ADD = 1
+
+  # Удалить из списка
+  DEL = 2
+end

data/lib/invest_tinkoff/v2/instrument_id_type.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Тип идентификатора инструмента
+# https://tinkoff.github.io/investAPI/instruments/#instrumentidtype
+class InvestTinkoff::V2::InstrumentIdType
+  # Значение не определено
+  UNSPECIFIED = 0
+
+  # Figi
+  FIGI = 1
+
+  # Ticker
+  TICKER = 2
+
+  # Уникальный идентификатор
+  UID = 3
+end

data/lib/invest_tinkoff/v2/instrument_status.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# Статус запрашиваемых инструментов
+# https://tinkoff.github.io/investAPI/marketdata/#candleinterval
+class InvestTinkoff::V2::InstrumentStatus
+  # Значение не определено
+  UNSPECIFIED = 0
+
+  # Базовый список инструментов (по умолчанию).
+  # Инструменты доступные для торговли через TINKOFF INVEST API.
+  BASE = 1
+
+  # Список всех инструментов
+  ALL = 2
+end

data/lib/invest_tinkoff/v2/operation_state.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Статус запрашиваемых операций
+class InvestTinkoff::V2::OperationState
+  # Значение не указано
+  UNSPECIFIED = 0
+
+  # Исполнена
+  EXECUTED = 1
+
+  # Отменена
+  CANCELED = 2
+end

data/lib/invest_tinkoff/v2/order_direction.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Направление операции
+class InvestTinkoff::V2::OrderDirection
+  # Значение не указано
+  UNSPECIFIED = 0
+
+  # Покупка
+  BUY = 1
+
+  # Продажа
+  SELL = 2
+end

data/lib/invest_tinkoff/v2/order_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Тип заявки
+class InvestTinkoff::V2::OrderType
+  # Значение не указано
+  UNSPECIFIED = 0
+
+  # Лимитная
+  LIMIT = 1
+
+  # Рыночная
+  MARKET = 2
+end

data/lib/invest_tinkoff/v2/quotation.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+InvestTinkoff::V2::Quotation = Struct.new(
+  :units,
+  :nano
+)
+
+class InvestTinkoff::V2::Quotation
+  def self.create price
+    units = price.round
+    nano = ((price.to_d - units) * 1_000_000_000).to_i
+    new(
+      "#{price.positive? ? '' : '-'}#{units.abs}",
+      nano
+    )
+  end
+end

data/lib/invest_tinkoff/v2/response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+InvestTinkoff::V2::Response = Struct.new(
+  :payload,
+  :http_code
+)
+
+class InvestTinkoff::V2::Response
+  def self.create response
+    attributes = response.parsed_response || {}
+    new(
+      attributes,
+      response.code
+    )
+  end
+
+  def success?
+    http_code == 200
+  end
+end

data/lib/invest_tinkoff/v2/sandbox_client.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+class InvestTinkoff::V2::SandboxClient < InvestTinkoff::V2::Client
+  def initialize token:, logger: nil
+    super(
+      token: token,
+      logger: logger
+    )
+  end
+
+  # ==========================================
+  # SandboxService
+  # ==========================================
+
+  # Метод отмены торгового поручения в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#cancelsandboxorder
+  #
+  # @account_id: String
+  # @order_id: String
+  def cancel_sandbox_order account_id:, order_id:
+    body = { accountId: account_id, orderId: order_id }
+    sandbox_request '/CancelSandboxOrder', body
+  end
+
+  # Метод закрытия счёта в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#closesandboxaccount
+  #
+  # @account_id: String
+  def close_sandbox_account account_id:
+    sandbox_request '/CloseSandboxAccount', { accountId: account_id }
+  end
+
+  # Метод получения счетов в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#getsandboxaccounts
+  def sandbox_accounts
+    sandbox_request '/GetSandboxAccounts'
+  end
+
+  # Метод получения операций в песочнице по номеру счёта.
+  # https://tinkoff.github.io/investAPI/sandbox/#getsandboxoperations
+  #
+  # @account_id: String
+  # @figi: String, пример: 'BBG000B9XRY4'
+  # @from: Time
+  # @to: Time
+  # @state (опиционально): InvestTinkoff::V2::OperationState
+  def sandbox_operations account_id:, figi:, from:, to:, state: InvestTinkoff::V2::OperationState::UNSPECIFIED
+    body = {
+      accountId: account_id,
+      figi: figi,
+      from: from.strftime(TIME_FORMAT),
+      to: to.strftime(TIME_FORMAT),
+      state: state || InvestTinkoff::V2::OperationState::UNSPECIFIED
+    }
+    sandbox_request '/GetSandboxOperations', body
+  end
+
+  # Метод получения статуса заявки в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#getsandboxorderstate
+  #
+  # @account_id: String
+  # @order_id: String
+  def sandbox_order_state account_id:, order_id:
+    body = { accountId: account_id, orderId: order_id }
+    sandbox_request '/GetSandboxOrderState', body
+  end
+
+  # Метод получения списка активных заявок по счёту в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#getsandboxorders
+  #
+  # @account_id: String
+  def sandbox_orders account_id:
+    sandbox_request '/GetSandboxOrders', { accountId: account_id }
+  end
+
+  # Метод получения портфолио в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#getsandboxportfolio
+  #
+  # @account_id: String
+  def sandbox_portfolio account_id:
+    sandbox_request '/GetSandboxPortfolio', { accountId: account_id }
+  end
+
+  # Метод получения позиций по виртуальному счёту песочницы.
+  # https://tinkoff.github.io/investAPI/sandbox/#getsandboxpositions
+  #
+  # @account_id: String
+  def sandbox_positions account_id:
+    sandbox_request '/GetSandboxPositions', { accountId: account_id }
+  end
+
+  # Метод регистрации счёта в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#opensandboxaccount
+  def open_sandbox_account
+    sandbox_request '/OpenSandboxAccount'
+  end
+
+  # Метод выставления торгового поручения в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#postsandboxorder
+  #
+  # @account_id: String
+  # @figi: String
+  # @quantity: Integer
+  # @price: Float
+  # @direction: InvestTinkoff::V2::OrderDirection
+  # @order_type: InvestTinkoff::V2::OrderType
+  # @order_id: String (max length 36)
+  def create_sandbox_order( # rubocop: disable Metrics/ParameterLists
+    account_id:,
+    figi:,
+    quantity:,
+    price:,
+    direction:,
+    order_type:,
+    order_id:
+  )
+    body = {
+      accountId: account_id,
+      figi: figi,
+      quantity: quantity,
+      price: InvestTinkoff::V2::Quotation.create(price),
+      direction: direction,
+      orderType: order_type,
+      orderId: order_id
+    }
+    sandbox_request '/PostSandboxOrder', body
+  end
+
+  # Метод пополнения счёта в песочнице.
+  # https://tinkoff.github.io/investAPI/sandbox/#sandboxpayin
+  #
+  # @account_id: String
+  # @amount: Float
+  # @currency: String, пример 'RUB', 'USD', 'EUR' и т.д.
+  def sandbox_pay_in account_id:, amount:, currency:
+    body = {
+      accountId: account_id,
+      amount: InvestTinkoff::V2::Quotation.create(amount),
+      currency: currency
+    }
+    sandbox_request '/SandboxPayIn', body
+  end
+
+  private
+
+  def sandbox_request path, body = {}
+    post_api_request(
+      "/tinkoff.public.invest.api.contract.v1.SandboxService#{path}",
+      body: body
+    )
+  end
+end

data/lib/invest_tinkoff/v2/stop_order_expiration_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Тип экспирации стоп-заявки
+class InvestTinkoff::V2::StopOrderExpirationType
+  # Значение не указано
+  UNSPECIFIED = 0
+
+  # Действительно до отмены
+  GOOD_TILL_CANCEL = 1
+
+  # Действительно до даты снятия
+  GOOD_TILL_DATE = 2
+end

data/lib/invest_tinkoff/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module InvestTinkoff
-  VERSION = '0.9.2'
+  VERSION = '0.9.4'
 end

data/lib/invest_tinkoff.rb

@@ -13,3 +13,7 @@ require 'invest_tinkoff/client_base'
 require 'invest_tinkoff/v1/client'
 require 'invest_tinkoff/v1/response'
 require 'invest_tinkoff/v1/sandbox_client'
+
+require 'invest_tinkoff/v2/client'
+require 'invest_tinkoff/v2/response'
+require 'invest_tinkoff/v2/sandbox_client'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: invest_tinkoff
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.4
 platform: ruby
 authors:
 - Alexander Kalinichev
@@ -41,6 +41,18 @@ files:
 - lib/invest_tinkoff/v1/client.rb
 - lib/invest_tinkoff/v1/response.rb
 - lib/invest_tinkoff/v1/sandbox_client.rb
+- lib/invest_tinkoff/v2/candle_interval.rb
+- lib/invest_tinkoff/v2/client.rb
+- lib/invest_tinkoff/v2/edit_favorites_action_type.rb
+- lib/invest_tinkoff/v2/instrument_id_type.rb
+- lib/invest_tinkoff/v2/instrument_status.rb
+- lib/invest_tinkoff/v2/operation_state.rb
+- lib/invest_tinkoff/v2/order_direction.rb
+- lib/invest_tinkoff/v2/order_type.rb
+- lib/invest_tinkoff/v2/quotation.rb
+- lib/invest_tinkoff/v2/response.rb
+- lib/invest_tinkoff/v2/sandbox_client.rb
+- lib/invest_tinkoff/v2/stop_order_expiration_type.rb
 - lib/invest_tinkoff/version.rb
 homepage: https://github.com/blackchestnut/invest_tinkoff
 licenses: