Перейти к содержимому

Портал разработчика Chaingateway

Портал разработчика Chaingateway документирует REST API для создания адресов, отправки транзакций, чтения балансов и получения вебхуков в Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum и Solana. Начните с быстрого старта: вы создаёте API-ключ, отправляете один запрос и переключаетесь между mainnet и testnet одним заголовком.

Через один REST-интерфейс можно управлять кошельками, отправлять нативные монеты и токены, читать данные блокчейна и подписываться на уведомления о платежах. Файл OpenAPI перечисляет более 200 операций. Они сгруппированы по блокчейнам, а в сетях EVM один и тот же шаблон повторяется.

ЗадачаТипичный эндпоинтБлокчейны
Создать адрес кошелькаPOST /api/v2/{chain}/addressesEthereum, BSC, Polygon, Arbitrum, TRON, Solana
Создать кошелёк Bitcoin и его адресаPOST /api/v2/bitcoin/walletsBitcoin
Отправить нативные монеты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-ключ, создать адрес, отправлять и читать транзакции, получать вебхуки 1. Создайте API-ключ Панель управления, API tokens 2. Создайте адрес POST /api/v2/{chain}/addresses 3. Отправляйте и читайте транзакции POST и GET /api/v2/{chain}/transactions 4. Получайте вебхуки POST /api/v2/{chain}/webhooks, ваш серверотвечает 200
Обычный порядок интеграции. Шаги 3 и 4 можно выполнять параллельно.

Создайте 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 на четырёх языках.

Доступны семь блокчейнов, у каждого есть mainnet и testnet. Это Sepolia для Ethereum, Nile для TRON, testnet BNB Smart Chain, Bitcoin testnet3, Amoy для Polygon, Arbitrum Sepolia и Solana devnet. Поддерживаемые сети перечисляют все сети с подходящим значением X-Network и объясняют два значения заголовка.

Интерактивный справочник находится по адресу 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."] }
}

Выберите страницу, которая подходит к вашей задаче:

HTTP-соглашения и соглашения о токенах в этой документации определяют публичные стандарты: