وب سرویس بازار ارز دیجیتال (اطلاعات بازار)
در مقاله قبل در مورد API بازار ارز دیجیتال (اطلاعات کاربری) صحبت کردیم در این مقاله در مورد API بازار ارز دیجیتال (اطلاعات بازار) توضیح خواهیم داد.
اطلاعات بازار (عمومی)
لیست سفارشات
برای دریافت لیست سفارشات از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/orders/list
پارامترها :
| پارامتر | نوع | پیش‌فرض | توضیحات | نمونه |
| order | string | price | ترتیب | price یا price- |
| type | string | اختیاری | نوع سفارش | buy یا sell |
| srcCurrency | string | اختیاری | ارز مبدا | btc |
| dstCurrency | string | اختیاری | ارز مقصد | rls |
curl ‘https://api.nobitex.ir/market/orders/list’ \
-X POST \
-H “content-type: application/json” \
–data ‘{“order”:”-price”,”type”:”sell”,”dstCurrency”:”usdt”}’
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
{
“status”: “ok”,
“orders”: [
{
“unmatchedAmount”: “0.1416000000”,
“amount”: “0.1416000000”,
“srcCurrency”: “Bitcoin”,
“dstCurrency”: “Tether(omni)”,
“matchedAmount”: “0E-10”,
“isMyOrder”: false,
“price”: “5787.0000000000”,
“type”: “sell”,
“totalPrice”: “819.43920000000000000000”
},
…
]
}
ترتیب ’price’ از قیمت کم به زیاد و ترتیب ‘price-‘ بالعکس می باشد .
لیست معاملات
برای دریافت لیست معاملات از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/trades/list
پارامترها
| پارامتر | نوع | پیش‌فرض | توضیحات | نمونه |
| srcCurrency | string | الزامی | ارز مبدا | btc |
| dstCurrency | string | الزامی | ارز مقصد | rls |
curl ‘https://api.nobitex.ir/market/trades/list’ \
-X POST \
-H “content-type: application/json” \
–data ‘{“srcCurrency”:”btc”,”dstCurrency”:”rls”}’
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
“trades”: [
{
“market”: “Bitcoin-﷼”,
“total”: “99949293.63720000000000000000”,
“price”: “750032220.0000000000”,
“amount”: “0.1332600000”,
“type”: “buy”,
“timestamp”: “2018-11-18T11:56:07.798845+00:00”
},
…
],
“status”: “ok”
}
آمار بازار نوبیتکس
برای دریافت آخرین آمار بازار نوبیتکس از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/stats
پارامترها
| پارامتر | نوع | پیش‌فرض | توضیحات | نمونه |
| srcCurrency | string | الزامی | ارزها مبدا | btc,usdt |
| dstCurrency | string | الزامی | ارز مقصد | rls |
curl ‘https://api.nobitex.ir/market/stats’ \
-X POST \
-H “content-type: application/json” \
–data ‘{“srcCurrency”:”btc”,”dstCurrency”:”rls”}’
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
{
“stats”: {
“btc-rls”: {
“bestSell”: “749976360.0000000000”,
“isClosed”: false,
“dayOpen”: “686021860.0000000000”,
“dayHigh”: “750350000.0000000000”,
“bestBuy”: “733059600.0000000000”,
“volumeSrc”: “0.2929480000”,
“dayLow”: “686021860.0000000000”,
“latest”: “750350000.0000000000”,
“volumeDst”: “212724856.0678640000”,
“dayChange”: “9.38”,
“dayClose”: “750350000.0000000000”
},
},
“status”: “ok”
}
محدودیت فراخوانی : 100 درخواست در 10 دقیقه
آمار بازار جهانی
برای دریافت آمار بازارهای جهانی از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/global-stats
این آمارها مربوط به بازارهای Kraken و Binance می باشد
curl ‘https://api.nobitex.ir/market/global-stats’ \
-X POST
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
{
“ltc”: {
“kraken”: {
“price”: “41.69”
}
},
“btc”: {
“kraken”: {
“price”: “5517.2”
}
},
…
“status”: “ok”
}
محدودیت فراخوانی : 100 درخواست در 10 دقیقه
بازار
سفارش جدید
برای سفارش گذاری از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/orders/add
پارامترها :
| type | string | الزامی | نوع سفارش | buy یا sell |
| execution | string | market | نحوه سفارش | market یا limit |
| srcCurrency | string | الزامی | ارز مبدا | btc |
| dstCurrency | string | الزامی | ارز مقصد | rls |
| amount | string | الزامی | مقدار | 0.6 |
| price | int | الزامی | قیمت واحد | 520000000 |
برای ثبت سفارش سریع(مارکت)، مقدار پارامتر ‘execution’ باید برابر ‘market’ باشد.
curl ‘https://api.nobitex.ir/market/orders/add’ \
-X POST \
-H “Authorization: Token e9282e56c83f93eb077043e5ad8b6cf5b3ff7568” \
-H “content-type: application/json” \
–data ‘{“type”:”buy”,”srcCurrency”:”btc”,”dstCurrency”:”rls”,”amount”:”0.6″,”price”:520000000}’
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
“status”: “ok”,
“order”: {
“type”: “sell”,
“srcCurrency”: “Bitcoin”,
“dstCurrency”: “ریال”,
“price”: “520000000”,
“amount”: “0.6”,
“totalPrice”: “312000000.0”,
“matchedAmount”: 0,
“unmatchedAmount”: “0.6”,
“isMyOrder”: false,
“id”: 25,
“status”: “Active”,
“partial”: false,
“fee”: 0,
“user”: “name@example.com”,
“created_at”: “2018-11-28T11:36:13.592827+00:00”
}
}
محدودیت فراخوانی : 100 درخواست در 10 دقیقه
وضعیت سفارش
برای دریافت وضعیت سفارش از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/orders/add
پارامترها :
| پارامتر | نوع | پیش‌فرض | توضیحات | نمونه |
| id | int | الزامی | شناسه سفارش | 5684 |
curl ‘https://api.nobitex.ir/market/orders/status’ \
-X POST \
-H “Authorization: Token e9282e56c83f93eb077043e5ad8b6cf5b3ff7568” \
-H “content-type: application/json” \
–data ‘{“id”:5684}’
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
“status”: “ok”,
“order”: {
“unmatchedAmount”: “3.0000000000”,
“fee”: “0E-10”,
“matchedAmount”: “0E-10”,
“partial”: false,
“price”: “8500000.0000000000”,
“created_at”: “2018-11-28T12:25:22.696029+00:00”,
“user”: “name@example.com”,
“id”: 5684,
“srcCurrency”: “Litecoin”,
“totalPrice”: “25500000.00000000000000000000”,
“type”: “sell”,
“dstCurrency”: “\ufdfc”,
“isMyOrder”: false,
“status”: “Active”,
“amount”: “3.0000000000”
}
}
لغو سفارش
برای سفارش گذاری از این نوع درخواست استفاده نمایید:
آدرس :
POST /market/orders/update-status
پارامترها
| پارامتر | نوع | پیش‌فرض | توضیحات | نمونه |
| order | int | الزامی | شناسه سفارش | 5684 |
| status | string | الزامی | وضعیت جدید | canceled |
curl ‘https://api.nobitex.ir/market/orders/update-status’ \
-X POST \
-H “Authorization: Token e9282e56c83f93eb077043e5ad8b6cf5b3ff7568” \
-H “content-type: application/json” \
–data ‘{“order”:5684,”status”:”canceled”}’
در صورت فراخوانی درست، پاسخ به این صورت خواهد بود:
{
“status”: “ok”,
“updatedStatus”: “Canceled”
}
محدودیت فراخوانی : 100 درخواست در 10 دقیقه
در مقاله بعد در مورد وب سرویس کیف پول ارز دیجیتال صحبت خواهیم کرد.