Kraken WebSocket API - প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

Kraken-এর কি একটি WebSocket API আছে? আমি কিভাবে এটিতে সংযোগ করতে পারি?

Kraken-এর একটি REST API এবং একটি WebSocket API উভয়ই আছে। আমাদের WebSocket API নিম্নলিখিত সুরক্ষিত URL-গুলিতে উপলব্ধ:

পাবলিক (অপ্রমাণিত) মার্কেট ডেটা ফিড: wss://ws.kraken.com/

প্রাইভেট (প্রমাণিত) অ্যাকাউন্ট ডেটা ফিড এবং ট্রেডিং এন্ডপয়েন্ট: wss://ws-auth.kraken.com/

পাবলিক মার্কেট ডেটা ফিডগুলিতে সংযোগ করার জন্য প্রমাণীকরণের প্রয়োজন নেই, তবে প্রাইভেট ফিডগুলির জন্য একটি বৈধ প্রমাণীকরণ টোকেন প্রয়োজন।

WebSocket API-এর মাধ্যমে প্রেরিত এবং প্রাপ্ত সমস্ত বার্তা JSON ফরম্যাটে প্লেইন টেক্সট এনকোড করা হয়। প্রতিটি বার্তার প্রকারের বিবরণ আমাদের WebSocket API ডকুমেন্টেশনে দেওয়া আছে।

আপনার কি WebSocket লাইব্রেরি উপলব্ধ আছে?

আমাদের কাছে বিভিন্ন ধরনের WebSocket API উদাহরণ কোড উপলব্ধ আছে, যা সরাসরি ব্যবহার করা যেতে পারে, অথবা আপনার নিজস্ব বাস্তবায়নের জন্য একটি শুরু করার পয়েন্ট হিসাবে ব্যবহার করা যেতে পারে:

আমাদের WebSocket API আপনার পছন্দের যেকোনো প্রোগ্রামিং ভাষায় বাস্তবায়ন করা যেতে পারে, এবং প্রয়োজনে আমাদের API সহায়তা দল আপনাকে সহায়তা করতে বা অতিরিক্ত ভাষায় উদাহরণ কোড সরবরাহ করতে পেরে খুশি হবে।

কোন ফিড/এন্ডপয়েন্টগুলি সমর্থিত?

আমাদের WebSocket API বিভিন্ন ধরনের রিয়েল টাইম মার্কেট ডেটা ফিড, অ্যাকাউন্ট ডেটা ফিড এবং ট্রেডিং এন্ডপয়েন্ট সরবরাহ করে। উপলব্ধ ফিড/এন্ডপয়েন্টগুলির একটি সম্পূর্ণ তালিকা, প্রতিটি ফিড/এন্ডপয়েন্টের বাস্তবায়নের বিবরণ সহ, আমাদের WebSocket API ডকুমেন্টেশনে পাওয়া যাবে।

আমি কিভাবে জানব যে আমি সফলভাবে সংযুক্ত হয়েছি? আমি কিভাবে জানব যে আমি এখনও সংযুক্ত আছি?

একটি ফিডে সাবস্ক্রাইব করা হলে, প্রতি সেকেন্ডে 1টি heartbeat ফ্রিকোয়েন্সিতে একটি {u'event': u'heartbeat'} বার্তা পাওয়া যাবে।

যদি অন্যান্য বার্তা (মার্কেট ডেটা, অ্যাকাউন্ট ডেটা ইত্যাদি) পরিবর্তে পাওয়া যায়, তাহলে heartbeats পাওয়া যাবে না। কখন এবং কেন মার্কেট বা অ্যাকাউন্ট ডেটা পাওয়া যায় তা নির্ভর করে আপনি যে ফিডে সাবস্ক্রাইব করেছেন তার উপর।

যদি আপনি কম ট্রেডিং ভলিউম সহ একটি কারেন্সি পেয়ারের ফিডে সাবস্ক্রাইব করেন, তাহলে আপনি দীর্ঘ সময়ের জন্য শুধুমাত্র heartbeats পেতে পারেন।

যদি আপনি একটি ফিড থেকে আনসাবস্ক্রাইব করেন, তাহলে আপনি আর heartbeats বা ট্রেডিং ডেটা পাবেন না এবং 1 মিনিটের জন্য কোনো ফিডে সাবস্ক্রাইব না থাকার পর আপনি WebSockets ফিড থেকে ডিসকানেক্ট হয়ে যাবেন।

কখন এবং কেন WebSocket আপডেট করা ডেটা পাঠায়?

কখন এবং কেন মার্কেট ডেটা বা অ্যাকাউন্ট ডেটা পাওয়া যায় তা নির্ভর করে আপনি যে ফিডে সাবস্ক্রাইব করেছেন তার উপর। উদাহরণস্বরূপ:

Ticker: যখন একটি কারেন্সি পেয়ারের জন্য একটি ট্রেড বা ট্রেডের ব্যাচ থাকে, তখন সেই পেয়ারের জন্য একটি Ticker বার্তা প্রকাশিত হয়। আপনি শুধুমাত্র তখনই এই বার্তাটি পাবেন যদি আপনি এই পেয়ারের Ticker ফিডে সাবস্ক্রাইব করে থাকেন।

Trade: একইভাবে, যখন একটি কারেন্সি পেয়ারের জন্য একটি ট্রেড বা ট্রেডের ব্যাচ থাকে, তখন সেই পেয়ারের জন্য একটি Trade বার্তা প্রকাশিত হয়। আপনি শুধুমাত্র তখনই এই বার্তাটি পাবেন যদি আপনি এই পেয়ারের Trade ফিডে সাবস্ক্রাইব করে থাকেন।

OHLC: যখন একটি কারেন্সি পেয়ারের জন্য একটি ট্রেড বা ট্রেডের ব্যাচ কার্যকর করা হয়, তখন প্রতিটি ইন্টারভালের জন্য একটি আপডেট করা OHLC ইন্টারভাল প্রকাশিত হয়। আপনি শুধুমাত্র সেই ইন্টারভালগুলির জন্য আপডেট পাবেন যেগুলিতে আপনি সাবস্ক্রাইব করেছেন। একটি ইন্টারভাল বর্ডার অতিক্রম করার পর, পরবর্তী ট্রেড না হওয়া পর্যন্ত কোনো বার্তা পাঠানো হয় না।

Book: যখন প্রথম Book ফিডে সাবস্ক্রাইব করা হয়, তখন নির্বাচিত গভীরতা সহ অর্ডার বুকের একটি প্রাথমিক স্ন্যাপশট প্রকাশিত হয়।

অর্ডার বুকে নতুন অর্ডার যোগ করা হলে বা ট্রেড কার্যকর করা হলে যা আপনি সাবস্ক্রাইব করেছেন এমন অর্ডার বুকের গভীরতাকে প্রভাবিত করে, তখন প্রভাবিত মূল্য স্তর এবং ভলিউমের জন্য অর্ডার বুক আপডেট সম্বলিত একটি বার্তা প্রকাশিত হয়। এই আপডেটগুলিতে শুধুমাত্র bids, শুধুমাত্র asks, অথবা bids এবং asks উভয়ই থাকতে পারে। বিস্তারিত জানার জন্য নিচে How to build an order book দেখুন।

Spread: যখন একটি নতুন সর্বোচ্চ bid বা সর্বনিম্ন ask অর্ডার স্থাপন করা হয়, অথবা একটি ট্রেড কার্যকর করা হয় যা সেরা bid বা সেরা ask মূল্য পরিবর্তন করে, তখন আপডেট করা bid এবং ask মূল্য সহ একটি Spread বার্তা প্রকাশিত হয়।

WebSocket ফিডগুলি কি ঐতিহাসিক ডেটা সরবরাহ করে নাকি শুধুমাত্র বর্তমান ডেটা?

WebSocket মার্কেট ডেটা ফিডগুলি শুধুমাত্র বর্তমান ডেটা সরবরাহ করে, তবে বর্তমান ডেটার জন্য WebSocket API এবং ঐতিহাসিক ডেটার জন্য REST API-এর সাথে একই সাথে সংযোগ করা সম্ভব।

reqid প্যারামিটারের ব্যবহার।

সাবস্ক্রিপশন অনুরোধগুলিতে একটি ক্লায়েন্ট-প্রদত্ত reqid প্যারামিটার অন্তর্ভুক্ত থাকতে পারে যা পরবর্তীতে সেই সাবস্ক্রিপশনের জন্য কাঙ্ক্ষিত WebSocket সাবস্ক্রিপশন অনুরোধকে channel ID-এর সাথে মেলাতে ব্যবহার করা যেতে পারে।

মনে রাখবেন যে আপনি যদি একই সময়ে একাধিক WebSocket সাবস্ক্রিপশন করেন, তাহলে সেগুলিকে একই reqid মান বরাদ্দ করা হবে। একটি ভিন্ন reqid মান বরাদ্দ করার জন্য, প্রতিটি ফিডকে আলাদাভাবে সাবস্ক্রাইব করতে হবে।

আমি আরও বিস্তারিত জানতে চাই, কোথায় পাব?

সম্পূর্ণ WebSocket API স্পেসিফিকেশন WebSocket API ডকুমেন্টেশনে উপলব্ধ।

REST এবং WebSocket API-গুলিতে কারেন্সি পেয়ার সিম্বলের মধ্যে পার্থক্য।

WebSocket API শুধুমাত্র ISO 4217-A3 ফরম্যাটে কারেন্সি পেয়ার সিম্বল গ্রহণ করে, যেমন XBT/USD।

REST API AssetPairs এন্ডপয়েন্ট REST API সংস্করণ (যেমন XBTUSD বা XXBTZUSD) এবং WebSocket API সংস্করণ (যেমন XBT/USD) এর মধ্যে সিম্বল অনুবাদ করতে ব্যবহার করা যেতে পারে।

https://api.kraken.com/0/public/AssetPairs

wsname ফিল্ড WebSocket API সিম্বল সরবরাহ করে।

কিভাবে একটি অর্ডার বুক তৈরি করবেন

WebSocket API Book ফিড সমস্ত WebSocket ফিডের মধ্যে সবচেয়ে জটিল, তবে যতক্ষণ Book ফিড বার্তাগুলি সঠিকভাবে ব্যাখ্যা করা হয়, ততক্ষণ মাত্র কয়েকটি কোড লাইন দিয়ে একটি অর্ডার বুকের স্থানীয় কপি বজায় রাখা সম্ভব।

আমাদের WebSocket API সহায়তা পৃষ্ঠাগুলি Book ফিড বার্তাগুলি ব্যাখ্যা করার জন্য বিস্তারিত নির্দেশাবলী, একটি উদাহরণ Book ফিড ট্রান্সক্রিপ্ট, এবং একটি অর্ডার বুকের একটি বৈধ স্থানীয় কপি বজায় রাখার জন্য উদাহরণ কোড (Python-এ) সরবরাহ করে।

WebSocket API সংযোগের সীমা কি?

WebSocket API অপব্যবহারের বিরুদ্ধে সুরক্ষা প্রদানের জন্য (উদাহরণস্বরূপ, DDoS আক্রমণ) একযোগে সংযোগের সর্বোচ্চ সংখ্যা সীমিত করে। যদি আপনার WebSocket ক্লায়েন্ট একই সময়ে খুব বেশি সংযোগ করে, তাহলে নিম্নলিখিত ত্রুটি বার্তাটি পাওয়া যাবে:

{“error”: {“message”: “You have reached maximum capacity for WebSocket connections. Please reach out to Kraken support team for any questions.“, “hint”: “Your code may be reconnecting too often or when it has no need to.“, “name”: “WebSocket connection rate error”}}

WebSocket API একটি একক WebSocket সংযোগের মাধ্যমে একাধিক ফিড সাবস্ক্রিপশন অনুমোদন করে (যেমন একটি একক সংযোগের মাধ্যমে XBT/USD কারেন্সি পেয়ারের জন্য উপলব্ধ সমস্ত মার্কেট ডেটাতে সাবস্ক্রাইব করা), তাই WebSocket সংযোগের সীমা না ছুঁয়ে সমস্ত কারেন্সি পেয়ারের জন্য উপলব্ধ সমস্ত মার্কেট ডেটা স্ট্রিম করা সম্ভব।

WebSocket API রেট সীমা কি?

একই ট্রেডিং রেট সীমা সমস্ত অর্ডার এন্ট্রি ইন্টারফেস জুড়ে প্রযোজ্য (ওয়েবসাইট, Kraken Terminal, REST এবং WebSocket API), এবং আমাদের রেট সীমা সহায়তা পৃষ্ঠায় বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

একটি একক WebSocket API সংযোগের বার্তা রেট সীমা সিস্টেমের লোডের উপর নির্ভর করে পরিবর্তিত হবে। বার্তা রেট সীমা অতিক্রম করা হলে WebSocket API ক্লায়েন্টরা {"Error": "Exceeded msg rate"} ত্রুটি বার্তাটি পাবে।

WebSocket API-এর মাধ্যমে ট্রেডিং (অর্ডার স্থাপন/বাতিল করা)।

WebSocket API-এর মাধ্যমে ট্রেডিং addOrder এবং cancelOrder এন্ডপয়েন্টের মাধ্যমে উপলব্ধ, যা যথাক্রমে নতুন অর্ডার স্থাপন এবং বিদ্যমান (খোলা) অর্ডার বাতিল করতে ব্যবহৃত হয়।

WebSocket ট্রেডিং এন্ডপয়েন্টগুলি প্রাইভেট অ্যাকাউন্ট ম্যানেজমেন্ট ফিডগুলির (openOrders এবং ownTrades) মতোই একই প্রাইভেট WebSocket সংযোগ (wss://ws-auth.kraken.com/) এর মাধ্যমে উপলব্ধ।

ট্রেডিং এন্ডপয়েন্ট সম্পর্কিত সম্পূর্ণ বিবরণ WebSocket API ডকুমেন্টেশনে উপলব্ধ, এবং আমাদের WebSocket API সহায়তা পৃষ্ঠাগুলি আপনার নিজস্ব কোডে ট্রেডিং এন্ডপয়েন্টগুলি ব্যবহার করার জন্য আরও তথ্য এবং উদাহরণ সরবরাহ করে।

WebSocket API-এর সাথে সংযোগ করার সময় আমি কেন একটি 403 ত্রুটি পাই?

WebSocket API সংযোগগুলি Cloudflare-এর মাধ্যমে মধ্যস্থতা করা হয়, তাই Cloudflare দ্বারা বাস্তবায়িত যেকোনো নিরাপত্তা সেটিংস পাবলিক (wss://ws.kraken.com) এবং প্রাইভেট (wss://ws-auth.kraken.com) উভয় URL-এর সংযোগকে প্রভাবিত করতে পারে।

Cloudflare-এর প্রয়োজন যে সমস্ত TLS সংযোগের জন্য Server Name Indication (SNI) ব্যবহার করা হয়, অন্যথায় WebSocket সংযোগ ব্যর্থ হবে এবং পরিবর্তে একটি HTTP 403 Forbidden ত্রুটি ফেরত দেওয়া হবে। Cloudflare-এর সহায়তা পৃষ্ঠাগুলি তাদের TLS SNI প্রয়োজনীয়তা সম্পর্কে আরও বিস্তারিত তথ্য সরবরাহ করে।

আমাদের অফিসিয়াল Python WebSocket API লাইব্রেরি TLS SNI সমর্থন করার জন্য আপডেট করা হয়েছে, তবে কিছু তৃতীয় পক্ষের WebSocket API লাইব্রেরি এখনও প্রভাবিত হতে পারে। TLS SNI সমর্থন করার জন্য আপনার WebSocket API কোড আপডেট করার জন্য আপনার কোনো সহায়তার প্রয়োজন হলে অনুগ্রহ করে আমাদের API সহায়তা দলের সাথে যোগাযোগ করুন।

WebSocket API সহায়তা।

আপনার WebSocket API ক্লায়েন্ট বাস্তবায়নে কোনো সহায়তার প্রয়োজন হলে অনুগ্রহ করে আমাদের API সহায়তা দলের সাথে যোগাযোগ করুন।