اتصال به API بایننس با سی شارپ؛ از صفر تا اجرا

اگر یه توسعه‌دهنده‌ی ایرانی هستی که روی پروژه‌های مرتبط با ارز دیجیتال کار می‌کنی، احتمالاً بارها با این سوال روبرو شدی: «چطور می‌تونم از سی شارپ به API بایننس وصل بشم؟»

تو این مقاله، قدم به قدم باهات می‌ریم سراغ این موضوع. از ساختن API Key گرفته تا نوشتن کد واقعی برای دریافت قیمت لحظه‌ای، موجودی حساب و ثبت سفارش. پس اگه آماده‌ای، بریم!

API بایننس چیست و چرا باید از آن استفاده کنیم؟

API بایننس (Binance API) یک رابط برنامه‌نویسی است که صرافی بایننس در اختیار توسعه‌دهندگان قرار می‌دهد. با این API می‌توانی:

• قیمت لحظه‌ای تمام ارزهای دیجیتال را دریافت کنی
• تاریخچه معاملات و کندل‌های قیمتی را بخوانی
• به‌صورت خودکار سفارش خرید و فروش ثبت کنی
• موجودی حساب و سفارش‌های باز را مدیریت کنی
• ربات معاملاتی (Trading Bot) بسازی

بایننس دو نوع API اصلی دارد: REST API که برای درخواست‌های معمولی استفاده می‌شود و WebSocket API که برای دریافت داده‌های لحظه‌ای و استریم قیمت کاربرد دارد. در این آموزش هر دو را بررسی می‌کنیم.

پیش‌نیازهای اتصال به API بایننس

قبل از شروع کدنویسی، به چند چیز نیاز داری:

• حساب کاربری بایننس: اگه نداری باید بسازی (یا از Binance Testnet استفاده کنی)
• API Key و Secret Key: از پنل بایننس باید تولید کنی
• ویژوال استودیو نسخه ۲۰۱۹ یا بالاتر (یا VS Code)
• .NET 6 یا بالاتر روی سیستمت نصب باشه
• آشنایی پایه با زبان برنامه‌نویسی سی شارپ

ساخت API Key در بایننس

برای ساخت API Key مراحل زیر را دنبال کن:

1. وارد حساب بایننس خود شو
2. به بخش Account Settings برو
3. گزینه API Management را انتخاب کن
4. روی Create API کلیک کن
5. API Key و Secret Key تولیدشده را در جای امنی ذخیره کن

⚠️ هشدار مهم: Secret Key را فقط یک بار می‌توانی ببینی. اگر آن را ذخیره نکنی، باید API جدید بسازی. همچنین هیچ‌وقت این کلیدها را در کد یا گیت‌هاب قرار نده!

نصب کتابخانه‌های مورد نیاز

برای کار با API بایننس در سی شارپ، بهترین کتابخانه‌ای که وجود داره Binance.Net هست. این کتابخانه یک Wrapper قدرتمند برای API بایننس است که کار رو خیلی ساده‌تر می‌کنه.

در Package Manager Console ویژوال استودیو تایپ کن:

Install-Package Binance.Net

Install-Package CryptoExchange.Net

یا با dotnet CLI:

dotnet add package Binance.Net

dotnet add package CryptoExchange.Net

اتصال اولیه و دریافت قیمت لحظه‌ای

بریم سراغ اولین کد! این ساده‌ترین مثال برای دریافت قیمت لحظه‌ای بیت‌کوین به دلار است:

using Binance.Net.Clients;

using CryptoExchange.Net.Authentication;

class Program

{

static async Task Main(string[] args)

{

// ساخت کلاینت بایننس

var client = new BinanceRestClient();

// دریافت قیمت لحظه‌ای بیت‌کوین

var result = await client.SpotApi.ExchangeData

.GetPriceAsync(“BTCUSDT”);

if (result.Success)

{

Console.WriteLine($“قیمت بیت‌کوین: {result.Data.Price} USDT”);

}

else

{

Console.WriteLine($“خطا: {result.Error?.Message}”);

}

}

}

اگه کد بالا رو اجرا کنی، قیمت لحظه‌ای BTC/USDT رو توی کنسول می‌بینی. این اولین قدم موفقیت‌آمیز توئه!

احراز هویت با API Key برای دسترسی به حساب

برای دسترسی به اطلاعات حساب کاربری مثل موجودی یا ثبت سفارش، باید API Key خودت رو تنظیم کنی. این کار رو می‌توانی با Dependency Injection یا به‌صورت مستقیم انجام بدی:

using Binance.Net.Clients;

using CryptoExchange.Net.Authentication;

class Program

{

static async Task Main(string[] args)

{

// تنظیم API Key - هیچ‌وقت در کد هاردکد نکن!

// از appsettings.json یا Environment Variables استفاده کن

string apiKey = “YOUR_API_KEY_HERE”;

string secretKey = “YOUR_SECRET_KEY_HERE”;

var client = new BinanceRestClient(options =>

{

options.ApiCredentials = new ApiCredentials(apiKey, secretKey);

});

// دریافت موجودی حساب

var accountInfo = await client.SpotApi.Account

.GetAccountInfoAsync();

if (accountInfo.Success)

{

Console.WriteLine(“=== موجودی حساب ===”);

foreach (var balance in accountInfo.Data.Balances)

{

if (balance.Available > 0)

{

Console.WriteLine($"{balance.Asset}: " +

$"موجود = {balance.Available}, " +

$“قفل‌شده = {balance.Locked}”);

}

}

}

else

{

Console.WriteLine($“خطا: {accountInfo.Error?.Message}”);

}

}

}

ذخیره امن API Key با appsettings.json

هیچ‌وقت API Key رو مستقیم توی کد ننویس! از appsettings.json استفاده کن:

// appsettings.json

{

“BinanceSettings”: {

“ApiKey”: “your_api_key”,

“SecretKey”: “your_secret_key”

}

}

// Program.cs

using Microsoft.Extensions.Configuration;

var config = new ConfigurationBuilder()

.AddJsonFile(“appsettings.json”)

.Build();

string apiKey = config[“BinanceSettings:ApiKey”]!;

string secretKey = config[“BinanceSettings:SecretKey”]!;

دریافت تاریخچه قیمت و کندل‌های شمعی

یکی از پرکاربردترین عملیات‌ها در تحلیل تکنیکال، دریافت کندل‌های قیمتی (Candlestick) است. با کد زیر می‌تونی این داده‌ها رو بگیری:

using Binance.Net.Enums;

// دریافت کندل‌های ۱ ساعته بیت‌کوین (۱۰۰ کندل آخر)

var klines = await client.SpotApi.ExchangeData

.GetKlinesAsync(

“BTCUSDT”,

KlineInterval.OneHour,

limit: 100

);

if (klines.Success)

{

Console.WriteLine(“=== کندل‌های قیمتی BTC/USDT ===”);

foreach (var kline in klines.Data)

{

Console.WriteLine(

$"زمان: {kline.OpenTime:yyyy-MM-dd HH:mm} | " +

$"باز: {kline.OpenPrice} | " +

$"بالا: {kline.HighPrice} | " +

$"پایین: {kline.LowPrice} | " +

$"بسته: {kline.ClosePrice} | " +

$“حجم: {kline.Volume}”

);

}

}

ثبت سفارش خرید و فروش

حالا می‌ریم سراغ بخش هیجان‌انگیزتر: ثبت سفارش واقعی. بایننس چند نوع سفارش دارد که مهم‌ترین آن‌ها عبارتند از:

• Market Order: خرید یا فروش فوری با قیمت بازار
• Limit Order: ثبت سفارش در قیمت مشخص
• Stop-Limit Order: ترکیب استاپ و لیمیت برای مدیریت ریسک

using Binance.Net.Enums;

// ⚠️ این کد سفارش واقعی ثبت می‌کند - با احتیاط استفاده کنید!

// ثبت سفارش خرید Limit

var orderResult = await client.SpotApi.Trading

.PlaceOrderAsync(

symbol: “BTCUSDT”,

side: OrderSide.Buy,

type: SpotOrderType.Limit,

quantity: 0.001m, // مقدار

price: 40000m, // قیمت هدف

timeInForce: TimeInForce.GoodTillCanceled

);

if (orderResult.Success)

{

Console.WriteLine($“سفارش ثبت شد!”);

Console.WriteLine($“شناسه سفارش: {orderResult.Data.Id}”);

Console.WriteLine($“وضعیت: {orderResult.Data.Status}”);

}

else

{

Console.WriteLine($“خطا در ثبت سفارش: {orderResult.Error?.Message}”);

}

// لغو سفارش

var cancelResult = await client.SpotApi.Trading

.CancelOrderAsync(“BTCUSDT”, orderResult.Data.Id);

if (cancelResult.Success)

Console.WriteLine(“سفارش با موفقیت لغو شد.”);

استفاده از WebSocket برای دریافت داده‌های لحظه‌ای

اگه نیاز داری قیمت‌ها رو به‌صورت لحظه‌ای و پیوسته دریافت کنی (مثلاً برای ساخت داشبورد لایو)، باید از WebSocket استفاده کنی:

using Binance.Net.Clients;

var socketClient = new BinanceSocketClient();

// سابسکرایب به استریم قیمت لحظه‌ای BTC

var subscription = await socketClient.SpotApi

.SubscribeToTickerUpdatesAsync(

“BTCUSDT”,

data =>

{

Console.WriteLine(

$"[{DateTime.Now:HH:mm:ss}] " +

$"BTC/USDT = {data.Data.LastPrice:N2} | " +

$“تغییر: {data.Data.PriceChangePercent:N2}%”

);

}

);

if (subscription.Success)

{

Console.WriteLine(“اتصال WebSocket برقرار شد. Ctrl+C برای خروج…”);

Console.ReadLine();

}

// قطع اتصال

await socketClient.UnsubscribeAllAsync();

استریم همزمان چند جفت‌ارز

// دریافت قیمت چندین ارز به‌صورت همزمان

var symbols = new[] { “BTCUSDT”, “ETHUSDT”, “BNBUSDT” };

var multiSub = await socketClient.SpotApi

.SubscribeToTickerUpdatesAsync(

symbols,

data =>

{

Console.WriteLine(

$“{data.Data.Symbol}: {data.Data.LastPrice:N2}”

);

}

);

مدیریت خطاها و Retry Logic

در یک پروژه واقعی، مدیریت خطا خیلی مهمه. بایننس محدودیت‌های نرخ (Rate Limit) داره و گاهی اتصال قطع می‌شه. یه کلاس کمکی برای این کار:

public class BinanceService

{

private readonly BinanceRestClient _client;

private readonly ILogger _logger;

public BinanceService(string apiKey, string secretKey,

ILogger logger)

{

_logger = logger;

_client = new BinanceRestClient(options =>

{

options.ApiCredentials =

new ApiCredentials(apiKey, secretKey);

// تنظیم Timeout

options.RequestTimeout = TimeSpan.FromSeconds(30);

});

}

public async Task GetPriceWithRetryAsync(

string symbol, int maxRetries = 3)

{

for (int attempt = 1; attempt <= maxRetries; attempt++)

{

try

{

var result = await _client.SpotApi

.ExchangeData.GetPriceAsync(symbol);

if (result.Success)

return result.Data.Price;

_logger.LogWarning(

$"تلاش {attempt}/{maxRetries} ناموفق: " +

$“{result.Error?.Message}”);

// اگه Rate Limit بود کمی صبر کن

if (result.Error?.Code == 429)

await Task.Delay(TimeSpan.FromSeconds(60));

else

await Task.Delay(TimeSpan.FromSeconds(attempt * 2));

}

catch (Exception ex)

{

_logger.LogError(

$“خطای استثنا در تلاش {attempt}: {ex.Message}”);

await Task.Delay(TimeSpan.FromSeconds(attempt * 2));

}

}

return null;

}

}

استفاده از Binance Testnet برای تست بدون ریسک

قبل از اینکه با پول واقعی کار کنی، حتماً روی Testnet بایننس تست کن. Testnet یه محیط شبیه‌سازی‌شده‌ست که پول مجازی بهت می‌ده:

// اتصال به Testnet به‌جای بازار واقعی

var testnetClient = new BinanceRestClient(options =>

{

options.ApiCredentials =

new ApiCredentials(testnetApiKey, testnetSecretKey);

// این خط مهم است - تنظیم محیط Testnet

options.Environment = BinanceEnvironment.Testnet;

});

Console.WriteLine(“متصل به Testnet - پول واقعی در خطر نیست!”);

برای دریافت API Key مربوط به Testnet، به آدرس testnet.binance.vision برو و یه حساب جداگانه بساز.

ساخت یک ربات ساده معاملاتی با سی شارپ

حالا بریم همه چیزی که یاد گرفتیم رو ترکیب کنیم و یه ربات ساده بسازیم که اگر قیمت از یه حد مشخص پایین‌تر رفت، خرید کنه:

public class SimpleTradingBot

{

private readonly BinanceRestClient _client;

private readonly decimal _buyThreshold;

private readonly string _symbol;

public SimpleTradingBot(BinanceRestClient client,

string symbol, decimal buyThreshold)

{

_client = client;

_symbol = symbol;

_buyThreshold = buyThreshold;

}

public async Task RunAsync(CancellationToken ct)

{

Console.WriteLine($“ربات برای {_symbol} شروع به کار کرد.”);

Console.WriteLine($“حد خرید: {_buyThreshold:N2} USDT”);

while (!ct.IsCancellationRequested)

{

var price = await _client.SpotApi.ExchangeData

.GetPriceAsync(_symbol);

if (!price.Success)

{

await Task.Delay(5000, ct);

continue;

}

decimal currentPrice = price.Data.Price;

Console.WriteLine($"[{DateTime.Now:HH:mm:ss}] " +

$“قیمت: {currentPrice:N2}”);

// منطق خرید

if (currentPrice <= _buyThreshold)

{

Console.WriteLine($"🟢 سیگنال خرید! " +

$“قیمت {currentPrice} به حد {_buyThreshold} رسید.”);

// اینجا می‌تونی سفارش ثبت کنی

// await PlaceMarketBuyOrder(_symbol, 0.001m);

}

// بررسی هر ۱۰ ثانیه یک بار

await Task.Delay(10000, ct);

}

}

}

// استفاده از ربات

var cts = new CancellationTokenSource();

var bot = new SimpleTradingBot(client, “BTCUSDT”, 40000m);

await bot.RunAsync(cts.Token);

نکات مهم امنیتی که باید رعایت کنی

• هیچ‌وقت API Key را در GitHub، Gitlab یا کد commit‌شده قرار نده. از فایل .gitignore استفاده کن.
• محدودیت IP را فعال کن: در تنظیمات API بایننس، فقط IP سرور خودت را مجاز کن.
• فقط دسترسی‌های لازم را فعال کن: اگه فقط می‌خونی، گزینه Withdraw را غیرفعال بذار.
• از Environment Variables استفاده کن: در سرور از متغیرهای محیطی به‌جای فایل کانفیگ استفاده کن.
• Rate Limit را رعایت کن: بایننس محدودیت ۱۲۰۰ درخواست در دقیقه دارد.

خلاصه و جمع‌بندی

در این مقاله جامع یاد گرفتیم:

• ✅ نحوه ساخت و تنظیم API Key بایننس
• ✅ نصب و پیکربندی کتابخانه Binance.Net
• ✅ دریافت قیمت لحظه‌ای و تاریخچه کندل‌ها
• ✅ دسترسی به موجودی حساب
• ✅ ثبت و لغو سفارش خرید و فروش
• ✅ استفاده از WebSocket برای داده‌های استریم
• ✅ مدیریت خطا و Retry Logic حرفه‌ای
• ✅ ساخت یک ربات معاملاتی ساده
• ✅ نکات امنیتی ضروری

اتصال به API بایننس با سی شارپ دریچه‌ای به دنیای خودکارسازی معاملات باز می‌کنه. با تسلط بر این مهارت می‌تونی ربات‌های معاملاتی پیشرفته، سیستم‌های تحلیل بازار و داشبوردهای لایو بسازی.

سوالات متداول (FAQ)