ক্র্যাকেন প্রো-তে একটি API কী কীভাবে তৈরি করবেন

সর্বশেষ আপডেট: ৩১ মার্চ, ২০২৫

API কীগুলি API প্রমাণীকরণের অন্যতম প্রধান উপাদান; এগুলি আপনার ক্র্যাকেন অ্যাকাউন্টের ব্যবহারকারীর নাম এবং পাসওয়ার্ডের API সমতুল্য।

অ্যাকাউন্ট-নির্দিষ্ট (ওরফে ব্যক্তিগত) API এন্ডপয়েন্টগুলি কল করার জন্য API কীগুলির প্রয়োজন হয়, যেমন অ্যাকাউন্ট ম্যানেজমেন্টট্রেডিং, ফান্ডিং, এবং আর্ন এন্ডপয়েন্ট। মার্কেট ডেটা (ওরফে পাবলিক) API এন্ডপয়েন্টগুলি কল করার জন্য API কীগুলির প্রয়োজন হয় না, কারণ মার্কেট ডেটা এন্ডপয়েন্টগুলি কোনো নির্দিষ্ট ক্র্যাকেন অ্যাকাউন্টের সাথে যুক্ত নয়।

API কীগুলি আমাদের বাজার এবং অ্যাকাউন্টগুলির সাথে ইন্টারঅ্যাক্ট করে এমন যেকোনো সফ্টওয়্যার দ্বারা ব্যবহার করা যেতে পারে, যেমন আমাদের REST API কমান্ড লাইন ক্লায়েন্ট, কিছু মোবাইল অ্যাপ, তৃতীয় পক্ষের ট্রেডিং বট, এবং অন্যান্য অনেক পণ্য/পরিষেবা।

একটি API কী তৈরি করা

Settings

  • API ট্যাবে যান, তারপর "API কী তৈরি করুন" এ ক্লিক করুন (আপনি পরবর্তী ধাপগুলিতে আপনার API কী কনফিগার করতে পারবেন)

Create API Key

একটি API কী কনফিগার করা

API কীগুলির বেশ কয়েকটি সেটিংস এবং বিকল্প রয়েছে যা API কী ব্যবহার করার আগে কনফিগার করতে হবে, বিশেষ করে নাম/বর্ণনা এবং অ্যাক্সেস অনুমতি।

Form

কী-এর নাম

কী নামটি মূলত API কী-এর নাম, এবং এটি আপনার পছন্দের প্রায় যেকোনো কিছু হতে পারে, যতক্ষণ না বর্ণনাটি অনন্য হয় (একই অ্যাকাউন্টের অন্য কোনো API কী-এর বর্ণনা থেকে ভিন্ন)।

সংবেদনশীল তথ্য প্রকাশ না করে আপনার API কী-কে একটি বর্ণনামূলক নাম দেওয়া সর্বোত্তম অনুশীলন। (যেমন "ট্রেডিং কী", "অ্যাকাউন্ট ম্যানেজমেন্ট কী", "পাইথন API কী 6", অথবা "মোবাইল অ্যাপ কী", উদাহরণস্বরূপ)।

কী-এর অনুমতি

কী-এর অনুমতিগুলি নির্ধারণ করে যে API কী কোন অ্যাকাউন্ট-নির্দিষ্ট (ব্যক্তিগত) API এন্ডপয়েন্টগুলি কল করার অনুমতিপ্রাপ্ত:

তহবিল

  • অ্যাকাউন্ট ব্যালেন্সের তথ্য জিজ্ঞাসা করে এমন API এন্ডপয়েন্টগুলির জন্য তহবিল জিজ্ঞাসা করুন প্রয়োজন, যেমন ব্যালেন্স এবং ট্রেডব্যালেন্স

  • ডিপোজিট সম্পর্কিত ফান্ডিং এন্ডপয়েন্টগুলির জন্য তহবিল জমা দিন প্রয়োজন, যেমন ডিপোজিটমেথডস এবং ডিপোজিটঅ্যাড্রেসেস

  • উত্তোলন সম্পর্কিত ফান্ডিং এন্ডপয়েন্টগুলির জন্য তহবিল উত্তোলন করুন প্রয়োজন, যেমন উইথড্রইনফো, উইথড্র এবং উইথড্রক্যানসেল

অর্ডার এবং ট্রেড

  • ইতিমধ্যে বিদ্যমান অর্ডার এবং মার্জিন পজিশন জিজ্ঞাসা করে এমন API এন্ডপয়েন্টগুলির জন্য খোলা অর্ডার এবং ট্রেড জিজ্ঞাসা করুন প্রয়োজন, যেমন ওপেনঅর্ডারস, কোয়েরিঅর্ডারস এবং ওপেনপজিশনস

  • বন্ধ অর্ডার এবং ট্রেড কোয়েরি করুন (Query Closed Orders & Trades) এমন এন্ডপয়েন্টগুলির জন্য প্রয়োজন যা পূর্বে বন্ধ/বাতিল করা অর্ডার এবং মার্জিন পজিশনগুলি কোয়েরি করে, যেমন ClosedOrders, QueryOrders এবং QueryTrades

  • অর্ডার পরিবর্তন করুন (Modify Orders) ট্রেডিং এন্ডপয়েন্টগুলির জন্য প্রয়োজন যা নতুন অর্ডার স্থাপন করে, যেমন AddOrder, EditOrder এবং AddOrderBatch

  • অর্ডার বাতিল/বন্ধ করুন (Cancel/Close Orders) ট্রেডিং এন্ডপয়েন্টগুলির জন্য প্রয়োজন যা খোলা বা মুলতুবি থাকা অর্ডার বাতিল করে, যেমন CancelOrder, CancelAll এবং CancelOrderBatch

ডেটা

  • লেজার এন্ট্রি কোয়েরি করুন (Query Ledger Entries) API এন্ডপয়েন্টগুলির জন্য প্রয়োজন যা অ্যাকাউন্ট লেজার থেকে ঐতিহাসিক অ্যাকাউন্টের ডেটা পুনরুদ্ধার করে, যেমন Ledgers এবং QueryLedgers

  • ডেটা এক্সপোর্ট করুন (Export Data) এমন এন্ডপয়েন্টগুলির জন্য প্রয়োজন যা অ্যাকাউন্ট লেজার এক্সপোর্ট (ডাউনলোড) করে, যেমন AddExport, RetrieveExport, ExportStatus এবং RemoveExport

API কী অনুমতিগুলি সঠিকভাবে ব্যবহার করার একটি উদাহরণ হিসাবে, ট্রেডিং উদ্দেশ্যে তৃতীয় পক্ষকে সরবরাহ করা একটি API কী বিবেচনা করুন। এই ধরনের একটি API কী-এর জন্য অবশ্যই অর্ডার পরিবর্তন করুন (Modify Orders) এবং অর্ডার বাতিল/বন্ধ করুন (Cancel/Close Orders) অনুমতিগুলির প্রয়োজন হবে, সম্ভবত খোলা অর্ডার এবং ট্রেড কোয়েরি করুন (Query Open Orders & Trades) অনুমতির প্রয়োজন হবে, তবে প্রায় নিশ্চিতভাবে তহবিল উত্তোলন করুন (Withdraw Funds) অনুমতির প্রয়োজন হবে না।

অনুমতিগুলি যথাযথভাবে কনফিগার করলে API ক্লায়েন্টকে অ্যাকাউন্টের জন্য ট্রেড করার অনুমতি দেবে, তবে API ক্লায়েন্টকে কোনও অ্যাকাউন্টের তথ্য অ্যাক্সেস করতে বা তহবিল সংক্রান্ত কাজগুলি সম্পাদন করতে বাধা দেবে।

ঐচ্ছিক সেটিংস

বাকি API কী সেটিংসগুলি শুধুমাত্র আরও উন্নত কনফিগারেশনের জন্য প্রয়োজন, তাই সেগুলিকে সাধারণত তাদের ডিফল্ট মানগুলিতে রাখা যেতে পারে:

  • WebSocket API-এর জন্য একটি প্রমাণীকরণ টোকেন পুনরুদ্ধার করতে GetWebSocketsToken এন্ডপয়েন্টের মাধ্যমে WebSocket ইন্টারফেস প্রয়োজন।

  • IP অ্যাড্রেস সীমাবদ্ধতা (IP Address Restriction) একটি নিরাপত্তা বৈশিষ্ট্য যা নির্দিষ্ট ক্লায়েন্ট সাইড IP অ্যাড্রেসগুলিতে API কী ব্যবহার সীমাবদ্ধ করে।

  • কী মেয়াদোত্তীর্ণ (Key Expiration) একটি API কী তৈরি করতে ব্যবহার করা যেতে পারে যা শুধুমাত্র একটি নির্দিষ্ট সময়ের জন্য কাজ করে, যেমন একটি কী যা শুধুমাত্র 1 সপ্তাহের জন্য বৈধ।

  • কোয়েরি শুরু/শেষ তারিখ/সময় (Query Start/End Date/Time) একটি সেটিং যা ঐতিহাসিক অ্যাকাউন্টের ডেটা অনুরোধগুলিকে একটি নির্দিষ্ট সময়সীমার মধ্যে সীমাবদ্ধ করে, যেমন একটি কী যা এই বছরের ট্রেডিং ইতিহাস পুনরুদ্ধার করতে পারে, কিন্তু পূর্ববর্তী কোনও বছরের নয়।

  • কাস্টম ননস উইন্ডো (Custom Nonce Window) একটি সেটিং যা নেটওয়ার্কিং সমস্যাগুলি কাটিয়ে উঠতে ব্যবহৃত হয় যা API অনুরোধগুলিকে ভুল ক্রমে পৌঁছাতে পারে, একটি সংক্ষিপ্ত সময়সীমা (1 সেকেন্ড, 10 সেকেন্ড, ইত্যাদি) প্রদান করে যার সময় একটি অবৈধ ননস সহ API অনুরোধগুলি (পূর্বে ব্যবহৃত ননস মানের চেয়ে কম একটি ননস মান) একটি অবৈধ ননস ত্রুটির কারণ হবে না।

একবার API কী সেটিংসগুলি যথাযথভাবে কনফিগার করা হলে, কী তৈরি করুন (Generate key) বোতামে ক্লিক করে নতুন API কী তৈরি করা যেতে পারে।

একটি API কী ব্যবহার করা

API কীগুলি একটি পাবলিক এবং ব্যক্তিগত কী জোড়া নিয়ে গঠিত, যার উভয়ই API ক্লায়েন্ট সফ্টওয়্যারে সরবরাহ করতে হবে।

Added key

API কীগুলি বিভিন্ন উপায়ে সরবরাহ করা যেতে পারে, উদাহরণস্বরূপ:

  • কী জোড়া সরাসরি API ক্লায়েন্ট কোডে প্লেইন টেক্সট হিসাবে কপি এবং পেস্ট করা যেতে পারে। উদাহরণ: আমাদের PHP API ক্লায়েন্ট দ্বারা ব্যবহৃত পদ্ধতি।

  • কী জোড়া প্লেইন টেক্সট ফাইলগুলিতে কপি এবং পেস্ট করা যেতে পারে যা API ক্লায়েন্ট অ্যাক্সেস করতে পারে। উদাহরণ: আমাদের কমান্ড লাইন API ক্লায়েন্ট দ্বারা ব্যবহৃত পদ্ধতি।

দ্রষ্টব্য: প্রাইভেট কী কিছু API ক্লায়েন্ট সফ্টওয়্যার দ্বারা API সিক্রেট (বা শুধু সিক্রেট) হিসাবেও পরিচিত।

API কী-এর জন্য 2FA

API কীগুলি ক্র্যাকেন অ্যাকাউন্টে API অ্যাক্সেস প্রমাণীকরণের একটি সুরক্ষিত উপায় প্রদান করে, তবে দ্বি-স্তরীয় প্রমাণীকরণ (2FA) যোগ করে তাদের নিরাপত্তা আরও বাড়ানো যেতে পারে।

API কী 2FA একটি বিদ্যমান API কী-তে নিরাপত্তা পৃষ্ঠার মাধ্যমে যোগ করা যেতে পারে এবং এটি একটি স্ট্যাটিক পাসওয়ার্ড বা Google Authenticator ব্যবহার করতে পারে।

দ্রষ্টব্য: একটি API কী-তে 2FA যোগ করার জন্য API ক্লায়েন্টেরও 2FA সমর্থন করা প্রয়োজন (প্রাইভেট API পদ্ধতিগুলিতে প্রতিটি কলের জন্য 2FA ডেটা প্রদান করে), অন্যথায় কাঙ্ক্ষিত API আউটপুটের পরিবর্তে একটি অপ্রত্যাশিত ত্রুটি ফিরে আসবে।

API কীগুলির জন্য 2FA কীভাবে কাজ করে সে সম্পর্কে আরও পড়ুন এখানে

আরও সাহায্যের প্রয়োজন?