DigitalRuby.ExchangeSharp
1.1.1
dotnet add package DigitalRuby.ExchangeSharp --version 1.1.1
NuGet\Install-Package DigitalRuby.ExchangeSharp -Version 1.1.1
<PackageReference Include="DigitalRuby.ExchangeSharp" Version="1.1.1" />
paket add DigitalRuby.ExchangeSharp --version 1.1.1
#r "nuget: DigitalRuby.ExchangeSharp, 1.1.1"
// Install DigitalRuby.ExchangeSharp as a Cake Addin #addin nuget:?package=DigitalRuby.ExchangeSharp&version=1.1.1 // Install DigitalRuby.ExchangeSharp as a Cake Tool #tool nuget:?package=DigitalRuby.ExchangeSharp&version=1.1.1
<img src='logo.png' width='600' alt="Project's logo" />
Overview
ExchangeSharp is a C# framework/lib and console app for trading and communicating with various exchange API end points for cryptocurrency assets. Many exchanges are supported, along with web sockets, withdraws and more!
Feel free to visit the discord channel at https://discord.gg/58ktxXuTVK and chat with other developers.
Features
- Many exchanges supported with public, private and web socket API
- Easy to use code and API
- Optional global market symbol normalization, since each exchange has their own way of doing market symbols
- Runs anywhere .NET runs. (Windows, Mac, Linux, Containers, Serverless, iOS, Android, etc.)
- Can be used from many different C# platforms
- Has a great CLI that enables you to use all features from all exchanges right from your command line.
Exchanges
The following cryptocurrency exchanges are supported:
(Web socket key: T = tickers, R = trades, B = orderbook / delta orderbook, O = private orders, U = user data)
Exchange Name | Public REST | Private REST | Web Socket | Notes |
---|---|---|---|---|
ApolloX | x | x | T R B O U | |
Aquanow | wip | x | ||
Binance | x | x | T R B O U | |
Ceased operations | ||||
Binance.US | x | x | T R B O U | |
Binance DEX | R | |||
Bitbank | x | x | ||
Bitfinex | x | x | T R O | |
Bitflyer | R | |||
Bithumb | x | R | ||
BitMEX | x | x | R O | |
Bitstamp | x | x | R | |
Bittrex | x | x | T R | |
BL3P | x | x | R B | Trades stream does not send trade's ids. |
Bleutrade | x | x | ||
BtcTurk | R | |||
BTSE | x | x | ||
Bybit | x | x | R | Has public method for Websocket Positions |
Coinbase (Advanced) | x | x | T R O U | |
Coincheck | R | |||
Coinmate | x | x | ||
Crypto.com | R | |||
Digifinex | x | x | R B | |
Dydx | R | |||
FTX | x | x | T R | |
FTX.us | x | x | T R | |
gate.io | x | x | R | |
Gemini | x | x | T R B | |
HitBTC | x | x | R | |
Huobi | x | x | R B | |
Kraken | x | x | R | Dark order symbols not supported |
KuCoin | x | x | T R | |
LBank | x | x | R | |
Livecoin | x | x | ||
NDAX | x | x | T R | |
OKCoin | x | x | R B | |
OKEx | x | x | T R B O | |
Poloniex | x | x | T R B | |
UPbit | R | |||
YoBit | x | x | ||
ZB.com | wip | R |
The following cryptocurrency services are supported:
- Cryptowatch (partial)
Exchange constructors are private, to get access to an exchange in code use:
ExchangeAPI.GetExchangeAPIAsync<>()
.
Installing the CLI
On *nix systems:
- Run this command
curl https://github.com/DigitalRuby/ExchangeSharp/raw/main/install-console.sh | sh
On Windows (or manually):
- Download the latest binaries for your OS.
- Unzip it into a folder that is in your environment variable
PATH
(ctrl
+shift
+pause|break
→ Environment Variables) - Use it from your preferred command-line emulator (e.g. Powershell, cmd, etc.)
exchange-sharp --help
shows all available commands
Notes
ExchangeSharp uses marketSymbol
to refer to markets, or pairs of currencies.
Please send pull requests if you have made a change that you feel is worthwhile, want a bug fixed or want a new feature. You can also donate to get new features.
Building/Compiling
Websockets
If you must use an older Windows (older than win8.1), you'll need to use the Websocket4Net nuget package, and override the web socket implementation by calling
ExchangeSharp.ClientWebSocket.RegisterWebSocketCreator(
() => new ExchangeSharpConsole.WebSocket4NetClientWebSocket()
);
See WebSocket4NetClientWebSocket.cs
for implementation details.
Nuget
dotnet CLI
dotnet add package DigitalRuby.ExchangeSharp --version 1.1.1
Package Manager on VS
PM> Install-Package DigitalRuby.ExchangeSharp -Version 1.1.1
Examples
Creating an order
There's a lot of examples on how to use the API in our console application.
e.g.
ExampleOption.cs
Getting ticker info via Web Sockets
public static async Task Main(string[] args)
{
// create a web socket connection to Binance. Note you can Dispose the socket anytime to shut it down.
using var api = await ExchangeAPI.GetExchangeAPIAsync<ExchangeBinanceAPI>();
// the web socket will handle disconnects and attempt to re-connect automatically.
using var socket = await api.GetTickersWebSocket(tickers =>
{
Console.WriteLine("{0} tickers, first: {1}", tickers.Count, tickers.First());
});
Console.WriteLine("Press ENTER to shutdown.");
Console.ReadLine(true);
}
Authentication
Private api calls like placing orders require you to call LoadApiKeys
first. You can generate an api keys file by running the bundled console application and choosing the generate key file option.
Logging
ExchangeSharp uses NLog internally currently. To log, use ExchangeSharp.Logger
.
Do not use Console.WriteLine
to log messages in the lib project.
Provide your own nlog.config
or app.config
nlog configuration if you want to change logging settings or turn logging off.
Caching
The ExchageAPI
class provides a method caching mechanism. Use MethodCachePolicy
to put caching behind public methods, or clear to remove caching. Some methods are cached by default. You can set ExchangeAPI.UseDefaultMethodCachePolicy
to false
to stop all caching as well.
You can also set request cache policy if you want to tweak how the http caching behaves.
How to contribute
Please read the contributing guideline before submitting a pull request.
Consulting
I'm happy to make customizations to the software for you and keep in private repo, email exchangesharp@digitalruby.com.
Donations Gratefully Accepted
Believe it or not, donations are quite rare. I've posted publicly the total donation amounts below. If ExchangeSharp has helped you in any way, please consider donating.
Donation totals: 0.039 BTC, 10.25 LTC
Thanks for visiting!
Jeff Johnson
jeff@digitalruby.com
http://www.digitalruby.com
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.AspNet.SignalR.Client (>= 2.4.3)
- Newtonsoft.Json (>= 13.0.3)
- NLog (>= 5.2.8)
- SocketIOClient (>= 3.1.1)
- System.Configuration.ConfigurationManager (>= 8.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (3)
Showing the top 3 popular GitHub repositories that depend on DigitalRuby.ExchangeSharp:
Repository | Stars |
---|---|
btcpayserver/btcpayserver
Accept Bitcoin payments. Free, open-source & self-hosted, Bitcoin payment processor.
|
|
silahian/VisualHFT
VisualHFT is a cutting-edge GUI platform for market analysis, focusing on real-time visualization of market microstructure. Built with WPF & C#, it displays key metrics like Limit Order Book dynamics and execution quality. Its modular design ensures adaptability for developers and traders, enabling tailored analytical solutions.
|
|
sthewissen/Mynt
An Azure Functions-based crypto currency trading bot; featuring 10 exchanges, 25 indicators, custom strategy support, backtester and more
|
Version | Downloads | Last updated |
---|---|---|
1.1.1 | 362 | 6/12/2024 |
1.1.0 | 5,761 | 1/13/2024 |
1.0.4 | 15,623 | 4/14/2023 |
1.0.3 | 4,463 | 10/6/2022 |
1.0.2 | 25,321 | 5/2/2022 |
1.0.1 | 7,401 | 4/9/2022 |
1.0.0 | 1,160 | 3/20/2022 |
0.9.2 | 2,204 | 1/6/2022 |
0.9.1 | 1,894 | 11/9/2021 |
0.9.0 | 1,207 | 10/1/2021 |
0.8.2 | 1,454 | 8/27/2021 |
0.8.1 | 1,327 | 6/24/2021 |
0.8.0 | 2,005 | 5/14/2021 |
0.7.5 | 1,930 | 3/20/2021 |
0.7.4 | 4,436 | 12/4/2020 |
0.7.3 | 1,951 | 6/16/2020 |
0.7.2 | 5,603 | 4/15/2020 |
0.7.1 | 2,837 | 3/18/2020 |
0.7.0 | 1,617 | 2/12/2020 |
0.6.4 | 1,943 | 1/8/2020 |
0.6.3 | 42,128 | 11/10/2019 |
0.6.2 | 16,850 | 10/4/2019 |
0.6.1 | 1,300 | 9/20/2019 |
0.6.0.3 | 1,603 | 8/28/2019 |
0.6.0.2 | 1,333 | 8/20/2019 |
0.6.0.1 | 3,474 | 5/10/2019 |