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://ru.thecrypto.expert

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

Формат ответа

Успех

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://ru.thecrypto.expert/user-api-get-info' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru'
POST /user-api-get-orders

История заявок

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

Опциональные фильтры

id token status exchange_id send_currency_id receive_currency_id
Пример 
curl -X POST 'https://ru.thecrypto.expert/user-api-get-orders' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru' \
  --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://ru.thecrypto.expert/user-api-get-referral-orders' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru'
POST /user-api-get-details

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

Сохранённые платёжные реквизиты пользователя.

Опциональные фильтры

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

Сохранить реквизиты

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

Параметры

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

Удалить реквизиты

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

Параметры

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

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

Возвращает объект заявки на верификацию.

Пример 
curl -X POST 'https://ru.thecrypto.expert/user-api-get-verification' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru'
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://ru.thecrypto.expert/user-api-submit-verification' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru'
POST /user-api-spend-balance

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

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

Параметры

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

Смена пароля

Сменить пароль аккаунта.

Параметры

Name Description
password Текущий пароль · обязательный
new_password Новый пароль · обязательный
two_factor_authentication_password Пароль 2FA (если включена) · опционально
Пример 
curl -X POST 'https://ru.thecrypto.expert/user-api-change-password' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru'
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://ru.thecrypto.expert/user-api-setup-two-factor-authentication' \
  --header 'X-Authorization: {{API_KEY}}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'language=ru'
POST /user-api-get-inputs

Сохранённые поля обмена

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

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

Полезные публичные методы

Без ключа (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://ru.thecrypto.expert/public-api-get-currencies?language=ru'