Чтобы автоматически исполнять ордера на платформе деривативов, начните с генерации токена доступа в личном кабинете. Он потребуется для аутентификации запросов. Загрузите библиотеку requests для Python – она упростит отправку HTTP-запросов к конечным точкам брокера.
Для получения текущих котировок, используйте запрос GET к конечной точке /api/v1/quotes. Параметр pair определяет валютную пару (например, EURUSD). Ответ будет содержать атрибуты bid и ask, отображающие цены покупки и продажи актива. Внимание: котировки могут немного отличаться от отображаемых в терминале, учитывайте это при расчете рисков.
Размещение нового соглашения осуществляется через POST-запрос к /api/v1/trades. Обязательные параметры: asset (идентификатор актива), type (CALL или PUT), amount (сумма инвестиции) и duration (время экспирации в секундах). Убедитесь, что сумма на балансе счета достаточна для совершения сделки. В случае успеха, сервер вернет уникальный идентификатор ордера.
Ключи доступа к платформе: Инструкция по Получению
Получите идентификаторы доступа к инструментам взаимодействия с платформой через личный кабинет. Войдите в вашу учётную запись на ресурсе.
Далее, отыщите раздел управления идентифицирующими данными. Он может называться, например, “Интеграция”, “Разработчикам”, “Ключи доступа” или “Автоматизированная деятельность”. Расположение варьируется в зависимости от обновлений интерфейса.
Создайте новый ключ, указав цели его применения (например, “Автоматизированное исполнение сделок”, “Сбор данных”). Установите ограничения на его использование (лимиты средств, доступные функции). Сгенерируйте пару ключей – публичный и секретный. Важно: Секретный ключ показывается только один раз. Сохраните его надежно.
Примерный вид ключей:
| Публичный Ключ (ID) | PUBLIC_KEY_1a2b3c4d5e6f |
| Секретный Ключ | SECRET_KEY_f6e5d4c3b2a1 |
При потере секретного ключа, сгенерируйте новую пару. Старый ключ будет автоматически деактивирован. Регулярно проверяйте активности, связанные с вашими ключами доступа, для своевременного обнаружения несанкционированного использования.
Установка: Необходимые Библиотеки Python
Для начала работы с платформой, установите библиотеки requests для отправки HTTP-запросов и websockets для установления постоянного соединения с WebSocket. Выполните следующие команды в терминале:
pip install requests websockets
Рекомендуется использовать виртуальное окружение Python для изоляции зависимостей проекта. Создайте его командой:
python3 -m venv .venv
Активируйте окружение. В Linux/macOS:
source .venv/bin/activate
В Windows:
.venv\Scripts\activate
После активации окружения, повторно выполните установку библиотек. Для обработки JSON-ответов не требуется специальная библиотека, так как она встроена в Python (json). Однако, для удобства работы с данными, рассмотрите использование pandas:
pip install pandas
Если требуется асинхронная обработка событий WebSocket, установите asyncio (входит в стандартную библиотеку Python 3.7+). Для Python версий ниже 3.7:
pip install asyncio
Авторизация: Проверка работоспособности соединения с платформой
Убедитесь в успешной аутентификации, выполнив простой запрос после получения токена. Рекомендуется использовать эндпоинт, возвращающий информацию об аккаунте, например, /api/v1/profile. Успешный ответ с кодом 200 и данными профиля подтверждает работоспособное соединение.
Пример запроса (cURL):
curl -H “Authorization: Token YOUR_AUTH_TOKEN” https://trading-platform.com/api/v1/profile
Замените YOUR_AUTH_TOKEN на полученный токен доступа. Обратите внимание на код HTTP-ответа. Коды 401 (Не авторизован) или 403 (Запрещено) указывают на проблемы с аутентификацией (неверный токен, недостаточные права доступа). Проверьте правильность токена и запросите необходимые разрешения.
Обработка ошибок аутентификации:
В случае сбоя аутентификации, повторно запросите токен, убедитесь в его актуальности и наличии необходимых разрешений для совершаемых операций. Логируйте ошибки для облегчения диагностики проблем.
Получение Котировок: Как Запрашивать Данные?
Для получения текущих котировок финансовых инструментов, используйте метод `GET /quote/asset/{asset_id}`. Замените `{asset_id}` на идентификатор нужного актива. Пример: `GET /quote/asset/EURUSD`. Формат ответа – JSON.
Пример запроса
Для отправки запроса применяйте HTTP-запрос с заголовком `Authorization: Bearer {токен}`. Используйте cURL:
curl -H "Authorization: Bearer YOUR_TOKEN" https://brokerage.example.com/quote/asset/EURUSD
Формат ответа
Ответ содержит текущие цены спроса и предложения, а также временную метку:
{
"asset": "EURUSD",
"bid": 1.0850,
"ask": 1.0852,
"timestamp": 1678886400
}
Обратите внимание: значения цен представлены в виде чисел с плавающей точкой.
Для получения исторических данных (свечей), используйте `GET /candles/{asset_id}/{timeframe}`. `{timeframe}` определяет период свечи (например, ‘M1’ – минута, ‘H1’ – час, ‘D1’ – день). Поддерживаемые таймфреймы: M1, M5, M15, M30, H1, H4, D1, W1, MN.
Дополнительно можно указать параметры `from` и `to` для определения временного диапазона: `GET /candles/EURUSD/H1?from=1678800000&to=1678886400`.
Важно: время в запросах передаётся в формате Unix timestamp (количество секунд, прошедших с начала эпохи Unix).
Открытие Сделки: Пример Кода
Для открытия позиции на платформе, используйте следующий фрагмент кода (предполагается, что у вас уже настроено соединение и авторизация):
import requests
import json
# Ваши учетные данные и параметры
token = "YOUR_AUTH_TOKEN"
asset = "EURUSD"
deal_type = "call" # или "put"
amount = 10.00
expiration = 60 # Время экспирации в секундах
# URL для создания сделки
url = "https://tradingplatform.example.com/v1/deals/open" #Заменить на актуальный URL
headers = {
"Authorization": f"Bearer {token}",
"Content-Type": "application/json"
}
payload = {
"asset": asset,
"type": deal_type,
"amount": amount,
"expiration": expiration
}
# Отправка запроса
response = requests.post(url, headers=headers, data=json.dumps(payload))
# Обработка ответа
if response.status_code == 200:
data = response.json()
print(f"Сделка успешно открыта. ID: {data['deal_id']}")
else:
print(f"Ошибка при открытии сделки: {response.status_code} - {response.text}")
Важные детали
Замените YOUR_AUTH_TOKEN на ваш актуальный токен доступа. Убедитесь, что URL tradingplatform.example.com/v1/deals/open соответствует адресу, предоставляемому вашим брокером. Значение expiration (время действия) задается в секундах. Проверьте список доступных активов (asset) и допустимые значения для type (типа сделки) в документации к платформе.
Обработка ошибок
Всегда проверяйте response.status_code. Код 200 указывает на успешное выполнение запроса. Любой другой код означает возникновение ошибки. Анализируйте response.text для получения подробной информации об ошибке.
Управление Ордерами: Закрытие и Модификация
Для закрытия активной сделки отправьте POST-запрос к конечной точке `/close`. Необходимо указать `order_id` в теле запроса. Пример тела запроса: `{“order_id”: “123456789”}`. Успешный ответ вернет код 200 и детали закрытого ордера. Неудача может быть вызвана неверным ID или недостаточными средствами.
Рекомендация: всегда проверяйте статус ордера перед отправкой запроса на закрытие. Это предотвратит ошибки из-за попыток закрыть уже закрытые или отмененные сделки. Используйте GET-запрос к `/order/{order_id}` для получения текущего статуса.
Модификация Существующих Ордеров
Корректировка открытой позиции осуществляется через POST-запрос к конечной точке `/modify`. Тело запроса должно содержать `order_id`, а также параметры, которые необходимо изменить: `amount` (новый объем), `stop_loss` (новый стоп-лосс), `take_profit` (новый тейк-профит). Например: `{“order_id”: “987654321”, “stop_loss”: 1.1000}`.
Ограничения Модификации
Не все параметры могут быть изменены для всех типов позиций. Убедитесь, что ваш брокер поддерживает изменение желаемого параметра для конкретного инструмента. Обратите внимание, что частота запросов на модификацию ограничена. Превышение лимита может привести к временной блокировке возможности редактирования позиций.
Отладка: Анализ Ошибок Интеграции
Для быстрого выявления причин сбоев при работе с платформой, активируйте подробное логирование запросов и ответов. Сохраняйте полные HTTP-заголовки, тела запросов (request bodies) и ответы (response bodies) в отдельный файл.
Распространенные коды ошибок и их интерпретация:
Код 400 (Bad Request): Проверьте соответствие типов данных передаваемых параметров требуемым форматам (например, числовые значения вместо строк). Убедитесь в наличии всех обязательных параметров.
Код 401 (Unauthorized): Перепроверьте корректность токена доступа (access token) и его срок действия. Токены могут устаревать, требуя обновления.
Код 403 (Forbidden): Учетная запись не имеет прав для выполнения данной операции. Свяжитесь с поддержкой для уточнения доступных разрешений.
Код 429 (Too Many Requests): Слишком много запросов за короткий промежуток времени. Реализуйте механизм контроля частоты запросов (rate limiting) на стороне клиента, увеличивая интервалы между вызовами.
Методы выявления причин сбоев:
Используйте инструменты анализа сетевого трафика (например, Wireshark) для перехвата и изучения обмена данными между вашим приложением и сервером. Это поможет выявить несоответствия в структуре пакетов и содержании передаваемой информации.
Проверьте соответствие структуры JSON-ответов ожидаемой. Даже небольшие отклонения в названии полей или их типах могут привести к ошибкам обработки.
Систематически проверяйте документацию разработчика на предмет обновлений или изменений в структуре запросов и ответов. Платформы могут вносить изменения, требующие адаптации вашего кода.