Портал разработчика Chaingateway
Портал разработчика Chaingateway документирует REST API для создания адресов, отправки транзакций, чтения балансов и получения вебхуков в Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum и Solana. Начните с быстрого старта: вы создаёте API-ключ, отправляете один запрос и переключаетесь между mainnet и testnet одним заголовком.
📝 Начало работы
Узнайте основы Chaingateway и как начать её использовать
💻 Документация API
Изучите документацию нашего простого в использовании Blockchain Gateway API
🔔 Вебхуки
Узнайте, как наша система Instant Payment Notification может уведомлять вас о событиях в блокчейне
🎓 Инструкции
Найдите полезные инструкции по внедрению API Chaingateway на примерах реальных сценариев использования
Что можно делать с API Chaingateway?
Заголовок раздела «Что можно делать с API Chaingateway?»Через один REST-интерфейс можно управлять кошельками, отправлять нативные монеты и токены, читать данные блокчейна и подписываться на уведомления о платежах. Файл OpenAPI перечисляет более 200 операций. Они сгруппированы по блокчейнам, а в сетях EVM один и тот же шаблон повторяется.
| Задача | Типичный эндпоинт | Блокчейны |
|---|---|---|
| Создать адрес кошелька | POST /api/v2/{chain}/addresses | Ethereum, BSC, Polygon, Arbitrum, TRON, Solana |
| Создать кошелёк Bitcoin и его адреса | POST /api/v2/bitcoin/wallets | Bitcoin |
| Отправить нативные монеты | POST /api/v2/{chain}/transactions | все семь |
| Отправить токены | POST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPL | все, кроме Bitcoin |
| Читать балансы и блоки | GET /api/v2/{chain}/balances/{address} | все семь |
| Получать уведомления о платежах | POST /api/v2/{chain}/webhooks | все, кроме Solana |
| Прочитать рыночную цену | GET /api/v2/market/price/{crypto}/{fiat} | не зависит от блокчейна |
У Solana нет эндпоинтов для вебхуков, поэтому депозиты в Solana нужно обнаруживать чтением балансов или транзакций. Кошельки некастодиальные: вы либо выбираете пароль, который защищает сохранённый ключ, либо получаете приватный ключ в ответе и храните его сами. Оба режима объясняет раздел Управление кошельками.
Как отправить первый запрос?
Заголовок раздела «Как отправить первый запрос?»Создайте API-ключ в панели управления и передавайте его как Bearer-токен в заголовке Authorization. Новый аккаунт получает бесплатный пробный период на 7 дней, для начала не нужны ни карта, ни проверка личности. Запрос ниже читает номер последнего блока Ethereum.
curl --request GET \ --url https://app.chaingateway.io/api/v2/ethereum/blocks/number \ --header 'Accept: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN'Запрос без действительного токена возвращает HTTP 401 с телом {"message":"Unauthenticated."}. Чтобы выполнить тот же вызов в тестовой сети, добавьте заголовок X-Network: testnet. Не указывайте заголовок или задайте mainnet, чтобы работать в основной сети. Быстрый старт проводит через настройку аккаунта, заголовки и запрос POST на четырёх языках.
Какие сети поддерживает API?
Заголовок раздела «Какие сети поддерживает API?»Доступны семь блокчейнов, у каждого есть mainnet и testnet. Это Sepolia для Ethereum, Nile для TRON, testnet BNB Smart Chain, Bitcoin testnet3, Amoy для Polygon, Arbitrum Sepolia и Solana devnet. Поддерживаемые сети перечисляют все сети с подходящим значением X-Network и объясняют два значения заголовка.
Где найти полный справочник API?
Заголовок раздела «Где найти полный справочник API?»Интерактивный справочник находится по адресу chaingateway.io/docs. Он создаётся из того же файла openapi.yaml, который можно импортировать в Postman, Insomnia или генератор кода. Для каждой операции указаны параметры, правила проверки адресов и примеры ответов, в том числе тела ошибок.
Ответы используют один JSON-конверт с полями status, ok и message. Успешные вызовы добавляют data, а неудачная валидация добавляет объект errors. FAQ показывает примеры обоих случаев.
Как выглядит ответ?
Заголовок раздела «Как выглядит ответ?»Каждый эндпоинт отвечает в формате JSON. Успешный вызов возвращает ok: true вместе со статусом HTTP и полем data. Следующий пример — ответ на GET /api/v2/ethereum/gasprice.
{ "ok": true, "status": 200, "message": "Successfully parsed", "data": { "gasPrice": "12.28" }}Неудачная валидация возвращает статус 422 и называет каждое отклонённое поле. Тот же конверт передаёт ошибки блокчейна, например нехватку средств на газ. Неверный пароль кошелька возвращает 401 с сообщением Wrong password provided. Пишите клиент так, чтобы он сначала проверял ok, а при false записывал в лог message и errors.
{ "status": 422, "ok": false, "message": "Data validation failed", "errors": { "password": ["The password field is required."] }}Какое руководство читать дальше?
Заголовок раздела «Какое руководство читать дальше?»Выберите страницу, которая подходит к вашей задаче:
- Чтобы безопасно хранить ключи, читайте Управление кошельками.
- Чтобы обнаруживать входящие платежи, читайте Вебхуки, затем Безопасность вебхуков.
- Чтобы отправлять монеты, следуйте руководствам Создание транзакций и Создание токен-транзакций.
- Чтобы платить комиссии TRON без хранения TRX, читайте Спонсирование комиссий TRC20.
Источники
Заголовок раздела «Источники»HTTP-соглашения и соглашения о токенах в этой документации определяют публичные стандарты:
- RFC 9110, HTTP Semantics для методов, кодов статуса и заголовков.
- RFC 6750, Bearer Token Usage для заголовка
Authorization: Bearer. - RFC 8259, The JSON Data Interchange Format для тел запросов и ответов.
- Документация разработчика Ethereum и документация разработчика TRON для блокчейнов, стоящих за эндпоинтами.