🟢 API V2 — Non-Custodial (بدون UserID)
✅ معماری جدید Non-Custodial:
این endpointها عمومی هستند و نیازی به UserID ندارند.
داده‌ها از CoinGecko رایگان (۱ req/۲min) کش می‌شوند.
بار سرور برای ۱۰ تا ۱۰۰,۰۰۰ کاربر یکسان است.
هزینه اضافی: $0
این endpointها عمومی هستند و نیازی به UserID ندارند.
داده‌ها از CoinGecko رایگان (۱ req/۲min) کش می‌شوند.
بار سرور برای ۱۰ تا ۱۰۰,۰۰۰ کاربر یکسان است.
هزینه اضافی: $0
GET قیمت لحظه‌ای
/api/v2/pricesدریافت قیمت لحظه‌ای همه ارزهای اصلی. داده از CoinGecko هر ۲ دقیقه کش می‌شود.
Query Parameters (اختیاری):
| پارامتر | نوع | توضیحات |
|---|---|---|
| symbol | string اختیاری | فیلتر بر اساس سمبل (مثلاً ?symbol=BTC) |
| currency | string اختیاری | ارز مرجع (پیش‌فرض: USD) |
# 🔹 مثال — همه قیمت‌ها GET https://coinceeper.com/api/v2/prices # 🔹 مثال — قیمت بیت‌کوین GET https://coinceeper.com/api/v2/prices?symbol=BTC # 🔹 مثال — قیمت یک ارز خاص GET https://coinceeper.com/api/v2/prices/BTC
GET نمودار قیمت (تاریخی)
/api/v2/chart?symbol=BTC&days=7داده‌های قیمت تاریخی برای رسم نمودار. از CoinGecko هر ۵ دقیقه کش می‌شود.
Query Parameters:
| پارامتر | نوع | توضیحات |
|---|---|---|
| symbol | string الزامی | سمبل ارز (مثلاً BTC, ETH) |
| days | int اختیاری | تعداد روز (۱ تا ۳۶۵، پیش‌فرض: ۷) |
GET https://coinceeper.com/api/v2/chart?symbol=BTC&days=30
GET کارمزد شبکه‌ها (Gas Fee)
/api/v2/gasکارمزد شبکه‌های مختلف از public RPC. هر ۱ دقیقه کش می‌شود.
Query Parameters (اختیاری):
| پارامتر | نوع | توضیحات |
|---|---|---|
| chain | string اختیاری | نام شبکه (مثلاً ?chain=Ethereum) |
# همه شبکه‌ها GET https://coinceeper.com/api/v2/gas # یک شبکه خاص GET https://coinceeper.com/api/v2/gas?chain=Ethereum
GET لیست ارزها (صفحه‌بندی شده)
/api/v2/coinsلیست کامل ارزهای دیجیتال از CoinGecko. یکبار در روز کش می‌شود. با صفحه‌بندی برای کاهش حجم پاسخ و بهبود سرعت.
Query Parameters (اختیاری):
| پارامتر | نوع | توضیحات |
|---|---|---|
| search | string اختیاری | جستجو در نام یا سمبل |
| page | int اختیاری | شماره صفحه (پیش‌فرض: 1) |
| per_page | int اختیاری | تعداد در هر صفحه (پیش‌فرض: 50، حداکثر: 200) |
| limit | int منسوخ | از per_page استفاده کنید |
GET https://coinceeper.com/api/v2/coins?search=bitcoin&per_page=5
Response شامل متادیتای صفحه‌بندی:
{
"success": true,
"coins": [...],
"count": 5,
"page": 1,
"per_page": 50,
"total": 17408,
"total_pages": 349,
"has_next": true,
"has_prev": false,
"cache_status": "ready",
"cache_age_seconds": 123.4
}
GET وضعیت سرویس
/api/v2/healthبررسی وضعیت همه کش‌ها و سلامت سرویس Non-Custodial.
GET https://coinceeper.com/api/v2/health
🔑 ویژگی‌های API V2:
✅ بدون UserID — Non-Custodial واقعی
✅ کش در RAM — پاسخ زیر ۱ms
✅ بار سرور ثابت — مقیاس تا ۱۰۰,۰۰۰ کاربر
✅ هزینه اضافی: $0
✅ داده از CoinGecko رایگان
✅ بدون UserID — Non-Custodial واقعی
✅ کش در RAM — پاسخ زیر ۱ms
✅ بار سرور ثابت — مقیاس تا ۱۰۰,۰۰۰ کاربر
✅ هزینه اضافی: $0
✅ داده از CoinGecko رایگان
⚠️ endpointهای قدیمی (V1) DEPRECATED شده‌اند:
/api/prices ← از /api/v2/prices استفاده کنید/api/chart-data ← از /api/v2/chart استفاده کنید/api/historical-prices ← از /api/v2/chart استفاده کنید/api/transactions ← مستقیم از block explorer بخوانید
🛍️ Shop API
API های مربوط به مدیریت محصولات فروشگاه
💬 Chat API (Direct Messages)
API های مربوط به چت تک به تک و مدیریت مکالمات
🚨 Report & Block API
API های مربوط به گزارش و بلاک کردن کاربران
🛡️ Moderation API
API های مربوط به مدیریت و moderation محتوا (فقط برای Moderator ها)
⚡ WebSocket Events
Event های WebSocket برای چت لحظه‌ای و typing indicators