> For the complete documentation index, see [llms.txt](https://colibri-2.gitbook.io/colibri-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://colibri-2.gitbook.io/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api.md).

# Подключение API

{% embed url="<https://www.youtube.com/watch?v=cj1iVP3oOSc>" %}

Чтобы торговать через терминал Colibri и видеть свои позиции, баланс и сделки, нужно подключить биржу по API. Для простого наблюдения за рынком ключи не обязательны — можно работать в [режиме просмотра](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/rezhim-prosmotra.md).

## Как подключить биржу

Общий порядок одинаков для всех бирж:

1. Зарегистрируйтесь на бирже (если аккаунта ещё нет) и войдите в личный кабинет.
2. Создайте API-ключ в разделе управления API на бирже. Обычно вы получаете два значения: **Ключ API (API Key)** и **Секретный ключ (Secret Key)**. На некоторых биржах дополнительно задаётся **Passphrase**.
3. В терминале откройте раздел подключений (**Подключения / Connections**) и нажмите **«Добавить подключение»**.
4. Выберите нужную биржу и тип рынка.
5. Введите полученные **Ключ API** и **Секретный ключ** (а при необходимости — **Passphrase**) и сохраните подключение.

После добавления подключения индикатор соединения должен стать зелёным, а в разделах [Сделки](/colibri-docs/colibri-terminal/torgovlya/razdel-pozicii.md) и [Финрез](/colibri-docs/colibri-terminal/torgovlya/finrez.md) появятся ваши данные.

## Окно «Добавить подключение»

В окне виден весь список поддерживаемых бирж — он постоянно растёт. Список можно отфильтровать по типу — **CEX** и **DEX** — а также по возможностям: например, фильтр **«Торговля»** покажет все биржи, по которым доступна торговля через терминал.

Подключать можно **сразу несколько бирж**: выберите их в списке и нажмите **«Далее»** — все выбранные биржи появятся в одном окне, не нужно открывать и настраивать каждую по отдельности. Введите для каждой биржи API-ключ и секретный ключ; если хотите подключить биржу только в режиме просмотра — просто оставьте её поля пустыми. Затем нажмите **«Добавить все»**.

Отличить режимы легко по плашке **«Торговля»** в строке подключения: **белая** — биржа подключена в режиме просмотра, **зелёная** — доступна торговля.

## Параметры подключения

При создании подключения, помимо ключей, доступны дополнительные параметры:

| Параметр                | Описание                                                                                                   |
| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Название (метка)**    | Понятное имя подключения, чтобы отличать его в списке.                                                     |
| **Тип рынка**           | Спот или фьючерсы (зависит от биржи).                                                                      |
| **Только просмотр**     | Режим без торговли: данные видны, ордера не выставляются.                                                  |
| **Скопировать ключ в…** | Скопировать ключ в другое подключение той же биржи (например, со спота на фьючерсы).                       |
| **Прокси**              | Назначить подключению прокси из списка (см. [Прокси](/colibri-docs/colibri-terminal/nastroiki/proksi.md)). |

Управление существующими подключениями (редактирование, переподключение, удаление, привязка прокси) описано в разделе [Настройки подключения](/colibri-docs/colibri-terminal/nastroiki/standartnye-nastroiki-monet.md).

## Что такое Passphrase

{% hint style="info" %}
**Passphrase** — это отдельная парольная фраза, которую вы сами придумываете при создании API-ключа на некоторых биржах (например, OKX, KuCoin, Bitget). Это **не** торговый пароль аккаунта и не пароль для входа. Passphrase запрашивается только при создании ключа и при его использовании в терминале.
{% endhint %}

## Безопасность API-ключей

{% hint style="danger" %}

* Никому не передавайте свои API-ключи и секретный ключ — это доступ к торговле на вашем аккаунте.
* При создании ключа **не включайте право на вывод средств (Withdraw)** — терминалу оно не нужно.
* По возможности ограничьте ключ по IP-адресу.
* Если вы подозреваете, что ключ скомпрометирован, удалите его на бирже и создайте новый.
  {% endhint %}

## Доступные биржи

* [Режим просмотра (без API)](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/rezhim-prosmotra.md)
* [Binance](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/binance.md)
* [Bybit](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/bybit.md)
* [OKX](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/okx.md)
* [Gate.io](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/gate-io.md)
* [MEXC](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/mexc.md)
* [Bitget](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/bitget.md)
* [KuCoin](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/kucoin.md)
* [HTX](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/htx.md)
* [Aster](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/aster.md)
* [OrangeX](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/orangex.md) — только просмотр
* [Upbit](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/upbit.md) — только просмотр
* [Hyperliquid](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/hyperliquid.md)
* [Lighter](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/lighter.md) — только просмотр
* [ApexOmni](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/apexomni.md)
* [Binance Alpha](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/binance-alpha.md) — только просмотр
* [Kraken](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/kraken.md)
* [Polymarket](/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api/polymarket.md) — только просмотр


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://colibri-2.gitbook.io/colibri-docs/colibri-terminal/s-chego-nachat/podklyuchenie-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.