/latoken-api-v2-dotnet-client

Primary LanguageC#

LATOKEN C# Client Library (Early Beta version)

LATOKEN C# Client Library aims to help developers to integrate with the LATOKEN trading API. The WebSocket connection is based on the STOMP protocol. More details can be found here.

Please note that the library in Early Beta, and LATOKEN doesn't take any responsibility for the damages occurred while using this code. If you think something is broken or missing, please create an issue.

Getting started

You can install this as a Nuget package: Latoken.Api.Client.Library 1.0.0

Alternatively, you can use the source code, but make sure you have installed these Nuget packages:

  • Microsoft.Extensions.Logging Version: 5.0.0
  • Newtonsoft.Json Version 12.0.3
  • Websocket.Client Version: 4.3.35

Important

Note that this library is not thread-safe. Don't attempt to send orders from multiple threads etc.

LARestClient class to interract with the REST API

Get a list of all account balances

    //Generate your public and private API keys on this page https://latoken.com/account/apikeys
    ClientCredentials credentials = new ClientCredentials
    {
        ApiKey = "Your Public API Key",
        ApiSecret = "Your Private API Key"
    };

    var latokenRestClient =
            new LARestClient(credentials, new HttpClient() { BaseAddress = new Uri("https://api.latoken.com") });

    

    List<Balance> balances = await latokenRestClient.GetBalances();

Placing a limit order

    //Generate your public and private API keys on this page https://latoken.com/account/apikeys
    ClientCredentials credentials = new ClientCredentials
    {
        ApiKey = "Your Public API Key",
        ApiSecret = "Your Private API Key"
    };

    var latokenRestClient =
            new LARestClient(credentials, new HttpClient() { BaseAddress = new Uri("https://api.latoken.com") });

   
    //Getting UUID strings representing IDs of the corresponding currencies/assets
    //You might want to cache this, since this is static data, and  you don't need to fetch it each time
    var freeCoin = (await latokenRestClient.GetCurrency("FREE")).Id;
    var usdtCoin = (await latokenRestClient.GetCurrency("USDT")).Id;

    //Consult https://api.latoken.com/doc/v2/#operation/placeOrder for possible field values
    //Also, follow price and qty format as described on this page, use comma only to separate the decimal part
    OrderCommand orderCommand = new OrderCommand
    {
        BaseCurrency = baseCurrency,
        QuoteCurrency = quoteCurrency,
        Side = "BUY",
        Condition = "GTC",
        Type = "LIMIT",                
        Quantity = "1.0",
        Price = "1.0",
        ClientOrderId = "C# Client Test",
        Timestamp = (long)(DateTime.UtcNow.Subtract(new DateTime(1970, 1, 1))).TotalSeconds

    };
    OrderResponse result = await latokenRestClient.PlaceOrder(orderCommand);

Supported REST endpoints (LARestClient class)

Information about our REST API specification LATOKEN API v2 docs.

Method Description LATOKEN APIv2 Link
GetPairs Request list of all active trading pairs getAvailablePairs
GetPair Get active trading pair Client library implementation
GetCurrencies Get a list of active currencies getMyOrdersByPair
GetCurrency Get a currency by id or tag getCurrencies
GetBalances Request all account balances for a current user getBalancesByUser
GetBalanceByType Request specific account by currency and type getBalancesByCurrency
GetAvailablePairs Request list of all available trading pairs getAvailablePairs
GetAvailablePair Get available trading pair Client library implementation
GetOrders Get a list of private orders getMyOrders
GetOrdersPair Get a list of private orders on a traded pair getMyOrdersByPair
GetOrder Get a private order by id getOrderById
GetAllTrades Get public trade history for a given pair getTradesByPair
GetClientTrades Get private trade history getTradesByTrader
GetClientTradesPair Request trade history of authorized user for given pair getTradesByAssetAndTrader
PlaceOrder Request trade history of authorized user for given pair getTradesByAssetAndTrader
CancelOrder Cancel order by id cancelOrder
CancelAllOrders Cancel all orders for a given pair cancelAllOrders
GetOrderBook Get order book snapshot for a given pair getOrderBook
GetTickers Request tickers for all pairs getAllTickers
GetTicker Request ticker for pair getTicker

LAWsClient class to interact with the WebSocket API

Get order book for FREE/USDT pair

        ClientCredentials restCredentials = new ClientCredentials
       {
           Alias = "TestCSharpClient",
           ApiKey = "Your Public API Key",
           ApiSecret = "Your Private API Key"                
       };
       var latokenRestClient =
                new LARestClient(restCredentials, new HttpClient() { BaseAddress = new Uri("https://api.latoken.com") });

            
       LatokenUser getUserResult = await latokenRestClient.GetUser();

       ClientCredentials wsCredentials = new ClientCredentials
       {
           Alias = "TestCSharpClient",
           ApiKey = "Your Public API Key",
           ApiSecret = "Your Private API Key",
           UserId = getUserResult.Id
       };

       var wsClient = new LAWsClient(wsCredentials, true);
       wsClient.OnOpened += WSClient_OnOpened;
       wsClient.OnClosed += WSClient_OnClosed;
       wsClient.OnError += WSClient_OnError;

            
       wsClient.Start();
       await Task.Delay(15000);


       //Getting UUID strings representing IDs of the corresponding currencies/assets
       //You might want to cache this, since this is static data, and  you don't need to fetch it each time
        var freeCoin = (await latokenRestClient.GetCurrency("FREE")).Id;
        var usdtCoin = (await latokenRestClient.GetCurrency("USDT")).Id;
                
       wsClient.SubscribeOrderBookEvents(freeCoin, usdtCoin,
       delegate (OrderBookChange orderBookChange, string baseId, string quoteId, DateTime dateTime) {
            Console.WriteLine("Order book change {0}", orderBookChange);
       });


        private void WSClient_OnOpened()
        {
           //TODO: your implementation here
        }


        private void WSClient_OnClosed(WebSocketCloseStatus? status, string description)
        {
            //TODO: your implementation here
        }

        private void WSClient_OnError(string header, string body)
        {
            //TODO: your implementation here
        }

Supported WebSockets endpoints (LAWsClient class)

Information about our WebSocket API specification LATOKEN API v2 docs.

Method Description LATOKEN APIv2 Link
SubscribeOrderBookEvents Subscribe for order book events for a pair Books
SubscribeOrderEvents Subscribe for private order events Orders
SubscribeMyTradeEvents Subscribe for private trade events Trades
SubscribeBalanceEvents Subscribe for balance on your accounts events Accounts