CCXT Documentation

مقدمه

CCXT (CryptoCurrency eXchange Trading Library) یک کتابخانه متن‌باز و قدرتمند پایتون است که به معامله‌گران رمزارز امکان می‌دهد به آسانی به APIهای صرافی‌های مختلف رمزارز متصل شوند. این کتابخانه با ارائه یک رابط یکپارچه، فرآیند جمع‌آوری داده‌ها، انجام معاملات و مدیریت پورتفوی را ساده می‌کند. CCXT از بیش از ۱۰۰ صرافی رمزارز پشتیبانی می‌کند و به شما امکان می‌دهد بدون نیاز به یادگیری APIهای خاص هر صرافی، به طور یکنواخت با آن‌ها تعامل داشته باشید. این مقاله به عنوان یک راهنمای جامع برای مبتدیان، به بررسی عمیق CCXT، نصب، مفاهیم کلیدی، نحوه استفاده و مثال‌های عملی می‌پردازد.

چرا CCXT؟

قبل از CCXT، معامله‌گران برای اتصال به هر صرافی، باید API خاص آن صرافی را یاد می‌گرفتند و کدنویسی جداگانه‌ای برای هر کدام انجام می‌دادند. این فرآیند زمان‌بر، پیچیده و مستعد خطا بود. CCXT این مشکل را با ارائه یک رابط یکپارچه حل کرد. مزایای استفاده از CCXT عبارتند از:

• **پشتیبانی گسترده از صرافی‌ها:** CCXT از تعداد زیادی صرافی پشتیبانی می‌کند، از صرافی‌های بزرگ مانند Binance و Coinbase Pro گرفته تا صرافی‌های کوچکتر و کمتر شناخته شده.
• **رابط کاربری یکپارچه:** با استفاده از CCXT، می‌توانید با یک کد مشابه با APIهای مختلف صرافی‌ها تعامل داشته باشید، بدون اینکه نیاز به تغییر کد برای هر صرافی داشته باشید.
• **سادگی و سهولت استفاده:** CCXT طراحی شده است تا استفاده از آن آسان باشد، حتی برای کسانی که تجربه کمی در برنامه‌نویسی دارند.
• **متن‌باز و رایگان:** CCXT یک پروژه متن‌باز است، به این معنی که کد آن به صورت رایگان در دسترس است و می‌توانید آن را تغییر دهید و بهبود بخشید.
• **جامعه فعال:** CCXT دارای یک جامعه فعال از توسعه‌دهندگان و کاربران است که به یکدیگر کمک می‌کنند و مشکلات را حل می‌کنند.

نصب CCXT

نصب CCXT بسیار ساده است. می‌توانید از pip، مدیر بسته پایتون، برای نصب آن استفاده کنید:

```bash pip install ccxt ```

پس از نصب، می‌توانید CCXT را در برنامه‌های پایتون خود import کنید:

```python import ccxt ```

مفاهیم کلیدی CCXT

• **Exchange:** یک شی Exchange نمایانگر یک صرافی خاص است. برای ایجاد یک شی Exchange، باید نام صرافی را به سازنده ارسال کنید. به عنوان مثال:

   ```python
   exchange = ccxt.binance()
   ```

• **Market:** یک شی Market نمایانگر یک جفت معاملاتی خاص در یک صرافی است. به عنوان مثال، BTC/USDT در Binance.
• **Order:** یک شی Order نمایانگر یک دستور خرید یا فروش است.
• **Trade:** یک شی Trade نمایانگر یک معامله انجام شده است.
• **OHLCV:** مخفف Open, High, Low, Close, Volume است و نمایانگر داده‌های قیمتی یک جفت معاملاتی در یک بازه زمانی مشخص است.
• **Ticker:** یک شی Ticker نمایانگر اطلاعات خلاصه از یک جفت معاملاتی است، مانند قیمت آخرین معامله، حجم معاملات و قیمت پیشنهادی/درخواستی.

نحوه استفاده از CCXT

اتصال به صرافی

همانطور که گفته شد، برای اتصال به یک صرافی، باید یک شی Exchange ایجاد کنید. به عنوان مثال:

```python exchange = ccxt.binance({

   'apiKey': 'YOUR_API_KEY',
   'secret': 'YOUR_SECRET_KEY',

}) ```

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

دریافت اطلاعات

CCXT به شما امکان می‌دهد اطلاعات مختلفی را از صرافی‌ها دریافت کنید، از جمله:

• **دریافت لیست صرافی‌های پشتیبانی شده:**

   ```python
   exchanges = ccxt.exchanges
   print(exchanges)
   ```

• **دریافت اطلاعات مربوط به یک جفت معاملاتی:**

   ```python
   ticker = exchange.fetch_ticker('BTC/USDT')
   print(ticker)
   ```

• **دریافت داده‌های OHLCV:**

   ```python
   ohlcv = exchange.fetch_ohlcv('BTC/USDT', timeframe='1h', limit=100)
   print(ohlcv)
   ```

• **دریافت دفترچه سفارشات (Order Book):**

   ```python
   orderbook = exchange.fetch_order_book('BTC/USDT')
   print(orderbook)
   ```

• **دریافت موقعیت‌های باز (Open Positions):** (در صرافی‌های فیوچرز)

   ```python
   positions = exchange.fetch_positions()
   print(positions)
   ```

انجام معاملات

CCXT به شما امکان می‌دهد معاملات مختلفی را انجام دهید، از جمله:

• **خرید:**

   ```python
   order = exchange.create_market_buy_order('BTC/USDT', 0.01)
   print(order)
   ```

• **فروش:**

   ```python
   order = exchange.create_market_sell_order('BTC/USDT', 0.01)
   print(order)
   ```

• **ایجاد سفارش محدود (Limit Order):**

   ```python
   order = exchange.create_limit_buy_order('BTC/USDT', 0.01, 30000)
   print(order)
   ```

• **لغو سفارش:**

   ```python
   exchange.cancel_order('ORDER_ID')
   ```

مدیریت پورتفوی

CCXT به شما امکان می‌دهد اطلاعات مربوط به پورتفوی خود را دریافت کنید:

```python balance = exchange.fetch_balance() print(balance) ```

مثال‌های عملی

محاسبه میانگین هزینه دلار (Dollar-Cost Averaging)

میانگین هزینه دلار یک استراتژی سرمایه‌گذاری است که در آن مقدار ثابتی از پول را در فواصل زمانی منظم صرف خرید یک دارایی می‌کنید، بدون توجه به قیمت آن دارایی. این استراتژی می‌تواند به کاهش ریسک سرمایه‌گذاری کمک کند.

```python import ccxt import time

exchange = ccxt.binance({

   'apiKey': 'YOUR_API_KEY',
   'secret': 'YOUR_SECRET_KEY',

})

symbol = 'BTC/USDT' amount = 10 # مقدار دلاری که در هر دوره زمانی سرمایه‌گذاری می‌کنید period = 86400 # دوره زمانی (به ثانیه) - 1 روز

while True:

   try:
       ticker = exchange.fetch_ticker(symbol)
       price = ticker['last']
       btc_amount = amount / price
       order = exchange.create_market_buy_order(symbol, btc_amount)
       print(f"خرید {btc_amount} BTC با قیمت {price}")
   except Exception as e:
       print(f"خطا: {e}")

   time.sleep(period)

```

استراتژی دنبال کردن روند (Trend Following)

دنبال کردن روند یک استراتژی معاملاتی است که در آن سعی می‌کنید در جهت روند کلی بازار معامله کنید. این استراتژی بر این فرض استوار است که روندها تمایل دارند برای مدت طولانی ادامه یابند.

```python import ccxt import talib # کتابخانه تحلیل تکنیکال

exchange = ccxt.binance({

   'apiKey': 'YOUR_API_KEY',
   'secret': 'YOUR_SECRET_KEY',

})

symbol = 'BTC/USDT' timeframe = '1h' period = 14 # دوره زمانی برای محاسبه میانگین متحرک

while True:

   try:
       ohlcv = exchange.fetch_ohlcv(symbol, timeframe, limit=period)
       closes = [x[4] for x in ohlcv] # استخراج قیمت بسته شدن
       sma = talib.SMA(closes, timeperiod=period) # محاسبه میانگین متحرک ساده
       current_price = ohlcv[-1][4]

       if current_price > sma[-1]:
           # سیگنال خرید
           print("سیگنال خرید")
           # انجام معامله خرید
       elif current_price < sma[-1]:
           # سیگنال فروش
           print("سیگنال فروش")
           # انجام معامله فروش

   except Exception as e:
       print(f"خطا: {e}")

   time.sleep(3600) # هر ساعت یکبار بررسی شود

```

تحلیل حجم معاملات (Volume Analysis)

تحلیل حجم معاملات یک تکنیک معاملاتی است که از حجم معاملات برای تأیید روندها و شناسایی نقاط ورود و خروج استفاده می‌کند.

• **Volume Weighted Average Price (VWAP):** یک شاخص است که قیمت متوسط یک دارایی را در طول یک دوره زمانی مشخص بر اساس حجم معاملات محاسبه می‌کند.
• **On Balance Volume (OBV):** یک شاخص است که رابطه بین قیمت و حجم را نشان می‌دهد.

نکات مهم امنیتی

• **حفاظت از کلیدهای API:** کلیدهای API خود را به دقت محافظت کنید و هرگز آن‌ها را با کسی به اشتراک نگذارید.
• **استفاده از API Keyهای محدود:** در صورت امکان، API Keyهایی با دسترسی محدود ایجاد کنید.
• **بررسی کد:** قبل از اجرای هر کدی که از CCXT استفاده می‌کند، آن را به دقت بررسی کنید تا از عدم وجود آسیب‌پذیری‌های امنیتی اطمینان حاصل کنید.
• **استفاده از احراز هویت دو مرحله‌ای (2FA):** احراز هویت دو مرحله‌ای را برای حساب کاربری خود در صرافی فعال کنید.

منابع بیشتر

• **مستندات رسمی CCXT:** [۱](https://docs.ccxt.com/)
• **GitHub CCXT:** [۲](https://github.com/ccxt/ccxt)
• **انجمن CCXT:** [۳](https://discord.com/invite/EprFQJd)
• **تحلیل تکنیکال**: یادگیری مبانی تحلیل تکنیکال برای بهبود تصمیمات معاملاتی.
• **مدیریت ریسک**: درک اصول مدیریت ریسک برای محافظت از سرمایه خود.
• **فیبوناچی**: استفاده از سطوح فیبوناچی برای شناسایی نقاط حمایت و مقاومت.
• **اندیکاتور RSI**: استفاده از اندیکاتور RSI برای شناسایی شرایط خرید و فروش بیش از حد.
• **اندیکاتور MACD**: استفاده از اندیکاتور MACD برای شناسایی تغییرات در روند قیمت.
• **الگوهای کندل استیک**: شناسایی الگوهای کندل استیک برای پیش‌بینی حرکات قیمت.
• **تحلیل بنیادی**: درک اصول تحلیل بنیادی برای ارزیابی ارزش ذاتی یک دارایی.
• **مفاهیم فیوچرز**: آشنایی با مفاهیم و اصطلاحات مربوط به معاملات فیوچرز.
• **استراتژی مارتینگل**: بررسی استراتژی مارتینگل و خطرات آن.
• **استراتژی گریدی**: بررسی استراتژی گریدی و محدودیت‌های آن.
• **تحلیل حجم معاملات پیشرفته**: بررسی تکنیک‌های پیشرفته تحلیل حجم معاملات.
• **آربیتراژ**: شناسایی فرصت‌های آربیتراژ در صرافی‌های مختلف.
• **ربات‌های معامله‌گر**: ایجاد و استفاده از ربات‌های معامله‌گر خودکار.
• **بک تست**: آزمایش استراتژی‌های معاملاتی با استفاده از داده‌های تاریخی.

نتیجه‌گیری

CCXT یک ابزار قدرتمند و انعطاف‌پذیر است که می‌تواند به معامله‌گران رمزارز کمک کند تا به طور موثرتری معامله کنند. با یادگیری مفاهیم کلیدی و نحوه استفاده از CCXT، می‌توانید فرآیند معامله‌گری خود را ساده کنید و به نتایج بهتری دست یابید. به یاد داشته باشید که قبل از شروع به معامله‌گری، به طور کامل تحقیق کنید و ریسک‌های مربوطه را درک کنید.

پلتفرم‌های معاملات آتی پیشنهادی

پلتفرم	ویژگی‌های آتی	ثبت‌نام
Binance Futures	اهرم تا ۱۲۵x، قراردادهای USDⓈ-M	همین حالا ثبت‌نام کنید
Bybit Futures	قراردادهای معکوس دائمی	شروع به معامله کنید
BingX Futures	معاملات کپی	به BingX بپیوندید
Bitget Futures	قراردادهای تضمین شده با USDT	حساب باز کنید
BitMEX	پلتفرم رمزارزها، اهرم تا ۱۰۰x	BitMEX

به جامعه ما بپیوندید

در کانال تلگرام @strategybin عضو شوید برای اطلاعات بیشتر. بهترین پلتفرم‌های سودآور – همین حالا ثبت‌نام کنید.

در جامعه ما شرکت کنید

در کانال تلگرام @cryptofuturestrading عضو شوید برای تحلیل، سیگنال‌های رایگان و موارد بیشتر!