Создание учетной записи и авторизация
Прежде чем совершать сделки и получать доступ к личным данным, вам необходимо настроить свою учетную запись и получить учетные данные API.
- Выберите среду
Мы предоставляем две среды для разработки и тестирования:
| Среда | Описание | Base URL (REST API) | Telegram bot |
|---|---|---|---|
| Testnet | Используйте эту среду для разработки и безопасного тестирования ваших стратегий. | | https://t.me/xrocket_testnet_bot?start |
| Mainnet | Используйте эту среду для торговли реальными средствами. | | https://t.me/xRocket?start |
Мы рекомендуем начать со среды Testnet, чтобы безопасно разработать и протестировать вашу интеграцию перед переходом на Mainnet. Подробнее о получении тестовых средств см. в разделе Тестирование интеграции.
- Создать учетную запись xRocket
Запустите @xRocket (или @xrocket_testnet_bot для тестовой сети), чтобы автоматически создать кошелек/аккаунт xRocket, связанный с вашей учётной записью Telegram.
- Получите свой Bearer Token (API-ключ)
В нашем Telegram-боте перейдите в Меню > Настройки > Настройки биржи > API-токен или обратитесь в поддержку xRocket за помощью.
Ваш Bearer Token (ключ API) предоставляет полный доступ к вашему аккаунту, включая торговлю, переводы и вывод средств. Возможность ограничить разрешения токена отсутствует. Обращайтесь с API-токеном с таким же уровнем безопасности, как и с паролем от аккаунта — никогда не делитесь им публично!
Авторизация
Все приватные методы требуют авторизации для проверки вашей личности и обеспечения безопасности данных вашей учетной записи и сделок. Мы используем простой механизм авторизации Bearer Token.
Как авторизовать запрос?
Добавляйте Bearer token в запросы при использовании любых приватных методов следующим образом. Вы должны включать заголовок Authorization во все приватные запросы. Значение этого заголовка должно состоять из слова Bearer, за которым следует ваш токен.
Пример заголовка:
Authorization: Bearer <ВАШ_API_ТОКЕН>
Вот как использовать команду curl для выполнения аутентифицированного запроса, например, для проверки ваших торговых балансов (GET /api/v1/accounts/trading/balances).
Пример кода (cURL):
curl -L 'https://exchange.api.xrocket.tg/api/v1/accounts/trading/balances' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <ВАШ_API_ТОКЕН>'
После выполнения успешного авторизованного запроса, вы будете готовы использовать реальные API методы в т. ч. приватные. См. метод GET /api/v1/accounts/trading/balances, чтобы изучить полную информацию о запросе и ответе и подтвердить, что ваша аутентификация работает.
Обновление токена авторизации
Если вы подозреваете, что ваш токен скомпрометирован или просто хотите обновить его в целях безопасности, вы можете выпустить новый в любое время.
Выпуск нового токена мгновенно сделает недействительным ваш старый токен. Любое приложение, использующее старый токен, немедленно перестанет работать. Обязательно обновите все свои интеграции новым токеном сразу после его выпуска.
Чтобы обновить ваш токен:
- В @xRocket (для Mainnet) или @xrocket_testnet_bot (для Testnet) перейдите в Меню > Настройки > Настройки биржи > API токен.
- Выберите опцию Обновить токен.
Затем ваше приложение необходимо будет обновить новым токеном, чтобы продолжить выполнение авторизованных API-запросов.