Application Programming Interface (API) — це спосіб взаємодії різних сервісів (у цьому випадку бірж і податкових служб).
Іноді сервіси можуть вільно обмінюватися даними, використовуючи загальнодоступну інформацію через API. Однак, коли справа доходить до запиту інформації, необхідної для податків (такої як баланс вашого рахунку, історія торгівлі тощо), все стає складніше, оскільки ця інформація захищена вашим іменем користувача/паролем/2FA (якими ви ніколи не повинні ні з ким ділитися).
Використання API для підключення вашої податкової платформи до вашого облікового запису Kraken — це ефективний спосіб надати доступ до даних вашого облікового запису без обміну вашою інформацією для входу.
Щоб підключити вашу податкову платформу до вашого облікового запису Kraken, вам потрібно надати податковій платформі доступ до інформації вашого облікового запису за допомогою API key.
Ви не хочете, щоб будь-які треті сторони знали ваше ім'я користувача/пароль/2FA, а також не хочете, щоб вони торгували або виводили кошти з вашого облікового запису, тому замість цього використовується API key з відповідними дозволами.
Дозволи, які ви надаєте API key, встановлюють межі того, що інша платформа може бачити та робити у вашому обліковому записі.
Загалом, дозволи, необхідні для податкового програмного забезпечення для розрахунку ваших прибутків/збитків від капіталу, є такими:
Query funds, Query closed orders & trades (необов'язково для деяких бірж), Query ledger entries та Export data.
Вони відомі як дозволи read only, що означає, що вони дозволяють іншій платформі бачити кошти на вашому рахунку, а також транзакції в історії вашого рахунку, але не дозволяють їм вносити будь-які зміни до вашого облікового запису (без нових угод та без нових транзакцій поповнення).
Давайте подивимося, як це виглядає на Kraken PRO:
Щоб дізнатися, як створити API на Kraken, дивіться нижче.
Funds:
Query: це дозволяє API key переглядати баланс рахунку та записи про поповнення (історичні депозити та виведення коштів) на рахунку.
Orders and trades:
Query closed orders & trades: це дозволяє API key бачити закриті ордери та угоди на рахунку (це використовується для визначення прибутку/збитку).
Data:
Query Ledger Entries: це дозволяє API key переглядати бухгалтерську книгу рахунку, яка є записом усіх минулих торгових/фінансових транзакцій.
Export Data: це дозволяє API key експортувати всі вищезгадані дані, включаючи історію ваших торгів та бухгалтерської книги рахунку (зазвичай у форматі CSV).
Для отримання додаткової інформації про те, як підключити ваш обліковий запис Kraken до Koinly, відвідайте:
Почніть з вибору країни вашого проживання
Далі натисніть «Додати гаманець» і виберіть Kraken
Щоб використовувати метод API 'Automatic Sync', введіть ваш Public і Private Key, отримані з Kraken.com, і натисніть «Add Kraken».
Щоб вручну завантажити файл CSV, переформатуйте дані за допомогою CoinTracker CSV guide та завантажте їх у CoinTracker CSV template.
Після цього перетягніть заповнений CoinTracker CSV template у призначену область завантаження.
Якщо вам потрібна додаткова допомога, ознайомтеся з покроковим посібником CoinTracker нижче.
На головній сторінці встановіть основні налаштування
Натисніть «Наступний крок», а потім «Показати більше опцій»
Виберіть Kraken зі списку гаманців/бірж
Будь ласка, скопіюйте та вставте ваші Public та Private ключі Kraken у поля API Key та Secret Key Fields і натисніть "Connect Exchange"
На головній сторінці виберіть 'Enter Coins' та знайдіть і виберіть Kraken (не плутати з Kraken Futures)
Прокрутіть до 'Create a new automatic Kraken Job' та вставте API Key, а також ваш API Private Key (secret), потім натисніть 'Save This Kraken Job'
Щоб вручну завантажити файл CSV, натисніть на вкладку 'CSV import tab', потім перетягніть файл CSV та натисніть 'Continue to Import'.
Нарешті, будь ласка, натисніть 'Start Import'
Якщо вам потрібна додаткова допомога, ознайомтеся з покроковим посібником CoinTracking нижче:
На сторінці панелі інструментів виберіть кнопку «+ Integration» у верхньому правому куті:
Далі виберіть Kraken, коли буде запропоновано вибрати гаманець.
Він помітно відображається в розділі «Найпопулярніші інтеграції».
Далі виберіть Kraken (для Spot API Data) або Kraken Futures (для Futures Data).
*Зверніть увагу, що API Keys Kraken Futures є окремими та відмінними від Kraken SPOT API Keys і не можуть використовуватися взаємозамінно*
Будь ласка, скопіюйте ваш API Key та ваш API Private Key з вашого облікового запису Kraken та вставте їх у відповідні поля на вебсайті Blockpit і натисніть «Continue».
Після натискання 'Continue' розпочнеться процес синхронізації балансів вашого рахунку та історії транзакцій. Це може зайняти кілька секунд або хвилин залежно від довжини історії вашого рахунку.
Ваші баланси Kraken (та Kraken Futures) будуть відображені в розділі «Integrations» на «Dashboard», де ви можете синхронізувати дані в будь-який час або автоматично синхронізувати їх кожні 24 години за наявності активної ліцензії Blockpit.
Якщо вам потрібна додаткова допомога, ознайомтеся з покроковим посібником Blockpit нижче.
Я отримую помилку «Недійсний ключ» під час додавання свого Public і Private Key до стороннього програмного забезпечення.
Якщо ви зіткнулися з цією помилкою, спочатку переконайтеся, що ви правильно копіюєте приватний і публічний ключі. Якщо ви робите це і все одно отримуєте помилку «Недійсний ключ», будь ласка, створіть новий ключ з правильними дозволами та спробуйте додати його знову.
Мої Earn/Staked баланси не відображаються.
Деяке стороннє податкове програмне забезпечення не може коректно імпортувати наші баланси стейкінгових активів через API. Це зазвичай можна виправити, експортувавши історію вашого облікового запису та завантаживши її на сторонній сайт вручну. Щоб дізнатися, як вручну експортувати історію вашого облікового запису, натисніть нижче.
Деякі мої транзакції відсутні.
Функції миттєвої купівлі/продажу (instant buy/sell) не записуються в історію торгів облікового запису, однак їх можна побачити в Ledger облікового запису. Деякі сторонні платформи не можуть правильно інтерпретувати записи купівлі/продажу в Ledger облікового запису. Якщо це так, будь ласка, вручну експортуйте історію свого облікового запису та завантажте файл на сторонню платформу, яку ви використовуєте.
Я вручну завантажив історію свого облікового запису, але не розумію, що означають символи.
Ваша повна історія облікового запису складається з двох частин, а саме: Ledger та Trades. Спочатку давайте дізнаємося трохи про відмінності між ними.
Тепер, коли ми добре розуміємо відмінності між Ledger облікового запису та історією Trades, давайте розглянемо, як інтерпретувати кожен з них.
Чи безпечно надавати мої API ключі сторонньому програмному забезпеченню?
Поки сторонній сайт/додаток вимагає ваші приватні API ключі Kraken, можуть виникати потенційні проблеми безпеки, але якщо ви створите спеціальний API ключ з мінімальними дозволами, наприклад, лише для читання вашого балансу та/або Ledger, ризику для ваших коштів або безпеки загалом немає. З цієї причини рекомендується надавати дозволи лише для читання та створювати спеціальний API ключ із зазначеними дозволами для обміну з вашим довіреним стороннім програмним забезпеченням.
Відмова від відповідальності: Kraken не надає податкових консультацій. Залежно від нормативно-правової бази вашої країни, вам, можливо, доведеться сплачувати податки на приріст капіталу від торгівлі цифровими активами або на вартість вашого портфеля цифрових активів. Вам також може довестися сплачувати податки на інший дохід, який ви отримуєте, наприклад, від винагород або надання в позику вашої криптовалюти. Нормативно-правова база оподаткування криптовалют відрізняється в різних країнах. США не видавали конкретних вказівок щодо оподаткування винагород для податкових резидентів США. Ми настійно радимо вам звернутися до особистого податкового консультанта для отримання додаткової інформації щодо ваших особистих податкових обставин.