bybit-php

0

Описание

Профессиональная PHP-библиотека для интеграции с Bybit V5 API. Поддерживает работу с чистым PHP и Laravel, включает полный функционал торговых операций, управление позициями и ордерами, WebSocket для данных в реальном времени. Есть криптографическая подпись запросов HMAC/RSA-SHA256, автоматическое переподключение и мультирегиональные эндпоинты

Языки

  • PHP100%
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
3 месяца назад
README.md

🚀 Bybit PHP Библиотека

Полноценная обёртка V5 API для приложений PHP и Laravel

PHP Version Laravel License WebSocket

ByBit PHP SDK

🌐 Язык: Русский | English

🔗 GitHub Repository: https://github.com/tigusigalpa/bybit-php

Надёжный и эффективный PHP-пакет для лёгкой интеграции Bybit V5 API в ваши PHP и Laravel приложения.

Основные функцииРуководство по установкеНачало работыСправочник APIДанные в реальном времениПримеры кода


📋 Оглавление


✨ Основные функции

🎯 Базовые возможности

  • ✅ Комплексная интеграция Bybit V5 API
  • ✅ Двойная поддержка подписей: HMAC-SHA256 и RSA-SHA256
  • ✅ Поддержка тестовой и продакшен среды
  • ✅ Мультирегиональная конфигурация эндпоинтов
  • ✅ Работа с чистым PHP и Laravel
  • ✅ Строго типизированная обработка запросов

⚡ Премиум функционал

  • ✅ Потоковая передача данных WebSocket
  • ✅ Автоматическое восстановление соединения
  • ✅ Поддержка многоканальных подписок
  • ✅ Настраиваемое время приёма
  • ✅ Надёжное управление исключениями
  • ✅ Фасады Laravel и внедрение зависимостей

📦 Руководство по установке

Автономный PHP

Фреймворк Laravel

Для монорепо среды разработки:

  1. Настройте репозиторий в
    composer.json
    :
  1. Добавьте пакет через Composer:
  1. Экспортируйте файл конфигурации:

💡 Инфо: Пакет использует функцию автообнаружения Laravel для автоматической регистрации провайдера и фасада.


⚙️ Настройки

Конфигурация окружения

Настройте ваш файл

.env
следующим образом:

Доступные параметры

ОпцияТип данныхЗначение по умолчаниюНазначение
BYBIT_API_KEY
string-Публичный API ключ от Bybit
BYBIT_API_SECRET
string-Секретный API ключ от Bybit
BYBIT_TESTNET
boolean
false
Активация тестовой среды
BYBIT_REGION
string
global
Регион сервера (
global
,
nl
,
tr
,
kz
,
ge
,
ae
)
BYBIT_RECV_WINDOW
integer
5000
Временное окно для запросов (миллисекунды)
BYBIT_SIGNATURE
string
hmac
Метод аутентификации (
hmac
или
rsa
)
BYBIT_RSA_PRIVATE_KEY
string
null
Приватный RSA ключ в формате PEM

🚀 Начало работы

Реализация на автономном PHP

Реализация на Laravel

Через паттерн фасада:

Через инъекцию в конструктор:


📚 Справочник API

Торговые данные

Контроль ордеров

Контроль позиций

Кошелёк и баланс


🌐 Данные WebSocket в реальном времени

Публичные потоки данных

Автономный PHP WebSocket:

Приватные потоки данных

Аутентифицированный WebSocket для данных аккаунта в реальном времени:

Команда Laravel Artisan:

Запуск:

php artisan bybit:listen BTCUSDT


💡 Экспертные методы

Унифицированная отправка ордеров

Методы расчёта комиссий


🌍 Расположение серверов

МестоположениеКод регионаAPI эндпоинт
🌐 Всемирный
global
https://api.bybit.com
🇳🇱 Нидерланды
nl
https://api.bybit.nl
🇹🇷 Турция
tr
https://api.bybit-tr.com
🇰🇿 Казахстан
kz
https://api.bybit.kz
🇬🇪 Грузия
ge
https://api.bybitgeorgia.ge
🇦🇪 ОАЭ
ae
https://api.bybit.ae
🧪 Тестирование-
https://api-testnet.bybit.com

🔐 Безопасность и авторизация

Процесс подписи запросов

Bybit V5 API применяет криптографические подписи HMAC-SHA256 или RSA-SHA256:

Для GET запросов:

signature_payload = timestamp + api_key + recv_window + queryString

Для POST запросов:

signature_payload = timestamp + api_key + recv_window + jsonBody

HMAC-SHA256: Генерирует вывод в шестнадцатеричном формате нижнего регистра RSA-SHA256: Генерирует вывод в формате base64

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

X-BAPI-API-KEY: ваш_api_ключ X-BAPI-TIMESTAMP: 1234567890000 X-BAPI-RECV-WINDOW: 5000 X-BAPI-SIGN: сгенерированная_подпись X-BAPI-SIGN-TYPE: 2 (для HMAC) Content-Type: application/json (для POST)

📖 Официальная документация: https://bybit-exchange.github.io/docs/v5/guide


📖 Примеры кода

Полная реализация торгового бота


🤝 Руководство по вкладу

Мы приветствуем вклад сообщества! Не стесняйтесь отправлять Pull Request.

  1. Сделайте форк репозитория
  2. Создайте ветку для новой функции (
    git checkout -b feature/NewFeature
    )
  3. Зафиксируйте ваши изменения (
    git commit -m 'Реализация NewFeature'
    )
  4. Отправьте изменения в вашу ветку (
    git push origin feature/NewFeature
    )
  5. Создайте Pull Request

📄 Информация о лицензии

MIT License

Copyright (c) 2026 Igor Sazonov


🌟 Поставьте звезду проекту, если он вам полезен!

Создано с ❤️ для криптотрейдеров по всему миру

Сообщить о проблемеПредложить функциюAPI документация