Implement API abstraction layer to make bot independent of Tinkoff API

This implementation introduces a comprehensive abstraction layer that decouples
the trading bot from the Tinkoff API, addressing the issue of API instability.

Key Changes:
- Created ITradingApiProvider interface to abstract all trading operations
- Implemented TinkoffApiProvider as a wrapper around Tinkoff InvestApi
- Added MockApiProvider for testing without real API calls
- Introduced configuration-based provider selection
- Created interfaces for all trading data structures (IAccount, IInstrument, IOrder, etc.)
- Used custom enums to avoid namespace conflicts with provider APIs
- Refactored TradingService to use the abstraction layer

Benefits:
- Reduced dependency risk - no longer tied to single API provider
- Easy testing with mock provider
- Provider flexibility via configuration
- Future-proof architecture for adding new trading APIs
- API instability isolation to specific provider implementations

Files added:
- Interfaces/ - Complete abstraction layer interfaces
- Providers/TinkoffApiProvider.cs - Tinkoff implementation
- Providers/Tinkoff/ - Tinkoff-specific wrapper classes
- Providers/MockApiProvider.cs - Mock implementation for testing
- AbstractTradingService.cs - Refactored service using abstraction
- Configuration files and examples

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: konard

csharp/TraderBot/AbstractTradingService.cs

@@ -0,0 +1,12 @@
+namespace TraderBot;
+
+public class ApiProviderSettings
+{
+    public string Provider { get; set; } = "Tinkoff";
+}
+
+public class InvestApiSettings
+{
+    public string? AccessToken { get; set; }
+    public string? AppName { get; set; }
+}

csharp/TraderBot/ApiProviderSettings.cs

@@ -0,0 +1,8 @@
+namespace TraderBot.Interfaces;
+
+public interface IAccount
+{
+    string Id { get; }
+    string Name { get; }
+    DateTime OpenedDate { get; }
+}

csharp/TraderBot/Interfaces/IAccount.cs

@@ -0,0 +1,16 @@
+namespace TraderBot.Interfaces;
+
+public interface IInstrument
+{
+    string Figi { get; }
+    string Ticker { get; }
+    int Lot { get; }
+    decimal MinPriceIncrement { get; }
+    TradingInstrumentType InstrumentType { get; }
+}
+
+public enum TradingInstrumentType
+{
+    Etf,
+    Shares
+}

csharp/TraderBot/Interfaces/IInstrument.cs

@@ -0,0 +1,19 @@
+namespace TraderBot.Interfaces;
+
+public interface IOperation
+{
+    string Id { get; }
+    TradingOperationType OperationType { get; }
+    DateTime Date { get; }
+    long Quantity { get; }
+    decimal Price { get; }
+    long QuantityRest { get; }
+    IEnumerable<ITrade>? Trades { get; }
+    long GetActualQuantity();
+}
+
+public enum TradingOperationType
+{
+    Buy,
+    Sell
+}

csharp/TraderBot/Interfaces/IOperation.cs

@@ -0,0 +1,48 @@
+namespace TraderBot.Interfaces;
+
+public interface IOrder
+{
+    string OrderId { get; }
+    string Figi { get; }
+    TradingOrderDirection Direction { get; }
+    long LotsRequested { get; set; }
+    decimal InitialSecurityPrice { get; }
+    decimal InitialOrderPrice { get; }
+}
+
+public interface IOrderRequest
+{
+    string OrderId { get; }
+    string AccountId { get; }
+    TradingOrderDirection Direction { get; }
+    TradingOrderType OrderType { get; }
+    string Figi { get; }
+    long Quantity { get; }
+    decimal Price { get; }
+}
+
+public interface IOrderResponse
+{
+    string OrderId { get; }
+    string Figi { get; }
+    TradingOrderDirection Direction { get; }
+    long LotsRequested { get; }
+    decimal InitialSecurityPrice { get; }
+}
+
+public interface ICancelOrderResponse
+{
+    string OrderId { get; }
+}
+
+public enum TradingOrderDirection
+{
+    Buy,
+    Sell
+}
+
+public enum TradingOrderType
+{
+    Limit,
+    Market
+}

csharp/TraderBot/Interfaces/IOrder.cs

@@ -0,0 +1,18 @@
+namespace TraderBot.Interfaces;
+
+public interface IOrderBookStream : IAsyncEnumerable<IOrderBook>
+{
+}
+
+public interface IOrderBook
+{
+    string Figi { get; }
+    IEnumerable<IOrderBookEntry> Bids { get; }
+    IEnumerable<IOrderBookEntry> Asks { get; }
+}
+
+public interface IOrderBookEntry
+{
+    decimal Price { get; }
+    long Quantity { get; }
+}

csharp/TraderBot/Interfaces/IOrderBook.cs

@@ -0,0 +1,26 @@
+namespace TraderBot.Interfaces;
+
+public interface IPosition
+{
+    string Figi { get; }
+    decimal Balance { get; }
+}
+
+public interface IPortfolio
+{
+    IEnumerable<IPortfolioPosition> Positions { get; }
+    IEnumerable<IMoneyValue> Money { get; }
+    IEnumerable<IMoneyValue> Blocked { get; }
+}
+
+public interface IPortfolioPosition
+{
+    string Figi { get; }
+    decimal Quantity { get; }
+}
+
+public interface IMoneyValue
+{
+    string Currency { get; }
+    decimal Value { get; }
+}

csharp/TraderBot/Interfaces/IPosition.cs

@@ -0,0 +1,31 @@
+namespace TraderBot.Interfaces;
+
+public interface ITradesStream : IAsyncEnumerable<ITradeData>
+{
+}
+
+public interface ITradeData
+{
+    TradeDataType DataType { get; }
+    IOrderTrades? OrderTrades { get; }
+}
+
+public interface IOrderTrades
+{
+    string OrderId { get; }
+    TradingOrderDirection Direction { get; }
+    IEnumerable<ITrade> Trades { get; }
+}
+
+public interface ITrade
+{
+    long Quantity { get; }
+    decimal Price { get; }
+    DateTime DateTime { get; }
+}
+
+public enum TradeDataType
+{
+    OrderTrades,
+    Ping
+}

csharp/TraderBot/Interfaces/ITrades.cs

@@ -0,0 +1,16 @@
+namespace TraderBot.Interfaces;
+
+public interface ITradingApiProvider
+{
+    Task InitializeAsync();
+    Task<IEnumerable<IAccount>> GetAccountsAsync();
+    Task<IInstrument> GetInstrumentAsync(string ticker, TradingInstrumentType instrumentType);
+    Task<IOrderBookStream> SubscribeToOrderBookAsync(string figi, int depth);
+    Task<ITradesStream> SubscribeToTradesAsync(string accountId);
+    Task<IEnumerable<IOrder>> GetOrdersAsync(string accountId);
+    Task<IEnumerable<IPosition>> GetPositionsAsync(string accountId);
+    Task<IPortfolio> GetPortfolioAsync(string accountId);
+    Task<IEnumerable<IOperation>> GetOperationsAsync(string accountId, string figi, DateTime from, DateTime to);
+    Task<IOrderResponse> PlaceOrderAsync(IOrderRequest orderRequest);
+    Task<ICancelOrderResponse> CancelOrderAsync(string accountId, string orderId);
+}