مرجع API دکس CoinMarketCap

این اسکیل، APIهای دکس CoinMarketCap را برای داده توکن آن‌چین پوشش می‌دهد. برخلاف اندپوینت‌های صرافی متمرکز، این‌ها داده را مستقیم از دکس‌هایی مثل یونی‌سواپ، پنکیک‌سواپ و رایدیوم می‌گیرند.

■ احراز هویت
curl -X GET "https://pro-api.coinmarketcap.com/v1/dex/platform/list" -H "X-CMC_PRO_API_KEY: کلید-شما"
کلید از https://pro.coinmarketcap.com/login

■ آدرس پایه
https://pro-api.coinmarketcap.com

■ تفاوت GET و POST
بسیاری از اندپوینت‌های دکس برای پرس‌وجوهای پیچیده از POST استفاده می‌کنند. همیشه متد را بررسی کن:
۱. اندپوینت‌های GET پارامترها را در رشته پرس‌وجو می‌گیرند.
۲. اندپوینت‌های POST پارامترها را در بدنه JSON با هدر Content-Type: application/json می‌گیرند.

■ کاربردهای رایج
۱. قیمت توکن دکس با آدرس قرارداد
۲. یافتن آدرس قرارداد یک توکن با نام
۳. قیمت چند توکن به‌صورت یکجا
۴. بررسی امنیت توکن پیش از معامله
۵. یافتن استخرهای نقدینگی یک توکن
۶. توکن‌های ترند دکس
۷. بیشترین رشدهای امروز در دکس
۸. توکن‌های تازه‌عرضه‌شده
۹. تشخیص راگ‌پول احتمالی (خروج نقدینگی)
۱۰. معاملات اخیر یک توکن
۱۱. شبکه‌ها و دکس‌های پشتیبانی‌شده
۱۲. فهرست میم‌کوین‌ها

■ فهرست اندپوینت‌ها

| اندپوینت | متد | توضیح |
| /v1/dex/token | GET | جزئیات توکن بر اساس پلتفرم و آدرس |
| /v1/dex/token/price | GET | آخرین قیمت دکس یک توکن |
| /v1/dex/token/price/batch | POST | قیمت دسته‌ای چند توکن |
| /v1/dex/token/pools | GET | استخرهای نقدینگی یک توکن |
| /v1/dex/token-liquidity/query | GET | نقدینگی توکن در طول زمان |
| /v1/dex/tokens/batch-query | POST | متادیتای دسته‌ای توکن‌ها |
| /v1/dex/tokens/transactions | GET | تراکنش‌های اخیر دکس |
| /v1/dex/tokens/trending/list | POST | توکن‌های ترند دکس |
| /v4/dex/pairs/quotes/latest | GET | آخرین قیمت جفت‌های دکس |
| /v4/dex/spot-pairs/latest | GET | فهرست جفت‌های اسپات دکس |
| /v1/dex/platform/list | GET | فهرست پلتفرم‌های پشتیبانی‌شده |
| /v1/dex/platform/detail | GET | جزئیات پلتفرم |
| /v1/dex/search | GET | جستجوی توکن و جفت |
| /v1/dex/gainer-loser/list | POST | بیشترین رشد و افت دکس |
| /v1/dex/liquidity-change/list | GET | توکن‌هایی با تغییر نقدینگی |
| /v1/dex/meme/list | POST | میم‌توکن‌های دکس |
| /v1/dex/new/list | POST | توکن‌های تازه‌کشف‌شده |
| /v1/dex/security/detail | GET | سیگنال‌های ریسک و امنیت توکن |

■ گردش کارهای رایج

اطلاعات توکن دکس:
۱. جستجو: /v1/dex/search?keyword=PEPE
۲. جزئیات: /v1/dex/token?network_slug=ethereum&contract_address=0x...
۳. بررسی ریسک امنیتی: /v1/dex/security/detail?network_slug=ethereum&contract_address=0x...

تحلیل نقدینگی:
۱. استخرهای توکن: /v1/dex/token/pools?network_slug=ethereum&contract_address=0x...
۲. تاریخچه نقدینگی: /v1/dex/token-liquidity/query?network_slug=ethereum&contract_address=0x...

یافتن توکن‌های ترند:
۱. POST /v1/dex/tokens/trending/list با فیلترها
۲. POST /v1/dex/gainer-loser/list
۳. POST /v1/dex/new/list

رصد فعالیت دکس:
۱. تراکنش‌های اخیر: /v1/dex/tokens/transactions?network_slug=ethereum&contract_address=0x...
۲. قیمت جفت: /v4/dex/pairs/quotes/latest?network_slug=ethereum&contract_address=0x...

■ پارامترهای کلیدی
بیشتر اندپوینت‌های دکس این‌ها را می‌خواهند:
۱. network_slug یا platform_crypto_id — شبکه بلاک‌چین (ethereum، solana، bsc)
۲. contract_address — آدرس قرارداد توکن روی زنجیره
برای گرفتن اسلاگ‌های معتبر شبکه، از /v1/dex/platform/list استفاده کن.

■ مدیریت خطا
۴۰۰ درخواست نامعتبر | ۴۰۱ کلید نامعتبر یا غایب | ۴۰۳ اندپوینت در پلن شما نیست | ۴۲۹ محدودیت نرخ | ۵۰۰ خطای سرور

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