CryptoExpert User API
RU UK EN
На сайт Кабінет

User API

Програмний доступ до вашого акаунта: заявки, реквізити, верифікація, баланс, реферали, 2FA. Ключ вмикається в кабінеті.

Ваш API-ключ

Ключ зберігається лише в цьому браузері. Увімкніть API в кабінеті, скопіюйте ключ — він підставиться в приклади нижче.

Відкрити кабінет

Швидкий старт

Усі методи User API — POST. Секретний ключ передається в заголовку X-Authorization. Тіло запиту — application/x-www-form-urlencoded.

  • Увійдіть у кабінет → «Налаштування API» і увімкніть API.
  • Скопіюйте ключ (кнопка в кабінеті або поле вище).
  • Викличте будь-який метод нижче — ключ підставиться в приклад curl.
Зберігайте ключ на сервері. Не вшивайте його в публічний фронтенд.

Авторизація та базовий URL

Базовий URL вашого обмінника: https://uk.thecrypto.expert

Параметр Значення
Метод POST
Заголовок X-Authorization: YOUR_API_KEY
Content-Type application/x-www-form-urlencoded
Мова відповіді параметр language (ru / en / uk)
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-info' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'

Формат відповіді

Успіх

JSON 
{
  "success": true,
  "result": ["data"]
}

Помилка

JSON 
{
  "success": false,
  "message": "Optional error message.",
  "result": false
}

Пагінація списків

Для списків доступні page та limit. У відповіді може бути pagination: [усього обʼєктів, поточна позиція].

Статуси заявок

Фільтр status приймає числовий ID або імʼя зі знаком @, наприклад status=@completed.

# Name Description
0 @created Створена
1 @paid Оплачена
2 @suspended Призупинена
3 @canceled Скасована
4 @completed Завершена
POST /user-api-get-info

Інформація про користувача

Повертає обʼєкт користувача. Хеші пароля та токени підтвердження приховані.

Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-info' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-get-orders

Історія заявок

Список ваших заявок на обмін.

Опційні фільтри

id token status exchange_id send_currency_id receive_currency_id
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-orders' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk' \
  --data-urlencode 'status=@completed'
POST /user-api-get-referral-orders

Реферальні заявки

Заявки рефералів. Частина чутливих полів прихована.

Опційні фільтри

id token status exchange_id send_currency_id receive_currency_id
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-referral-orders' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-get-details

Список реквізитів

Збережені платіжні реквізити користувача.

Опційні фільтри

currency_id value
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-details' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-create-details

Зберегти реквізити

currency_id беріть з /public-api-get-currencies.

Параметри

Name Description
currency_id ID валюти · обовʼязковий
value Реквізити · обовʼязковий
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-create-details' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk' \
  --data-urlencode 'currency_id=77' \
  --data-urlencode 'value=TXyz...'
POST /user-api-delete-details

Видалити реквізити

Можна передати кілька ID.

Параметри

Name Description
ids[] ID реквізиту або кілька ID · обовʼязковий
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-delete-details' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk' \
  --data-urlencode 'ids[]=291'
POST /user-api-get-verification

Статус верифікації

Повертає обʼєкт заявки на верифікацію.

Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-verification' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-submit-verification

Подати верифікацію

Для сторонніх сервісів параметри можуть не знадобитися. Для картки — номер, імʼя, прізвище та фото.

Параметри

Name Description
id_type Тип документа · опційно
id_number Номер документа · опційно
card_number Номер картки · опційно
first_name Імʼя · опційно
last_name Прізвище · опційно
middle_name По батькові · опційно
birth_date Дата народження (дд.мм.рррр) · опційно
phone Телефон · опційно
country Країна · опційно
city Місто · опційно
address Адреса · опційно
zip_code Індекс · опційно
photos[] Фото · опційно
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-submit-verification' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-spend-balance

Оплата з балансу

Оплатити заявку обміну з внутрішнього балансу.

Параметри

Name Description
token Токен заявки · обовʼязковий
two_factor_authentication_password Пароль 2FA (якщо увімкнено) · опційно
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-spend-balance' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk' \
  --data-urlencode 'token=ORDER_TOKEN'
POST /user-api-change-password

Зміна пароля

Змінити пароль акаунта.

Параметри

Name Description
password Поточний пароль · обовʼязковий
new_password Новий пароль · обовʼязковий
two_factor_authentication_password Пароль 2FA (якщо увімкнено) · опційно
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-change-password' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-setup-two-factor-authentication

Налаштування 2FA

Секретний ключ генеруєте самі і передаєте лише під час увімкнення.

Параметри

Name Description
two_factor_authentication_token Секретний ключ · опційно
two_factor_authentication_enable 1 — увімкнути, 0 — вимкнути · обовʼязковий
two_factor_authentication_password Пароль 2FA · обовʼязковий
Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-setup-two-factor-authentication' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'
POST /user-api-get-inputs

Збережені поля обміну

Масив: ID поля напрямку → значення.

Приклад 
curl -X POST 'https://uk.thecrypto.expert/user-api-get-inputs' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=uk'

Корисні публічні методи

Без ключа (GET). Потрібні для currency_id і напрямків обміну:

/public-api-get-currencies /public-api-get-exchanges /public-api-get-exchange /public-api-get-status /public-api-get-referral-program
GET 
curl -X GET 'https://uk.thecrypto.expert/public-api-get-currencies?language=uk'