خانه / توسعهدهندگان / API
مستندات API توربوگپ
در این صفحه نمونههای عملی از سرویسهای API آربیتراژ و دادههای مارکت توربوگپ را مشاهده میکنید. کلیه سرویسها فقط با API Key قابل استفاده هستند.
۱) سرویس آربیتراژ بین صرافیها
دریافت لیست فرصتهای آربیتراژ بین صرافیها با کنترل بازه اختلاف قیمت و حجم معاملات.
Endpoint:
GET https://turbogap.ir/api/v1/arbitrage.php?api_key=YOUR_API_KEY
پارامترهای Query:
| نام | نوع | اجباری | توضیح |
|---|---|---|---|
| api_key | string | بله | کلید دسترسی اختصاصی شما |
| min_spread | float | خیر | حداقل درصد سود (مثلاً ۱۰) |
| max_spread | float | خیر | حداکثر درصد سود (مثلاً ۲۰). اگر خالی باشد سقف ندارد. |
| min_volume | float | خیر | حداقل حجم ۲۴ساعته (بر اساس جمع حجم همه صرافیها برای آن جفت) |
| limit | int | خیر | تعداد حداکثری نتایج (پیشفرض ۵۰، سقف ۲۰۰) |
| sort | string | خیر |
نحوه مرتبسازی:
spread_desc (پیشفرض),
spread_asc,
volume_desc,
volume_asc
|
نمونه درخواست:
GET https://turbogap.ir/api/v1/arbitrage.php?api_key=YOUR_API_KEY&min_spread=10&max_spread=20&min_volume=50000&limit=20&sort=spread_desc
نمونه cURL:
curl -X GET "https://turbogap.ir/api/v1/arbitrage.php?min_spread=10&max_spread=20&min_volume=50000&limit=20&sort=spread_desc" \
-H "X-API-KEY: YOUR_API_KEY"
۲) فهرست کوینها و جفتارزهای یک صرافی
مشاهده تمام pairها در یک صرافی بههمراه قیمت، حجم و اطلاعات مارکت.
Endpoint:
GET https://turbogap.ir/api/v1/exchange_pairs.php?api_key=YOUR_API_KEY
پارامترهای Query:
| نام | نوع | اجباری | توضیح |
|---|---|---|---|
| api_key | string | بله | کلید دسترسی |
| exchange | string | بله | نام صرافی (مطابق ستون exchange_name در دیتابیس) |
| quote | string | خیر | فیلتر بر اساس جفت پایه (مثلاً USDT, TMN, IRR) |
| min_volume | float | خیر | حداقل حجم ۲۴ساعته آن جفتارز |
| limit | int | خیر | حداکثر نتایج (پیشفرض ۲۰۰، سقف ۵۰۰) |
| sort | string | خیر |
نوع مرتبسازی:
volume_desc (پیشفرض),
volume_asc,
symbol_asc,
symbol_desc
|
نمونه درخواست (مثال: Wallex فقط USDT):
GET https://turbogap.ir/api/v1/exchange_pairs.php?api_key=YOUR_API_KEY&exchange=Wallex"e=USDT&min_volume=100000&sort=volume_desc
۳) بازارهای یک کوین – در چه صرافیهایی معامله میشود؟
نمایش اینکه یک کوین (مثل BTC یا ETH) در کدام صرافیها و با چه جفتارزهایی معامله میشود.
Endpoint:
GET https://turbogap.ir/api/v1/coin_markets.php?api_key=YOUR_API_KEY
پارامترهای Query:
| نام | نوع | اجباری | توضیح |
|---|---|---|---|
| api_key | string | بله | کلید دسترسی |
| symbol | string | بله | نماد کوین (BTC, ETH, DOGE, ...) |
| quote | string | خیر | فیلتر جفتارز پایه (مثلاً فقط USDT یا فقط TMN) |
| min_volume | float | خیر | حداقل حجم ۲۴ساعته برای آن مارکت |
| limit | int | خیر | حداکثر تعداد مارکتها (پیشفرض ۳۰۰، سقف ۵۰۰) |
| sort | string | خیر |
مرتبسازی:
volume_desc (پیشفرض),
volume_asc,
price_asc,
price_desc
|
نمونه درخواست (بازارهای BTC فقط USDT):
GET https://turbogap.ir/api/v1/coin_markets.php?api_key=YOUR_API_KEY&symbol=BTC"e=USDT&min_volume=100000&sort=volume_desc