https://github.com/orodruinlabs/cryptoexchanges.net
A unified .NET 10 SDK for cryptocurrency exchanges — one typed interface across Binance, Bybit, OKX & Bitget, with a read-only MCP server for AI agents.
https://github.com/orodruinlabs/cryptoexchanges.net
ai-agents binance bitget bybit clean-architecture crypto-exchange cryptocurrency csharp dotnet dotnet-library mcp model-context-protocol nuget okx sdk trading
Last synced: 11 days ago
JSON representation
A unified .NET 10 SDK for cryptocurrency exchanges — one typed interface across Binance, Bybit, OKX & Bitget, with a read-only MCP server for AI agents.
- Host: GitHub
- URL: https://github.com/orodruinlabs/cryptoexchanges.net
- Owner: OrodruinLabs
- License: apache-2.0
- Created: 2017-12-08T21:34:02.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2026-06-20T01:28:31.000Z (13 days ago)
- Last Synced: 2026-06-20T02:12:03.348Z (13 days ago)
- Topics: ai-agents, binance, bitget, bybit, clean-architecture, crypto-exchange, cryptocurrency, csharp, dotnet, dotnet-library, mcp, model-context-protocol, nuget, okx, sdk, trading
- Language: C#
- Size: 2.08 MB
- Stars: 6
- Watchers: 5
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# CryptoExchanges.Net
> **A unified .NET SDK for cryptocurrency exchanges — one typed interface across every exchange, with a read-only MCP server for AI agents.**
[](https://www.nuget.org/packages/CryptoExchanges.Net)
[](LICENSE)
[](https://dotnet.microsoft.com/)
[](https://www.nuget.org/packages/CryptoExchanges.Net)
---
## Supported Exchanges
| Exchange | Status | Package |
|----------|--------|---------|
| 
Binance | ✅ Supported | [](https://www.nuget.org/packages/CryptoExchanges.Net.Binance) [](https://www.nuget.org/packages/CryptoExchanges.Net.Binance) |
| 
Bybit | ✅ Supported | [](https://www.nuget.org/packages/CryptoExchanges.Net.Bybit) [](https://www.nuget.org/packages/CryptoExchanges.Net.Bybit) |
| 
OKX | ✅ Supported | [](https://www.nuget.org/packages/CryptoExchanges.Net.Okx) [](https://www.nuget.org/packages/CryptoExchanges.Net.Okx) |
| 
Bitget | ✅ Supported | [](https://www.nuget.org/packages/CryptoExchanges.Net.Bitget) [](https://www.nuget.org/packages/CryptoExchanges.Net.Bitget) |
| 
Coinbase | 🕓 Coming soon | — |
| 
Kraken | 🕓 Coming soon | — |
| 
KuCoin | ✅ Supported | [](https://www.nuget.org/packages/CryptoExchanges.Net.Kucoin) [](https://www.nuget.org/packages/CryptoExchanges.Net.Kucoin) |
REST, spot market data and account — read and write.
Exchange names and logos are trademarks of their respective owners. CryptoExchanges.Net is an independent open-source project and is not affiliated with, endorsed by, or sponsored by any listed exchange.
---
## 60-Second Quick Start
### Library
```bash
dotnet add package CryptoExchanges.Net.Binance
```
```csharp
await using var exchange = BinanceExchangeClient.Create(new BinanceOptions
{
ApiKey = "your-api-key",
SecretKey = "your-secret-key",
});
var price = await exchange.MarketData.GetPriceAsync(new Symbol(Asset.Btc, Asset.Usdt));
Console.WriteLine($"BTC/USDT: ${price}");
```
### MCP Server (AI agents)
```bash
dotnet tool install -g CryptoExchanges.Net.Mcp
claude mcp add crypto -- crypto-mcp
```
Your MCP-capable agent can now query live prices, order books, candles, and account balances across all supported exchanges.
---
## MCP Server
`CryptoExchanges.Net.Mcp` is a **read-only** [Model Context Protocol](https://modelcontextprotocol.io) stdio server.
It exposes **12 tools** — six market-data tools (no credentials required) and six account tools (read-scoped API keys).
All supported exchanges share the same tool vocabulary; no agent-side changes needed when switching exchanges.
- [MCP server reference](docs/mcp-server.md) — tools, environment variables, error handling
- [MCP client setup guides](docs/mcp-clients.md) — Claude Desktop, Claude Code, Cursor, Windsurf, and more
---
## Documentation
| Doc | Description |
|-----|-------------|
| [Getting started](docs/getting-started.md) | Install, credentials, first call |
| [Library usage](docs/library-usage.md) | Full API reference with examples |
| [Streaming](docs/streaming.md) | WebSocket market-data streams, `IStreamClient`, auto-reconnect |
| [Architecture](docs/architecture.md) | Project structure, layers, design principles |
| [Exchanges](docs/exchanges.md) | Per-exchange notes, credentials, supported operations |
| [MCP server](docs/mcp-server.md) | MCP tool reference, env vars, error categories |
| [MCP client setup](docs/mcp-clients.md) | Per-client config (Claude, Cursor, Windsurf, VS Code…) |
---
## Building
```bash
dotnet build
dotnet test
```
Requires .NET 10.0 SDK.
---
## License
Apache-2.0 — see [LICENSE](LICENSE).
---
Built by [Orodruin Labs](https://github.com/OrodruinLabs).