Meletakkan pesanan - addOrder
Membatalkan pesanan - cancelOrder
Perdagangan (meletakkan dan membatalkan pesanan) melalui WebSocket API v1 disediakan oleh titik akhir addOrder dan cancelOrder. Sama seperti perdagangan melalui REST API, titik akhir addOrder digunakan untuk meletakkan pesanan baharu, dan titik akhir cancelOrder digunakan untuk membatalkan pesanan sedia ada (terbuka).
Setelah sambungan ke WebSocket API telah diwujudkan, pesanan boleh diletakkan dan dibatalkan melalui langkah-langkah berikut:
mendapatkan token pengesahan melalui titik akhir REST API GetWebSocketsToken (setelah token yang sah telah didapatkan, token yang sama boleh digunakan untuk berbilang permintaan addOrder/cancelOrder),
hantar permintaan addOrder/cancelOrder yang sesuai,
terima respons yang menunjukkan sama ada permintaan itu berjaya atau tidak.
Dokumentasi WebSocket API kami menyediakan spesifikasi lengkap untuk titik akhir addOrder, termasuk format JSON yang mesti digunakan, bersama dengan penerangan setiap medan yang diperlukan dan pilihan.
Sebagai contoh, mesej JSON berikut akan meletakkan pesanan baharu untuk membeli 0.25 ETH/EUR pada harga had €150:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Dengan mengandaikan pesanan di atas berjaya diletakkan (dana yang mencukupi tersedia dalam baki akaun, dsb.), mesej JSON berikut akan diterima sebagai respons:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
Dokumentasi WebSocket API kami menyediakan spesifikasi lengkap untuk titik akhir cancelOrder, termasuk format JSON yang mesti digunakan, bersama dengan penerangan setiap medan yang diperlukan dan pilihan.
Tidak seperti REST API, titik akhir cancelOrder WebSocket API boleh digunakan untuk membatalkan berbilang pesanan secara serentak, dengan menyatakan setiap ID pesanan (atau rujukan pengguna) dalam tatasusunan txid.
Sebagai contoh, mesej JSON berikut akan membatalkan mana-mana pesanan terbuka dengan ID pesanan yang sepadan:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Dengan mengandaikan pesanan berjaya dibatalkan, mesej JSON berikut akan diterima sebagai respons:
{
"event": "cancelOrderStatus",
"status": "ok"
}