Как подключить API-ключ OKX и исправить ошибку 50119

Ваш API-ключ OKX может быть действительным и всё равно возвращать «API-ключ не существует». Если ключ EEA обращается к глобальному API вместо инфраструктуры OKX Europe, повторное создание ключа не решит проблему. Я покажу, как подключить API-ключ OKX, выбрать правильный регион аккаунта и разобраться в ошибке до смены учётных данных.

Главное — проверить сочетание учётных данных и региональной конечной точки API. Правильно скопированный ключ, отправленный на неверный региональный хост, может вызвать ошибку ещё до того, как его разрешения будут иметь значение.

Действительный API-ключ OKX может не работать на неверной региональной конечной точке

При неудачном подключении возникает соблазн сгенерировать ещё один ключ, вставить его заново и попробовать расширить разрешения. Такой подход сводит любой сбой аутентификации к проблеме с учётными данными.

Из-за региональной структуры OKX это предположение ненадёжно.

OKX Europe Limited — отдельное юридическое лицо, регулируемое MiCA и лицензированное мальтийским регулятором MFSA. Аккаунты EEA размещены на my.okx.com, и их API-ключи действительны только в инфраструктуре API OKX Europe.

Отправьте полностью действительный ключ EEA на глобальный API www.okx.com, и в ответ может прийти 50119: «API-ключ не существует». Ключ существует, но запрос попал на неверную региональную конечную точку.

У аккаунтов US есть собственный региональный хост — us.okx.com. Их подключениям тоже нужна соответствующая региональная инфраструктура.

Бразильские аккаунты OKX используют глобальную платформу и тот же API, поэтому выбирайте Global. Присутствие на местном рынке не означает автоматически отдельный регион API.

Я начинаю диагностику с этого, потому что смена парольной фразы или расширение разрешений не исправят несоответствие регионов. Запрос должен попасть в инфраструктуру, которая распознаёт ключ.

Как создать API-ключ OKX с нужными разрешениями

Подключению нужен доступ, достаточный для выполнения его задачи. Выдавать дополнительные разрешения, чтобы ошибка исчезла, — плохой способ диагностики.

Для просмотра портфеля используйте Read. Добавляйте Trade, только если собираетесь использовать ботов, которые размещают ордера.

Никогда не включайте Withdrawal для этого подключения.

Пошаговая настройка API-ключа OKX

1. Откройте управление API в своём аккаунте OKX.

Войдите в аккаунт, который хотите подключить, и перейдите в раздел управления API. До создания ключа определите, к какому региону относится аккаунт: Global, EEA или US.

1. Создайте отдельный API-ключ для подключения.

Дайте ему понятное имя, чтобы позже при проверке доступа легко определить его назначение. Отдельный ключ также упрощает изменение или отзыв доступа именно для этого подключения.

1. Задайте парольную фразу API при создании ключа.

Это парольная фраза, которую вы выбираете для API-ключа. Это не пароль вашего аккаунта OKX; при подключении она понадобится вместе с API-ключом и секретным ключом.

1. Включите Read для просмотра портфеля.

Если ваша цель — просматривать информацию о портфеле, начните с доступа Read. Подключению только для просмотра не нужно разрешение на торговлю.

1. Добавьте Trade только для ботов, которым нужно размещать ордера.

Разрешение Trade позволяет совершать торговые операции. Включайте его осознанно для этой цели, а не в качестве эксперимента по устранению ошибки аутентификации.

1. Оставьте Withdrawal отключённым.

Просмотр портфеля и размещение ордеров ботами не требуют разрешения на вывод средств. Не выдавайте его для завершения этой настройки. Помните, что отключение вывода средств не предотвращает торговые убытки: ключ с разрешением Trade по-прежнему может размещать убыточные ордера, поэтому ограничьте объём средств на аккаунте, к которому имеет доступ торговое подключение.

1. Привяжите ключ к IP-адресам подключения, если они доступны.

Используйте IP-адреса, указанные сервисом, который отправляет API-запросы. Поддерживайте эту настройку в соответствии с подключением, которым фактически пользуетесь.

1. Надёжно храните API-ключ, секретный ключ и парольную фразу.

Обращайтесь с ними как с учётными данными. При вводе в форму подключения проверьте, что каждое значение указано полностью и относится к одному и тому же API-ключу.

Создание ключа — лишь часть настройки. Подключение, которому вы передаёте данные, также должно знать, какой региональный хост использовать.

Почему важен белый список IP-адресов

Привязка к IP ограничивает, откуда можно использовать ключ. Она также влияет на срок его существования: OKX может удалять неактивные API-ключи без привязки к IP, поэтому созданный и оставленный без использования ключ может уже не существовать, когда вы к нему вернётесь.

Не считайте ключ активным только потому, что его учётные данные всё ещё сохранены у вас. Проверьте его статус в разделе управления API OKX.

Есть и отдельная проблема настройки, за которой нужно следить: активный ключ может отклонить запрос, если IP-адрес отправителя отсутствует в белом списке. Это вызывает ошибку, связанную с IP, которая должна направить вас к настройкам IP, а не к повторному созданию ключа.

Почему OKX сообщает «API-ключ не существует», когда ключ действителен

Фраза звучит однозначно. Но её диагностический смысл уже, чем кажется.

Для аккаунта EEA ошибка 50119 может означать, что глобальная конечная точка не распознаёт ключ, действительный в инфраструктуре OKX Europe. Если инструкция по подключению вообще не уточняет, к какому юридическому лицу относится ваш аккаунт, она не поможет выявить этот случай.

Региональное разделение задокументировано — это не догадка об учётных данных

В FAQ по API OKX для EEA описаны региональная инфраструктура my.okx.com и действительность ключей только в EEA. Публичные сообщения о проблемах в Freqtrade, CCXT и Hummingbot также подтверждают случаи, когда пользователи EEA получают ответ «API-ключ не существует», потому что их интеграция использует глобальный хост.

Эти сообщения подтверждают необходимость проверки региональной конечной точки. Они не доказывают, что у каждого случая одна и та же причина.

Мой диагностический вывод прост: проверьте регион аккаунта, прежде чем заменять ключ, который OKX по-прежнему показывает как активный. Если коннектор предполагает, что каждый аккаунт использует глобальный API, повторное создание ключей ничего не меняет в этом предположении.

Другие причины ошибки 50119 тоже нужно проверить

Несоответствие регионов — не единственное объяснение. Эта же ошибка может быть связана со следующими причинами:

• Ключ для демоторговли используется в неверной среде. Убедитесь, что учётные данные соответствуют среде, которую ожидает подключение.
• Ключ автоматически удалён. Проверьте, существует ли он ещё в разделе управления API OKX.
• Ключ вставлен не полностью. Убедитесь, что API-ключ введён целиком.
• Ключ действительно неизвестен. Убедитесь, что учётные данные получены из нужного аккаунта.

Я бы проверяла эти варианты последовательно, а не меняла всё одновременно. Если сразу заменить учётные данные, разрешения, среду и регион, успешная повторная попытка почти ничего не скажет о том, что именно было не так.

Полезный вопрос звучит так: распознаёт ли эта конечная точка этот активный ключ для этого аккаунта и этой среды?

Расшифруйте код ошибки OKX перед повторной попыткой

Неудачное подключение — это симптом. Код ошибки OKX — более полезное свидетельство.

Публичный справочник кодов ошибок API OKX различает неизвестный ключ, неверную парольную фразу, недействительную подпись и ограничение по IP. Каждый код указывает на отдельную часть подключения.

Код ошибки	Значение	Что проверить
50119	API-ключ не существует	Регион аккаунта и региональный хост; демосреду и предполагаемую среду; не был ли ключ удалён; полностью ли вставлен ключ
50105	Неверная парольная фраза API	Используйте парольную фразу, заданную при создании этого API-ключа, а не пароль аккаунта
50113	Недействительная подпись	Проверьте секретный ключ API и реализацию подписи запросов в интеграции
50110	IP-адрес запроса отсутствует в белом списке	Проверьте, включён ли IP-адрес отправителя в список разрешённых IP-адресов ключа

Ошибка 50105: проверьте парольную фразу API

Парольная фраза API — отдельный элемент учётных данных. Пароль для входа в OKX, введённый в это поле, её не заменяет.

Также проверьте, что парольная фраза относится к тому же ключу, что и API-ключ с секретным ключом. Если смешать учётные данные из разных попыток создания, можно получить значения, которые по отдельности выглядят правдоподобно, но не соответствуют друг другу.

Ошибка 50113: проверьте подпись запросов

Недействительная подпись указывает на проблему с аутентификационной подписью запроса. Проверьте секретный ключ API, а если вы поддерживаете интеграцию — реализацию подписи.

Если вы используете форму подключения, обратитесь в поддержку коннектора или к его технической документации, чтобы разобраться с подписью запросов. Включение Trade или Withdrawal не исправляет недействительную подпись.

Ошибка 50110: проверьте белый список IP-адресов

Эта ошибка направляет вас к настройке разрешённых IP-адресов. Уточните IP-адрес сервиса, отправляющего запрос, затем сравните его с белым списком ключа.

Слепое повторение того же запроса сохраняет несоответствие. Исправьте нужную настройку перед следующей проверкой.

Как подключить OKX к Anny

В моей форме подключения есть поле «Регион аккаунта» с вариантами Global, EEA и US. Этот выбор обеспечивает проверку ключа на соответствующем региональном хосте.

Процесс подключения:

1. Откройте форму добавления биржи и выберите OKX.

Подготовьте API-ключ, секретный ключ и парольную фразу API.

1. Выберите регион аккаунта.

Выберите EEA для аккаунта OKX Europe, US для аккаунта OKX US или Global для аккаунта на глобальной платформе. Для бразильских аккаунтов выбирайте Global.

1. Введите соответствующие друг другу учётные данные.

Вставьте API-ключ и секретный ключ целиком, затем введите парольную фразу, заданную при создании ключа.

1. Убедитесь, что разрешения соответствуют вашей цели.

Используйте Read для просмотра портфеля. Добавляйте Trade только для ботов и оставьте Withdrawal отключённым.

1. Проверьте подключение.

Если оно не удалось, выберите следующую проверку по полученному коду ошибки. При 50119 вернитесь к проверке региона, прежде чем создавать ещё один ключ.

Подключить OKX к Anny

Выбор региона — требование аутентификации, а не настройка отображения. Он определяет, где проверяются учётные данные.

Как использовать документацию API OKX при диагностике

Если вы подключаетесь через готовую форму, начните с выбора региона и таблицы ошибок. Если вы поддерживаете интеграцию, изучите региональные инструкции вместе с документацией по аутентификации.

Соответствующие разделы документации API OKX отвечают на разные вопросы:

• Региональные инструкции по API: какая инфраструктура должна получать запросы этого аккаунта?
• Инструкции по аутентификации: какие учётные данные нужны и как должны подписываться запросы?
• Справочник кодов ошибок: какая часть отправленного запроса была отклонена?

Даже корректная реализация подписи может отправить запрос на неверный региональный хост. Даже верный региональный хост может отклонить неверную парольную фразу.

Я разделяю эти проверки, потому что они ведут к разным исправлениям. Для успешного подключения должны согласовываться конечная точка, учётные данные, среда, разрешения и настройки IP.

Частые вопросы о подключениях через API OKX

Истекает ли срок действия API-ключа OKX?

Не считайте, что API-ключ остаётся доступным бессрочно. OKX может удалять неактивные ключи без привязки к IP, поэтому проверьте раздел управления API, если ранее сохранённые учётные данные перестали работать.

Привяжите ключ к указанным для подключения IP-адресам, если они доступны, и убедитесь, что ключ всё ещё активен, прежде чем разбираться с парольной фразой или разрешениями.

Почему мой действительный API-ключ OKX сообщает, что не существует?

Действительный ключ может возвращать 50119, если отправлен на неверную региональную конечную точку. В частности, ключ EEA должен использоваться в инфраструктуре OKX Europe; его отправка на глобальный API www.okx.com может привести к ответу «API-ключ не существует».

Также проверьте, нет ли несоответствия демосреды, автоматического удаления ключа или неполной вставки.

Какие разрешения нужны торговому боту OKX?

Используйте Read для просмотра портфеля и добавляйте Trade, когда боту нужно размещать ордера. Никогда не включайте Withdrawal для этого подключения.

Дополнительные разрешения не устраняют несоответствие регионов, неверную парольную фразу, недействительную подпись или ошибку белого списка IP-адресов.

Парольная фраза API OKX — это мой пароль?

Нет. Парольная фраза API задаётся при создании API-ключа и отличается от пароля вашего аккаунта OKX.

Введите парольную фразу, связанную именно с этим ключом.

Какой регион выбрать для бразильского аккаунта OKX?

Выберите Global. OKX Brazil работает на глобальной платформе и использует тот же API.

Нужно ли создавать новый ключ при каждом сбое подключения?

Нет. Сначала прочитайте код ошибки и проверьте настройку, на которую он указывает.

При 50119 проверьте региональный хост, среду, активный статус ключа и полноту вставленного значения. Новый ключ не исправит подключение, которое продолжает отправлять его на неверную региональную конечную точку.

Следующее полезное действие — диагностика, а не очередная одинаковая попытка. Начните с региона, прочитайте код и измените настройку, на которую указывают полученные данные.

Эта статья носит образовательный характер и не является финансовой рекомендацией. Прошлые результаты ≠ будущие результаты. Anny — аналитическая платформа на базе ИИ, а не зарегистрированный инвестиционный консультант.