Каталог MCP
Bitget-AI/agent-mcp

Bitget-AI/agent-mcp

Name: Bitget-AI/agent-mcp
Availability: InStock
Author: bitget-ai

MCP сервер для криптотрейдинга на Bitget через ИИ-агентов. Позволяет торговать, управлять балансом, кредитами и налогами на естественном языке в Claude, Cursor, ChatGPT. 14 команд покрывают 89 операций — без лишних инструментов.

Github NPM Сайт сервера

README

17 инструментов

Версии

Установить сервер

bitget-agent-mcp — Official Bitget MCP Trading Server

Connect Claude Desktop, Cursor, Continue, Windsurf & ChatGPT to Bitget via the Model Context Protocol — trade crypto with natural language.

Quick Start · Capabilities · How It Works · Installation · Configuration · Security · Troubleshooting · FAQ

Overview

bitget-agent-mcp is the official Model Context Protocol (MCP) server for Bitget, enabling desktop AI agents like Claude Desktop, Cursor, Continue, Windsurf, and ChatGPT Desktop to operate your Bitget account through natural-language commands.

It is built on the Bitget Unified Trading Account (UTA / v3) API and covers 89 trading operations across market data, spot, futures, account & funds management, sub-accounts, loans, and tax. Crucially, it does not flood your model with one tool per endpoint. Instead it exposes a small, progressively-discoverable intent surface of 14 curated intent verbs (the default profile loads 12 verbs + discover + raw = 14 tools) so AI hosts get full capability without the context bloat and tool-selection errors that plague endpoint-per-tool servers.

Инструменты были проиндексированы: 15.10.2026

account_configвнешний мир

Настраивает параметры аккаунта в зависимости от намерения: устанавливает режим аккаунта (базовый/расширенный), режим удержания позиции (односторонний/хедж) и кредитное плечо; переключает аккаунт и списание комиссии; а также читает oiLimit / paymentCoins / switchStatus / deductInfo. (В v3 нет отдельного переключения режима изолированной/кросс-маржи — см. setLeverage posSide для изолированной маржи.)

Параметры

actionenumобязательный
Что делать: setAccountMode: переключает режим счёта (базовый/продвинутый) (требуется: mode) | setHoldingMode: устанавливает режим позиций (one-way/hedge) (требуется: holdMode) | setLeverage: устанавливает кредитное плечо (требуется: category, leverage) | switchAccount: переключает активный счёт | switchDeduct: переключает списание комиссии (требуется: deduct) | switchStatus: показывает текущий статус переключения счёта | deductInfo: возвращает настройки списания комиссии | oiLimit: возвращает лимит открытого интереса (требуется: symbol, category) | paymentCoins: возвращает монеты, доступные для оплаты комиссии.
categoryenum
Категория продукта, например USDT-FUTURES (leverage/oiLimit).
coinstring
Фильтр Coin, где применимо.
confirmboolean
Требуется для выполнения разрушительных (высокорисковых) операций записи; без него такой вызов возвращает { confirmationRequired: true }.
deductenum
Включено ли оно: вкл, включено, выкл, отключено
dryRunboolean
Предпросмотр записи без отправки.
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
holdModeenum
Режим удержания one_way_mode: этот режим позволяет удерживать позиции только в одном направлении, либо длинные, либо короткие, но не одновременно. hedge_mode: этот режим позволяет удерживать одновременно и длинные, и короткие позиции.
leveragestring
Использует несколько
modeenum
Режим аккаунта базовый Базовый режим продвинутый Продвинутый режим
posSideenum
Сторона позиции (long/short). Это поле обязательно для установки плеча при изолированной марже.
symbolstring
Торговая пара, в которой настройка задаётся для каждого символа отдельно.
targetUidstring
UID целевого аккаунта. Если не указан, по умолчанию используется текущий аккаунт. Если указан UID субаккаунта, это означает, что мастер-аккаунт выполняет операцию над субаккаунтом.
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

account_overviewтолько чтениеидемпотентныйвнешний мир

Выполняет однократный снимок аккаунта: разветвляется на активы, настройки, фондовые активы и (с категорией/символом) позиции и ставку комиссии. Каждая секция сообщает ok/error независимо.

Параметры

categoryenum
Если указано, также получает текущие позиции (и ставку комиссии, когда также указан символ).
coinstring
Необязательный фильтр по монетам для активов финансирования.
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
symbolstring
С категорией также получает ставку комиссии для этого символа.
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

authorize_startтолько чтениеидемпотентныйвнешний мир

[META] Запускает OAuth-поток для субагента Bitget Agentic: поднимает локальный сервер обратного вызова и возвращает authorize_url, который пользователь открывает в браузере, а также sessionId. Возвращает управление сразу - покажите пользователю authorize_url, а затем СРАЗУ ЖЕ вызовите authorize_wait с sessionId в следующем ходу, в том же ответе, если формат вызова инструментов это позволяет. Не ждите, пока пользователь скажет, что закончил, подтвердит или ответит первым - authorize_wait это блокирующий вызов, рассчитанный на то, что он будет ждать завершения шага в браузере, поэтому вызвать его сразу ничего не стоит, а задержка только добавляет время простоя, пока пользователь не увидит финальный результат. Если пользователь пришёл к вам через региональный домен Bitget (например, статью поддержки на "www.bitget.careers" вместо "www.bitget.com"), передайте этот же домен как authorizeBaseUrl, чтобы страница авторизации открылась на домене, до которого пользователь реально может добраться.

Параметры

authorizeBaseUrlstring
Переопределяет базовый URL фронтенд-страницы авторизации OAuth (например, «https://www.bitget.careers», чтобы он совпадал с доменом, доступным пользователю). Также используется как базовый URL для бэкенд-API данных аккаунта. По умолчанию используется встроенная в SDK рабочая конечная точка, если параметр опущен.

authorize_waitвнешний мир

[META] Блокирует выполнение, пока пользователь не завершит шаг в браузере в потоке OAuth, запущенном через authorize_start (передайте sessionId этого потока). В случае успеха трёхчастные учётные данные (api_key/secret/passphrase) записываются в локальный файл учётных данных OAuth, и этот вызов возвращает маскированную сводку учётных данных.

Параметры

sessionIdstringобязательный
sessionId, возвращаемый authorize_start.

depositвнешний мир

[VERB] Депозиты по интенту: address (получить адрес депозита) | records (история депозитов) | setupAccount.

Параметры

accountTypeenum
Тип счета: funding (счет финансирования), unified (единый счет), otc (OTC-счет). По умолчанию используется счет финансирования, и его можно изменить на единый счет или OTC-счет.
actionenumобязательный
Что делать - address: получает адрес депозита (требуется: coin) | records: история депозитов (требуется: startTime, endTime) | setupAccount: настраивает депозитный счёт (требуется: coin, accountType).
chainstring
Сеть/блокчейн для адреса депозита.
coinstring
Монета для пополнения, например USDT.
confirmboolean
Требуется для выполнения разрушительных (высокорисковых) операций записи; без него такой вызов возвращает { confirmationRequired: true }.
cursorstring
Cursor ID - используется для пагинации, чтобы сократить время ответа на запрос - не отправляйте его при первоначальном запросе. При запросе второй страницы и последующих данных используйте наименьший orderId, возвращённый предыдущим запросом. Результаты вернут данные меньше этого значения.
dryRunboolean
Предпросмотр записи без отправки.
endTimestring
Время окончания записи запроса<ul><li>Отметка времени Unix в миллисекундах, например, 1690196141868</li></ul>
fetchAllboolean
Только постраничное чтение: пройти курсор до ограниченного завершения (возвращает { items, pages, truncated }).
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
limitstring
Количество элементов на странице. Значение по умолчанию — 100, максимальное значение — 100.
orderIdstring
Order ID - используется для указания запросов заказов.
sizestring
Сумма депозита - Применимо только к сети BTC Lightning - Диапазон лимита: 0.000001 - 0.01.
startTimestring
Время начала записи запроса<ul><li>Отметка времени Unix в миллисекундах, например, 1690196141868</li></ul>
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

discoverтолько чтениеидемпотентныйвнешний мир

[META] Обнаружение поверхности инструментов. discover({}) перечисляет домены; discover({ domain }) перечисляет инструменты этого домена; discover({ tool }) возвращает полную входную схему одного инструмента для выполнения; discover({ search }) ищет по ключевым словам по всей поверхности.

Параметры

actionstring
С помощью tool разберите точный контракт одного действия: обязательные и необязательные параметры, каждый с типом/перечислением/описанием. Только глаголы, направленные на действия.
domainstring
Перечислите все инструменты в этом домене с однострочными описаниями.
searchstring
Ищет по ключевым словам в поверхностных данных (имена инструментов, действия, fronts, описания); возвращает ранжированные совпадения с инструментом, который нужно открыть следующим.
toolstring
Возвращает полную входную схему и метаданные одного инструмента, готовые к выполнению.

funds_recordsтолько чтениеидемпотентныйвнешний мир

Предоставляет историю средств (только чтение): финансовая книга | записи конвертации | записи переводов main↔sub | transferableCoins.

Параметры

actionenumобязательный
Что делать: financial: финансовый (счет) реестр (требует: category) | convert: история конвертации (требует: fromCoin, toCoin) | subTransfers: записи переводов main↔sub | transferableCoins: монеты, доступные для перевода (требует: fromType, toType).
categoryenum
СПОТ Спотовая торговля МАРЖИНАЛЬНАЯ Маржинальная торговля USDT-ФЬЮЧЕРСЫ USDT-фьючерсы COIN-ФЬЮЧЕРСЫ Coin-M фьючерсы USDC-ФЬЮЧЕРСЫ USDC-фьючерсы ДРУГОЕ Другое
clientOidstring
clientOid, не может превышать 64 символов.
coinstring
Фильтр монет, например USDT.
cursorstring
Пагинация на основе курсора реализуется путем пропуска курсора в первом запросе и применения курсора из предыдущего запроса для последующих страниц.
endTimestring
Конец диапазона (мс от начала эпохи).
fetchAllboolean
Только постраничное чтение: пройти курсор до ограниченного завершения (возвращает { items, pages, truncated }).
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
fromCoinstring
From coin (исходная монета) обозначает монету, которую конвертируют.
fromTypeenum
Тип исходного счета spot Спотовый счет/Счет финансирования p2p P2P-счет/OTC-счет coin_futures Фьючерсный счет Coin-M usdt_futures Фьючерсный счет USDT usdc_futures Фьючерсный счет USDC crossed_margin Кросс-маржинальный счет isolated_margin Изолированный маржинальный счет uta Единый торговый счет
limitstring
Лимит на страницу. По умолчанию: 100. Максимум: 100
roleenum
Тип счёта списания: инициатор. Инициатор перевода: получатель перевода. По умолчанию: инициатор.
startTimestring
Начало диапазона (мс с начала эпохи).
subUidstring
UID субаккаунта. Если не указан, будут получены записи о переводах основного аккаунта.
toCoinstring
Целевая монета (target coin) - это монета, в которую происходит конвертация (получение).
toTypeenum
To (target) account type — Целевой тип аккаунта spot — спот Spot account — Спот-аккаунт Funding account — Аккаунт фондирования p2p — P2P P2P account — P2P-аккаунт OTC account — OTC-аккаунт coin_futures — Coin-M фьючерсы Coin-M futures account — Аккаунт Coin-M фьючерсов usdt_futures — USDT-фьючерсы USDT futures account — Аккаунт USDT-фьючерсов usdc_futures — USDC-фьючерсы USDC futures account — Аккаунт USDC-фьючерсов crossed_margin — кросс-маржа Cross margin account — Аккаунт с кросс-маржой isolated_margin — изолированная маржа Isolated margin account — Аккаунт с изолированной маржой uta — UTA Unified trading account — Единый торговый аккаунт
typeenum
Тип TRANSFER_IN/TRANSFER_OUT...... Все значения перечисления можно просмотреть в категории Enumeration.
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

get_auth_statusтолько чтениеидемпотентныйвнешний мир

[META] Проверяет, существуют ли локальные учётные данные OAuth Bitget Agentic. Не обращается к сети, сообщает только о наличии, а не о валидности. Вызывайте перед любым торговым действием; вызывайте authorize_start, если сообщается об отсутствии авторизации.

Параметры

Без параметров.

marketтолько чтениеидемпотентныйвнешний мир

Получает публичные рыночные данные: тикеры, стакан заявок, свечи, инструменты, ставку финансирования, открытый интерес, недавние сделки и справочные данные (учётные данные не требуются).

Параметры

actionenumобязательный
Что делать — tickers: снимок тикера для категории/символа (требуется: category) | orderbook: глубина книги ордеров (требуется: category, symbol) | candles: недавние klines (требуется: category, symbol, interval) | candlesHistory: исторические klines (требуется: category, symbol, interval) | instruments: метаданные торгуемого инструмента (требуется: category) | fundingRate: текущая ставка финансирования (требуется: symbol) | fundingRateHistory: исторические ставки финансирования (требуется: category, symbol) | openInterest: текущий открытый интерес (требуется: category) | openInterestLimit: лимит открытого интереса (требуется: category) | recentFills: недавние публичные сделки (требуется: category, symbol) | positionTier: уровни позиции/кредитного плеча (требуется: category) | discountRate: ставки дисконтирования залога | indexComponents: компоненты индексной цены (требуется: symbol) | marginLoan: справочные данные по маржинальному кредиту (требуется: coin) | proofOfReserves: подтверждение резервов | riskReserve: резервный фонд риска (требуется: category, symbol)". Проверю: "книга ордеров" - обычно говорят "книга заявок" или "книга ордеров". Оставим "книга ордеров". "публичные сделки" — ок. "уровни позиции/кредитного плеча" — positionTier: уровни позиции и кредитного плеча. Можно "уровни позиции/кредитного плеча". В целом, приемлемо. Ещё нужно учесть, что в правиле есть требование переводить описания инструментов глаголом в 3-м лице? Но здесь не описания инструментов, а перечисление операций с параметрами. Так что подойдет как есть. Проверим на канцелярит: я использую "глубина книги ордеров" - нормально. "недавние klines" - можно "недавние свечи"? Но klines - это термин, оставим как есть. Всё выглядит естественно. Окончательный ответ.Что делать — tickers: снимок тикера для категории/символа (требуется: category) | orderbook: глубина книги ордеров (требуется: category, symbol) | candles: недавние klines (требуется: category, symbol, interval) | candlesHistory: исторические klines (требуется: category, symbol, interval) | instruments: метаданные торгуемого инструмента (требуется: category) | fundingRate: текущая ставка финансирования (требуется: symbol) | fundingRateHistory: исторические ставки финансирования (требуется: category, symbol) | openInterest: текущий открытый интерес (требуется: category) | openInterestLimit: лимит открытого интереса (требуется: category) | recentFills: недавние публичные сделки (требуется: category, symbol) | positionTier: уровни позиции/кредитного плеча (требуется: category) | discountRate: ставки дисконтирования залога | indexComponents: компоненты индексной цены (требуется: symbol) | marginLoan: справочные данные по маржинальному кредиту (требуется: coin) | proofOfReserves: подтверждение резервов | riskReserve: резервный фонд риска (требуется: category, symbol)Что делать — tickers: снимок тикера для категории/символа (требуется: category) | orderbook: глубина книги ордеров (требуется: category, symbol) | candles: недавние klines (требуется: category, symbol, interval) | candlesHistory: исторические klines (требуется: category, symbol, interval) | instruments: метаданные торгуемого инструмента (требуется: category) | fundingRate: текущая ставка финансирования (требуется: symbol) | fundingRateHistory: исторические ставки финансирования (требуется: category, symbol) | openInterest: текущий открытый интерес (требуется: category) | openInterestLimit: лимит открытого интереса (требуется: category) | recentFills: недавние публичные сделки (требуется: category, symbol) | positionTier: уровни позиции/кредитного плеча (требуется: category) | discountRate: ставки дисконтирования залога | indexComponents: компоненты индексной цены (требуется: symbol) | marginLoan: справочные данные по маржинальному кредиту (требуется: coin) | proofOfReserves: подтверждение резервов | riskReserve: резервный фонд риска (требуется: category, symbol).
categoryenum
Категория продукта, например, SPOT или USDT-FUTURES.
coinstring
Фильтр по монетам, где применимо, например USDT.
cursorstring
Номер страницы. По умолчанию: 1. Максимум: 100.
endTimestring
Конец диапазона (эпоха в мс) для свечей/истории.
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
intervalenum
Гранулярность 1m,3m,5m,15m,30m,1H,4H,6H,12H,1D
limitstring
Максимальное количество возвращаемых строк.
marginCoinstring
Маржинальная монета, это требуется, когда категория - COIN-FUTURES.
startTimestring
Начало диапазона (мс с начала эпохи) для свечей/истории.
symbolstring
Торговая пара (например, "BTCUSDT")
typeenum
Тип свечи: маркет, марк, индекс, премиум. По умолчанию: маркет
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

orderвнешний мир

Управляет заказами по намерению: разместить/отменить/изменить (одиночные или пакетные через orders), cancelAll, countdownCancel, плюс чтение открытых/детали/истории/исполнений. Запись учитывает dryRun/confirm/readOnly; cancelAll требует подтверждения.

Параметры

actionenumобязательный
Что сделать: place: размещает заказ (требуется: category, symbol, qty, side, orderType) | cancel: отменяет заказ | modify: изменяет заказ | cancelAll: отменяет все заказы (необратимо) (требуется: category) | countdownCancel: автоотмена через dead-man's-switch (требуется: countdown) | open: показывает открытые заказы | detail: детали одного заказа | history: исторические заказы (требуется: category) | fills: история исполнений | maxOpen: максимальный открываемый размер (требуется: category, symbol, orderType, side). Передайте orders для пакетного выполнения place/cancel/modify.
autoCancelenum
Будет ли исходный заказ отменен, если изменение заказа не удастся? да: Отменить, нет: Не отменять (по умолчанию)
categoryenum
Категория продукта, например, SPOT или USDT-FUTURES.
clientOidstring
Ключ идемпотентности. Автоматически генерируется для одного place, если он не указан (P7).
confirmboolean
Требуется для выполнения cancelAll (деструктивная операция).
countdownstring
Reconnect Window - Unit: seconds - Положительное целое число, диапазон: [5, 60]. Минимальный обратный отсчёт - 5 секунд, максимальный - 60 секунд. Ввод 0 отключает функцию отмены заказа по обратному отсчёту.
cursorstring
Пагинация на основе курсора реализуется путем пропуска курсора в первом запросе и применения курсора из предыдущего запроса для последующих страниц.
dryRunboolean
Предварительно просматривает запись, не отправляя её.
endTimestring
End timestamp: временная метка Unix в миллисекундах, например 1597026383085.
fetchAllboolean
Только history/fills: перемещает курсор до ограниченного завершения (возвращает { items, pages, truncated }).
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
limitstring
Лимит на страницу. По умолчанию: 100. Максимум: 100
orderIdstring
Целевой ID заказа для отмены/изменения/просмотра деталей.
ordersunknown[]
Массив объектов order/cancel/modify. При их наличии place/cancel/modify автоматически направляются на batch endpoint.
orderTypeenum
Лимитный или рыночный.
posSideenum
Сторона позиции long/short. Это поле обязательно в позиции hedge-mode. Доступно только для фьючерсов.
pricestring
Цена ордера (лимитные ордера).
qtystring
Размер/количество заказа (имя поля v3 API).
reduceOnlyenum
Идентификатор reduce-only: да/нет, по умолчанию нет; значение «да» означает, что при активации этого ордера размер вашей позиции может только уменшаться.
sideenum
Купить или продать.
slLimitPricestring
Цена исполнения ордера в стратегии стоп-лосс Это поле применимо только к лимитным ордерам (когда slOrderType=limit); для рыночных ордеров оно игнорируется.
slOrderTypeenum
Стратегия срабатывания стоп-лосса. Тип ордера: limit: лимитный ордер, market: рыночный ордер.
slTriggerByenum
Предустановленный тип триггера стоп-лосса market: рыночная цена, mark: цена маркировки. Если поле не заполнено, по умолчанию используется рыночная цена. Примечание: это поле действительно только для контрактных бизнес-линий: USDT-Futures, COIN-Futures и USDC-Futures.
startTimestring
Начальная временная метка: метка времени Unix в миллисекундах, например, 1597026383085.
stopLossstring
Предустановленная цена срабатывания Stop-Loss.
stpModeenum
STP Mode (Self Trade Prevention) none: не устанавливает STP (по умолчанию) cancel_taker: отменяет ордер тейкера cancel_maker: отменяет ордер мейкера cancel_both: отменяет оба ордера: и тейкера, и мейкера
symbolstring
Торговая пара (например, "BTCUSDT")
takeProfitstring
Предустановленная цена активации тейк-профита
timeInForceenum
Time in force ioc Immediate or cancel. Ордер должен быть исполнен немедленно, неисполненная часть отменяется. fok Fill or kill. Ордер должен быть полностью исполнен немедленно, иначе он отменяется целиком. gtc Good 'til canceled. Остаётся активным, пока не будет исполнен или вручную отменён. post_only Post only. Ордер будет добавлен в стакан заявок только как maker. Это поле обязательно, когда orderType равен limit. Если опущено, по умолчанию используется gtc.
tpLimitPricestring
Take-Profit Strategy Order Execution Price Это поле действительно только для лимитных ордеров (когда tpOrderType=limit); для рыночных ордеров оно игнорируется.
tpOrderTypeenum
Тип ордера для Take-Profit Trigger Strategy: limit - лимитный ордер, market - рыночный ордер.
tpTriggerByenum
Предустановленный тип триггера тейк-профита market: рыночная цена mark: маркировочная цена Если не указано, по умолчанию используется рыночная цена. Примечание: это поле действует только для контрактных продуктовых линеек: USDT-Futures, COIN-Futures и USDC-Futures.
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

positionвнешний мир

[VERB] Позиции по намерению: info (текущие) | history | adlRank | close (ОДНА позиция по символу, по рынку) | closeAll (все позиции в категории). close и closeAll деструктивные операции и требуют подтверждения; чтения нормализованы, а history разбита на страницы.

Параметры

actionenumобязательный
Что делать: info - текущие позиции (нужна категория) | history - исторические позиции (нужна категория) | adlRank - рейтинг ADL | close - закрывает ОДНУ позицию по символу, по рынку (деструктивно) (нужна категория) | closeAll - закрывает ВСЕ позиции в категории, по рынку (деструктивно) (нужна категория).
categoryenum
Категория продукта, например USDT-FUTURES (требуется для info/history).
confirmboolean
Требуется для выполнения close/closeAll (разрушительное закрытие по рынку).
cursorstring
Пагинация на основе курсора реализуется путем пропуска курсора в первом запросе и применения курсора из предыдущего запроса для последующих страниц.
dryRunboolean
Предварительно просматривает close/closeAll, не отправляя его.
endTimestring
Конечная временная метка. Временная метка Unix в миллисекундах, например, 1597026383185. Диапазон времени между startTime и endTime не должен превышать 30 дней.
fetchAllboolean
Только история: перемещает курсор к ограниченному завершению.
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
limitstring
Лимит на страницу. По умолчанию: 100. Максимум: 100
posSideenum
Фильтр по стороне позиции (лонг/шорт).
startTimestring
Начальная метка времени. Метка времени Unix в миллисекундах, например, 1597026383085. Окно доступа составляет 90 дней.
symbolstring
Необязательный фильтр по символу, например BTCUSDT.
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

rawтолько чтениеидемпотентныйвнешний мир

Запасной механизм — вызов любой операции v3 по operationId. Обходит курируемый интерфейс, но использует подпись, ограничение скорости, декодирование ошибок И защитный шлюз: учитывает readOnly, поддерживает предварительный просмотр dryRun, и высокорисковые операции всё ещё требуют подтверждения.

Параметры

argsobject
Плоская запись аргументов передаётся без изменений в callOperation (параметры пути, запрос и/или поля тела).
confirmboolean
Требуется для выполнения операции с высоким риском (разрушительной/необратимой), например: closeAllPositions, cancelAllOrders, вывод средств. Игнорируется для невысокорисковых операций.
dryRunboolean
Предварительно просматривает запрос (метод, путь, тело, которое будет отправлено) без его отправки. Работает даже в readOnly.
operationIdstringобязательный
Каталог operationId для вызова (например, getTickers, placeOrder). Смотрите сгенерированный каталог для допустимых идентификаторов.

repaymentвнешний мир

Погашает обязательства по счету: отправляет погашение или выводит список погашаемых монет/сумм

Параметры

actionenumобязательный
Что делать - submit: погашает обязательство (требуются: repayableCoinList, paymentCoinList) | repayable: перечисляет погашаемые монеты/суммы.
amountstring
Сумма к возврату.
coinstring
Монета для погашения, например USDT.
confirmboolean
Требуется для выполнения разрушительных (высокорисковых) операций записи; без него такой вызов возвращает { confirmationRequired: true }.
dryRunboolean
Предпросмотр записи без отправки.
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
paymentCoinListunknown[]
Список монет для оплаты.
repayableCoinListunknown[]
Список возвращаемых монет
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

strategy_orderвнешний мир

[VERB] Стратегия (триггер/план) распределяет заявки по намерению: размещение | отмена | изменение | открытие (неисполненные) | история. Записывает с соблюдением dryRun/confirm/readOnly.

Параметры

actionenumобязательный
Что делать: - place: создаёт стратегический ордер (требуются: category, symbol, qty, posSide) - cancel: отменяет стратегический ордер (требуется: orderId) - modify: изменяет стратегический ордер (требуются: orderId, qty) - open: выводит список неисполненных стратегических ордеров (требуется: category) - history: история стратегических ордеров (требуется: category)
categoryenum
Категория продукта, например USDT-FUTURES.
clientOidstring
Ключ идемпотентности. Автоматически генерируется для place, если он не указан (P7).
confirmboolean
Требуется для выполнения разрушительных (высокорисковых) операций записи; без него такой вызов возвращает { confirmationRequired: true }.
cursorstring
Пагинация на основе курсора реализуется путем пропуска курсора в первом запросе и применения курсора из предыдущего запроса для последующих страниц.
dryRunboolean
Предпросмотр записи без отправки.
endTimestring
End timestamp: временная метка Unix в миллисекундах, например 1597026383085.
fetchAllboolean
Только постраничное чтение: пройти курсор до ограниченного завершения (возвращает { items, pages, truncated }).
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
limitstring
Лимит на страницу. По умолчанию: 100. Максимум: 100
orderIdstring
ID целевого ордера стратегии для отмены/изменения.
posSideenum
Направление позиции: лонг/шорт
qtystring
Order Quantity. Это обязательное поле, когда tpslMode=partial, и единица измерения указывается в базовой монете.
slLimitPricestring
Цена исполнения ордера в стратегии стоп-лосс Это поле применимо только к лимитным ордерам (когда slOrderType=limit); для рыночных ордеров оно игнорируется.
slOrderTypeenum
Stop-Loss Trigger Strategy. Order Type: limit: Limit Order, market: Market Order. Если не заполнено, по умолчанию используется рыночная цена.
slTriggerByenum
Тип триггера стоп-лосса: market (рыночная цена), mark (Mark Price). Если не заполнено, по умолчанию используется рыночная цена.
startTimestring
Начальная временная метка: метка времени Unix в миллисекундах, например, 1597026383085.
stopLossstring
Цена срабатывания стоп-лосса
symbolstring
Торговая пара (например, "BTCUSDT")
takeProfitstring
Цена активации тейк-профита
tpLimitPricestring
Take-Profit Strategy Order Execution Price Это поле действительно только для лимитных ордеров (когда tpOrderType=limit); для рыночных ордеров оно игнорируется.
tpOrderTypeenum
Тип ордера «Тейк-профит триггер»: limit - лимитный ордер market - рыночный ордер Если не указано, по умолчанию используется рыночная цена.
tpslModeenum
Режим Take-Profit и Stop-Loss: full - Take-Profit и Stop-Loss для всех позиций, partial - Take-Profit и Stop-Loss для частичной позиции. Если оставить пустым, значение по умолчанию - full.
tpTriggerByenum
Тип триггера тейк-профита: market (рыночная цена), mark (цена маркировки). Если не указано, по умолчанию используется рыночная цена.
typeenum
Тип стратегии: tpsl (Take-Profit and Stop-Loss), по умолчанию: tpsl
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

subaccountвнешний мир

Параметры

accountModeenum
Режим субаккаунта: классический. Субаккаунт классического аккаунта. Субаккаунт единого аккаунта.
actionenumобязательный
Что делать — создать: создать субаккаунт (требуется: имя пользователя) | createAgent: создать субаккаунт агента (брокера): имя пользователя + пароль (+ примечание) | list: список субаккаунтов | freeze: заморозить/разморозить субаккаунт (требуется: subUid, операция) | assets: объединённые активы субаккаунта | apiKeys: список API-ключей субаккаунта (требуется: subUid) | createApiKey: создать API-ключ субаккаунта (требуется: subUid, примечание, тип, пароль, разрешения, IP-адреса) | modifyApiKey: изменить API-ключ субаккаунта (требуется: apikey, пароль) | deleteApiKey: удалить API-ключ субаккаунта (требуется: apikey) | depositAddress: адрес депозита субаккаунта (требуется: subUid, монета) | depositRecords: история депозитов субаккаунта.
apikeystring
Ключ API субаккаунта
chainstring
Название сети: его можно получить с помощью API Get Currency Information.
coinstring
Фильтр монет для чтения депозитов.
confirmboolean
Требуется для выполнения разрушительных (высокорисковых) операций записи; без него такой вызов возвращает { confirmationRequired: true }.
cursorstring
Cursor ID используется для пагинации. Не передавайте его для первого запроса. Для последующих запросов (вторая страница и далее) используйте курсор, возвращённый из предыдущего запроса.
dryRunboolean
Предпросмотр записи без отправки.
endTimestring
Параметр запроса endTime.
fetchAllboolean
Только постраничное чтение: пройти курсор до ограниченного завершения (возвращает { items, pages, truncated }).
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
ipsunknown[]
Вывод средств: белый список IP-адресов. Поддерживается несколько IP-адресов. К одному ключу можно привязать максимум 30 IP-адресов. Поддерживается только IPv4.
limitstring
Количество элементов на странице. Значение по умолчанию — 100, максимальное значение — 100.
notestring
Примечание, не может превышать 50 символов.
operationenum
Тип операции: заморозить Разморозить разморозить |
passphrasestring
Парольная фраза.
permissionsunknown[]
значения разрешений <ul><li>Разрешения унифицированного аккаунта: uta_mgt Управление унифицированным аккаунтом uta_trade Торговля унифицированным аккаунтом </li></ul>
sizestring
Сумма депозита - Применимо только к сети BTC Lightning - Диапазон лимита: 0.000001 - 0.01.
startTimestring
Параметр запроса startTime.
subUidstring
UID целевого субаккаунта.
typeenum
Тип разрешения read_write Чтение/Запись read_only Только чтение
usernamestring
Генерирует имя пользователя для виртуального адреса электронной почты. Оно может содержать только строчные буквы и не должно превышать 20 символов.
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

transfer_fundsвнешний мир

[VERB] Перемещает средства по намерению: action internal | mainToSub | subToMain. Предварительная проверка сообщает максимальную переводимую сумму без фактического перемещения; переводы соблюдают dryRun/readOnly.

Параметры

actionenumобязательный
Что делать: внутренний - UTA↔classic, тот же пользователь (нужны: fromType, toType, amount, coin) | mainToSub: основной → суб-счёт (нужны: fromType, toType, amount, coin, fromUserId, toUserId, clientOid) | subToMain: суб → основной счёт (нужны: fromType, toType, amount, coin). preflight сообщает максимальную переводимую сумму без перемещения средств.
amountstring
Сумма перевода.
clientOidstring
Ключ идемпотентности. Автоматически генерируется для переводов субсчетов, если не указан (P7).
coinstring
Монета для перемещения, например USDT.
dryRunboolean
Предварительно просматривает передачу, не отправляя её.
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
fromTypestring
Тип исходной учетной записи.
fromUserIdstring
Источник uid (mainToSub).
preflightboolean
Если true, возвращает максимальную сумму перевода для coin БЕЗ выполнения перевода.
symbolstring
Символ (внутренние переводы по изолированной марже).
toTypestring
Тип счёта назначения.
toUserIdstring
UID назначения (mainToSub).
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

withdrawвнешний мир

[VERB] Вывод средств по намерению: отправить (отправляет средства наружу - необратимо, требует подтверждения) | записи (история вывода).

Параметры

actionenumобязательный
Что делать - submit: подать заявку на вывод средств (необратимая операция) (требуются: coin, transferType, address, size) | records: история выводов (требуются: startTime, endTime).
addressstring
Адрес назначения.
amountstring
Сумма для вывода.
areaCodestring
Параметр Area Code обязателен, когда innerToType = mobile.
chainstring
Сеть/блокчейн для вывода средств.
clientOidstring
Ключ идемпотентности. Для submit генерируется автоматически, если не указан (P7).
coinstring
Монета для вывода, например USDT.
companyNamestring
Company Name. Заполните этот параметр, когда identity=company.
confirmboolean
Требуется для выполнения разрушительных (высокорисковых) операций записи; без него такой вызов возвращает { confirmationRequired: true }.
cursorstring
Cursor ID - используется для пагинации, чтобы сократить время ответа на запрос - не отправляйте его при первоначальном запросе. При запросе второй страницы и последующих данных используйте наименьший orderId, возвращённый предыдущим запросом. Результаты вернут данные меньше этого значения.
dryRunboolean
Предпросмотр записи без отправки.
endTimestring
Время окончания записи запроса<ul><li>Отметка времени Unix в миллисекундах, например, 1690196141868</li></ul>
fetchAllboolean
Только постраничное чтение: пройти курсор до ограниченного завершения (возвращает { items, pages, truncated }).
fieldsany
Необязательный список (массив или строка с разделителями-запятыми) полей, которые нужно сохранить в каждой возвращаемой строке.
firstNamestring
First Name: заполните этот параметр, когда identity=user
identityTypeenum
Тип идентичности: companyInstitutional (компания), user (физическое лицо)
innerToTypeenum
Тип внутреннего адреса вывода: uid (идентификатор ползователя), email (электронная почта), mobile (номер мобильного телефона) - если не заполнено, значение по умолчанию равно uid.
lastNamestring
Last Name. Заполняется, когда identity=user.
limitstring
Количество элементов на странице. Значение по умолчанию — 100, максимальное значение — 100.
memberCodestring
Код участника: bithumb, korbit, coinone.
orderIdstring
Идентификатор заказа - либо clientOid, либо orderId должны быть указаны. Если указаны оба или они не совпадают, приоритет имеет orderId.
remarkstring
Примечание.
sizestring
Особые примечания по количеству вывода для Bitcoin Lightning Network: этот параметр должен точно совпадать с суммой в депозитном инвойсе Bitcoin Lightning Network; сумма вывода для Bitcoin Lightning Network равна полученной сумме без учёта комиссий; точность количества можно получить через API "Get Currency Information".
startTimestring
Время начала записи запроса<ul><li>Отметка времени Unix в миллисекундах, например, 1690196141868</li></ul>
tagstring
Address Tag. Требуется для вывода определенных криптовалют, таких как EOS.
transferTypeenum
Тип вывода средств on_chain - Ончейн-депозит internal_transfer - Внутренний перевод
viewenum
summary (по умолчанию) обрезает пустые поля, чтобы сэкономить токены; full возвращает исходную полезную нагрузку без изменений.

`3.3.1`основная	20.09.2026
`3.3.0`	04.09.2026
`3.0.2`	17.08.2026
`3.0.1`	17.08.2026
`3.0.0`	24.06.2026
`1.2.0`	15.06.2026

Выберите клиент, чтобы установить Bitget-AI/agent-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "bitget-ai-agent-mcp-sqgm": {
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "bitget-ai-agent-mcp-sqgm": {
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "bitget-ai-agent-mcp-sqgm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"bitget-ai-agent-mcp-sqgm\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@bitget-ai/bitget-agent-mcp\"],\"env\":{\"BITGET_API_KEY\":\"your-api-key-here\",\"BITGET_SECRET_KEY\":\"your-secret-key-here\",\"BITGET_PASSPHRASE\":\"your-passphrase-here\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "bitget-ai-agent-mcp-sqgm": {
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add bitget-ai-agent-mcp-sqgm --env BITGET_API_KEY=your-api-key-here --env BITGET_SECRET_KEY=your-secret-key-here --env BITGET_PASSPHRASE=your-passphrase-here -- npx -y @bitget-ai/bitget-agent-mcp

Либо через JSON-конфиг:

claude mcp add-json bitget-ai-agent-mcp-sqgm "{\"command\":\"npx\",\"args\":[\"-y\",\"@bitget-ai/bitget-agent-mcp\"],\"env\":{\"BITGET_API_KEY\":\"your-api-key-here\",\"BITGET_SECRET_KEY\":\"your-secret-key-here\",\"BITGET_PASSPHRASE\":\"your-passphrase-here\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add bitget-ai-agent-mcp-sqgm --env BITGET_API_KEY=your-api-key-here --env BITGET_SECRET_KEY=your-secret-key-here --env BITGET_PASSPHRASE=your-passphrase-here -- npx -y @bitget-ai/bitget-agent-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.bitget-ai-agent-mcp-sqgm]
command = "npx"
args = ["-y", "@bitget-ai/bitget-agent-mcp"]

[mcp_servers.bitget-ai-agent-mcp-sqgm.env]
BITGET_API_KEY = "your-api-key-here"
BITGET_SECRET_KEY = "your-secret-key-here"
BITGET_PASSPHRASE = "your-passphrase-here"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите Bitget-AI/agent-mcp, а в поле команды запуска — строку ниже:

npx -y @bitget-ai/bitget-agent-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bitget-ai-agent-mcp-sqgm": {
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "bitget-ai-agent-mcp-sqgm": {
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например bitget-ai-agent-mcp-sqgm.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: bitget-ai-agent-mcp-sqgm
    command: npx
    args:
      - "-y"
      - "@bitget-ai/bitget-agent-mcp"
    env:
      BITGET_API_KEY: your-api-key-here
      BITGET_SECRET_KEY: your-secret-key-here
      BITGET_PASSPHRASE: your-passphrase-here

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "bitget-ai-agent-mcp-sqgm": {
      "command": "npx",
      "args": [
        "-y",
        "@bitget-ai/bitget-agent-mcp"
      ],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@bitget-ai/bitget-agent-mcp"
  ],
  "env": {
    "BITGET_API_KEY": "your-api-key-here",
    "BITGET_SECRET_KEY": "your-secret-key-here",
    "BITGET_PASSPHRASE": "your-passphrase-here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx