ট্যাক্সের জন্য আমাদের API কিভাবে ব্যবহার করবেন

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

একটি Application Programming Interface হল বিভিন্ন পরিষেবা (এই ক্ষেত্রে এক্সচেঞ্জ এবং ট্যাক্স পরিষেবা) একে অপরের সাথে ইন্টারঅ্যাক্ট করার একটি উপায়।

কখনও কখনও পরিষেবাগুলি API এর মাধ্যমে সর্বজনীনভাবে উপলব্ধ ডেটা ব্যবহার করে অবাধে যোগাযোগ করতে পারে, তবে, যখন ট্যাক্সের জন্য প্রয়োজনীয় তথ্য (যেমন আপনার অ্যাকাউন্টের ব্যালেন্স, ট্রেডিং ইতিহাস ইত্যাদি) জিজ্ঞাসা করার কথা আসে, তখন বিষয়গুলি আরও জটিল হয়ে ওঠে, কারণ এই তথ্য আপনার ইউজারনেম/পাসওয়ার্ড/2FA দ্বারা সুরক্ষিত (যা আপনার কারো সাথে শেয়ার করা উচিত নয়)।

আপনার ট্যাক্স প্ল্যাটফর্মকে আপনার Kraken অ্যাকাউন্টের সাথে সংযুক্ত করতে API ব্যবহার করা হল আপনার লগইন তথ্য শেয়ার না করেই আপনার অ্যাকাউন্টের ডেটাতে অ্যাক্সেস দেওয়ার একটি কার্যকর উপায়।

আপনার ট্যাক্স প্ল্যাটফর্মকে আপনার Kraken অ্যাকাউন্টের সাথে সংযুক্ত করতে, আপনাকে একটি API কী এর মাধ্যমে ট্যাক্স প্ল্যাটফর্মকে আপনার অ্যাকাউন্টের তথ্যে অ্যাক্সেস দিতে হবে।

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

আপনি API কী-কে যে অনুমতিগুলি দেবেন তা অন্য প্ল্যাটফর্ম আপনার অ্যাকাউন্টে কী দেখতে এবং করতে পারবে তার সীমা নির্ধারণ করবে।

সাধারণত, একটি ট্যাক্স সফটওয়্যারের আপনার মূলধন লাভ/ক্ষতি গণনা করার জন্য নিম্নলিখিত অনুমতিগুলির প্রয়োজন হয়:

Query funds, Query closed orders & trades (কিছু এক্সচেঞ্জের জন্য ঐচ্ছিক), Query ledger entries, এবং Export data.

এগুলি read only অনুমতি হিসাবে পরিচিত, যার অর্থ তারা অন্য প্ল্যাটফর্মকে আপনার অ্যাকাউন্টে তহবিল এবং আপনার অ্যাকাউন্টের ইতিহাসে লেনদেন দেখতে দেয়, তবে তাদের আপনার অ্যাকাউন্টে কোনো পরিবর্তন করার অনুমতি দেয় না (কোনো নতুন ট্রেড নয় এবং কোনো নতুন তহবিল লেনদেন নয়)।

Kraken PRO-তে এটি কেমন দেখায় তা দেখা যাক:

Kraken PRO

Kraken-এ একটি API কীভাবে তৈরি করবেন তা জানতে অনুগ্রহ করে নিচে দেখুন।

তহবিল:

Query : এটি API কী-কে অ্যাকাউন্টের ব্যালেন্স এবং তহবিল রেকর্ড (ঐতিহাসিক জমা এবং উত্তোলন) দেখতে দেয়।

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

Query closed orders & trades: এটি API কী-কে অ্যাকাউন্টে বন্ধ অর্ডার এবং ট্রেড দেখতে দেয় (এটি লাভ/ক্ষতি নির্ধারণে সহায়তা করতে ব্যবহৃত হয়)।

ডেটা:

Query Ledger Entries: এটি API কী-কে অ্যাকাউন্টের লেজার দেখতে দেয়, যা সমস্ত অতীত ট্রেডিং/তহবিল লেনদেনের একটি রেকর্ড।

Export Data: এটি API কী-কে উপরে উল্লিখিত সমস্ত ডেটা, আপনার ট্রেডিং এবং অ্যাকাউন্টের লেজার ইতিহাস সহ (সাধারণত CSV ফরম্যাটে) এক্সপোর্ট করতে দেয়।

আপনার Kraken অ্যাকাউন্টকে Koinly-এর সাথে কীভাবে সংযুক্ত করবেন সে সম্পর্কে আরও তথ্যের জন্য, ভিজিট করুন:

আপনার বসবাসের দেশ নির্বাচন করে শুরু করুন

1

এরপর Add Wallet-এ ক্লিক করুন এবং Kraken নির্বাচন করুন

2

API 'Automatic Sync' পদ্ধতি ব্যবহার করতে, Kraken.com থেকে প্রাপ্ত আপনার Public এবং Private Key ইনপুট করুন এবং Add Kraken-এ ক্লিক করুন।

3

3

4

আপনার CSV ফাইল ম্যানুয়ালি আপলোড করতে, অনুগ্রহ করে CoinTracker CSV গাইড ব্যবহার করে আপনার ডেটা পুনরায় ফরম্যাট করুন এবং এটি CoinTracker CSV টেমপ্লেটে লোড করুন।

এটি সম্পন্ন হলে, সম্পূর্ণ CoinTracker CSV টেমপ্লেটটি নির্দিষ্ট আপলোড এলাকায় টেনে আনুন এবং ছেড়ে দিন।

5

আপনার যদি আরও সহায়তার প্রয়োজন হয়, তাহলে অনুগ্রহ করে নিচে CoinTracker ধাপে ধাপে নির্দেশিকাটি দেখুন।

মূল পৃষ্ঠা থেকে আপনার মৌলিক সেটিংস সেট করুন

1

পরবর্তী ধাপে ক্লিক করুন, তারপর 'see more option'-এ ক্লিক করুন

2

ওয়ালেট/এক্সচেঞ্জের তালিকা থেকে Kraken নির্বাচন করুন

4

5

অনুগ্রহ করে আপনার Kraken Public এবং Private কীগুলি API Key এবং Secret Key ফিল্ডে কপি ও পেস্ট করুন এবং "Connect Exchange"-এ ক্লিক করুন

4

মূল পৃষ্ঠা থেকে, অনুগ্রহ করে 'Enter Coins' নির্বাচন করুন এবং Kraken অনুসন্ধান করে নির্বাচন করুন (Kraken Futures-এর সাথে বিভ্রান্ত হবেন না)

Select Exchange/Wallet

'Create a new automatic Kraken Job'-এ নিচে স্ক্রোল করুন এবং API Key এর পাশাপাশি আপনার API Private Key (secret) পেস্ট করুন, তারপর 'Save This Kraken Job'-এ ক্লিক করুন।

Input Public/Private Keys

আপনার CSV ফাইল ম্যানুয়ালি আপলোড করতে, 'CSV import tab'-এ ক্লিক করুন, তারপর আপনার CSV ফাইল টেনে আনুন এবং ছেড়ে দিন এবং 'Continue to Import'-এ ক্লিক করুন।

Manually Upload CSV file

সবশেষে, অনুগ্রহ করে 'Start Import'-এ ক্লিক করুন।

Manually upload CSV file

Successfully uploaded CSV file

আপনার যদি আরও সহায়তার প্রয়োজন হয়, তাহলে অনুগ্রহ করে নিচে CoinTracking ধাপে ধাপে নির্দেশিকাটি দেখুন:

Crypto Tax Calculator (CTC)-এ Kraken ডেটা কীভাবে আপলোড করবেন সে সম্পর্কে একটি বিস্তারিত নির্দেশিকার জন্য, আমাদের সহায়তা নিবন্ধটি দেখুন:

ড্যাশবোর্ড পৃষ্ঠা থেকে, উপরের ডানদিকে + Integration বোতামটি নির্বাচন করুন:

Blockpit

এরপর, একটি Wallet নির্বাচন করতে বলা হলে Kraken নির্বাচন করুন।

এটি Most Popular integrations-এর অধীনে দৃশ্যমানভাবে তালিকাভুক্ত।

এরপর অনুগ্রহ করে Kraken (Spot API Data-এর জন্য) অথবা Kraken Futures (Futures Data-এর জন্য) নির্বাচন করুন।

*অনুগ্রহ করে মনে রাখবেন যে Kraken Futures API Keys Kraken SPOT API Keys থেকে আলাদা এবং স্বতন্ত্র এবং একে অপরের পরিবর্তে ব্যবহার করা যাবে না*

Blockpit

Blockpit 3

অনুগ্রহ করে আপনার Kraken অ্যাকাউন্ট থেকে আপনার API Key এবং আপনার API Private Key কপি করুন এবং Blockpit ওয়েবসাইটে সংশ্লিষ্ট ফিল্ডগুলিতে পেস্ট করুন এবং Continue-এ ক্লিক করুন।

Blockpit 3

'Continue'-এ ক্লিক করার পর আপনার অ্যাকাউন্টের ব্যালেন্স এবং লেনদেনের ইতিহাস সিঙ্ক করার প্রক্রিয়া শুরু হবে। আপনার অ্যাকাউন্টের ইতিহাসের দৈর্ঘ্যের উপর নির্ভর করে এটি কয়েক সেকেন্ড বা মিনিট সময় নিতে পারে।

Blockpit 4

আপনার Kraken (এবং Kraken Futures) ব্যালেন্সগুলি Dashboard-এর Integrations-এর অধীনে দেখানো হবে, যেখানে আপনি যেকোনো সময় ডেটা সিঙ্ক্রোনাইজ করতে পারবেন, অথবা একটি সক্রিয় Blockpit লাইসেন্স সহ প্রতি 24 ঘন্টা স্বয়ংক্রিয়ভাবে সিঙ্ক করতে পারবেন।

আপনার যদি আরও সহায়তার প্রয়োজন হয়, তাহলে অনুগ্রহ করে নিচে Blockpit ধাপে ধাপে নির্দেশিকাটি দেখুন।

  • তৃতীয় পক্ষের সফটওয়্যারে আমার Public এবং Private Key যোগ করার সময় আমি একটি Invalid key error পাচ্ছি।

    যদি এই ত্রুটিটি দেখা যায়, প্রথমে নিশ্চিত করুন যে আপনি Private এবং Public Key সঠিকভাবে কপি করছেন। যদি আপনি এটি করার পরেও Invalid key error পান, তাহলে সঠিক অনুমতি (permissions) সহ একটি নতুন Key তৈরি করুন এবং এটি আবার যোগ করার চেষ্টা করুন।

  • আমার Earn/Staked ব্যালেন্স দেখা যাচ্ছে না।

    কিছু তৃতীয় পক্ষের ট্যাক্স সফটওয়্যার API এর মাধ্যমে আমাদের Staked অ্যাসেট ব্যালেন্স সঠিকভাবে ইম্পোর্ট করতে পারে না। এটি সাধারণত আপনার অ্যাকাউন্ট হিস্টরি এক্সপোর্ট করে এবং ম্যানুয়ালি তৃতীয় পক্ষের সাইটে আপলোড করে সমাধান করা যেতে পারে। আপনার অ্যাকাউন্ট হিস্টরি ম্যানুয়ালি কিভাবে এক্সপোর্ট করবেন তা জানতে নিচে ক্লিক করুন।

  • আমার কিছু লেনদেন (transactions) অনুপস্থিত।

    ইনস্ট্যান্ট বাই/সেল ফাংশনগুলি অ্যাকাউন্ট ট্রেড হিস্টরিতে রেকর্ড করা হয় না, তবে সেগুলি অ্যাকাউন্ট Ledger-এ দেখা যায়। কিছু তৃতীয় পক্ষের প্ল্যাটফর্ম অ্যাকাউন্ট Ledger-এর বাই/সেল এন্ট্রিগুলি সঠিকভাবে ব্যাখ্যা করতে পারে না। যদি এমন হয়, তাহলে অনুগ্রহ করে আপনার অ্যাকাউন্ট হিস্টরি ম্যানুয়ালি এক্সপোর্ট করুন এবং আপনি যে তৃতীয় পক্ষের প্ল্যাটফর্ম ব্যবহার করছেন সেখানে ফাইলটি আপলোড করুন।

  • আমি আমার অ্যাকাউন্ট হিস্টরি ম্যানুয়ালি ডাউনলোড করেছি কিন্তু আমি প্রতীকগুলির অর্থ বুঝতে পারছি না।

    আপনার সম্পূর্ণ অ্যাকাউন্ট হিস্টরি দুটি অংশ নিয়ে গঠিত, যথা আপনার Ledger এবং আপনার Trades। প্রথমে আসুন এই দুটির মধ্যে পার্থক্য সম্পর্কে একটু জেনে নিই।

    এখন যেহেতু আমরা আপনার অ্যাকাউন্ট Ledger এবং Trades হিস্টরির মধ্যে পার্থক্য সম্পর্কে ভালোভাবে বুঝতে পেরেছি, আসুন দেখি কিভাবে প্রতিটি ব্যাখ্যা করা যায়।

  • তৃতীয় পক্ষের সফটওয়্যারকে আমার API key দেওয়া কি নিরাপদ?

    যতক্ষণ পর্যন্ত একটি তৃতীয় পক্ষের সাইট/অ্যাপ্লিকেশন আপনার Kraken private API key-এর প্রয়োজন হয়, ততক্ষণ পর্যন্ত সম্ভাব্য নিরাপত্তা সমস্যা থাকতে পারে, তবে যতক্ষণ আপনি ন্যূনতম অনুমতি (permissions) সহ একটি নির্দিষ্ট API key তৈরি করেন, উদাহরণস্বরূপ শুধুমাত্র আপনার ব্যালেন্স এবং/অথবা Ledger পড়ার জন্য, ততক্ষণ আপনার তহবিল বা সাধারণ নিরাপত্তার জন্য কোনো ঝুঁকি নেই। এই কারণে, শুধুমাত্র পড়ার অনুমতি (read only permissions) দেওয়া এবং আপনার বিশ্বস্ত তৃতীয় পক্ষের সফটওয়্যারের সাথে শেয়ার করার জন্য উল্লিখিত অনুমতি সহ একটি নির্দিষ্ট API key তৈরি করা যুক্তিযুক্ত।


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