Получите
спецификацию API Chaingateway
Спецификация OpenAPI Chaingateway — это машиночитаемое описание REST API в формате OpenAPI 3.0.3. В ней перечислены эндпоинты для всех семи сетей, формы их запросов и ответов и способ аутентификации по Bearer-токену. Chaingateway — это REST API, поэтому никакого приложения для установки нет.
Что содержит спецификация OpenAPI?
Она описывает 202 операции на 164 путях: один эндпоинт аккаунта, один эндпоинт цены, а также эндпоинты адресов, транзакций, балансов, блоков и вебхуков для семи сетей. Из них 116 операций GET, 68 POST, 12 DELETE и 6 PUT.
| Сеть | Операции | Стандарты токенов | Операции вебхуков |
|---|---|---|---|
| Bitcoin | 21 | Нет | 8 |
| Ethereum | 31 | ERC-20, ERC-721 | 8 |
| BNB Smart Chain | 31 | BEP-20, BEP-721 | 8 |
| TRON | 40 | TRC-10, TRC-20, TRC-721 | 8 |
| Solana | 15 | SPL | Нет |
| Polygon | 31 | ERC-20, ERC-721 | 8 |
| Arbitrum | 31 | ERC-20, ERC-721 | 8 |
Файл в формате YAML, около 1 МБ, версия спецификации 2.1.0. Сервер — https://app.chaingateway.io. Каждый эндпоинт использует HTTP-аутентификацию Bearer, а токен создаётся в разделе API tokens личного кабинета. Эти числа приведены на 5 ноября 2026 года и меняются при добавлении эндпоинтов.
Как сгенерировать клиент по спецификации?
Направьте на файл генератор кода OpenAPI. Команда ниже создаёт клиент на TypeScript через OpenAPI Generator, а параметр -g выбирает язык.
npx @openapitools/openapi-generator-cli generate \
-i https://chaingateway.io/openapi.yaml \
-g typescript-fetch \
-o ./chaingateway-client Замените typescript-fetch на генератор для вашего языка, например python или php. Прежде чем полагаться на сгенерированный код, выполните один вызов в testnet. OpenAPI Generator: список генераторов
Как импортировать спецификацию в Postman или Insomnia?
Оба инструмента импортируют файл OpenAPI напрямую. Выберите вариант импорта, затем вставьте URL https://chaingateway.io/openapi.yaml или выберите скачанный файл. Задайте заголовку Authorization ваш Bearer-токен и добавьте X-Network: testnet на время тестов.
Как вызывать API без сгенерированного клиента?
Передавайте Bearer-токен в заголовке Authorization на https://app.chaingateway.io. Добавьте X-Network: testnet для testnet. Не указывайте заголовок или задайте mainnet для mainnet.
curl https://app.chaingateway.io/api/account \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Network: testnet" GET /api/account — быстрая проверка, что токен работает.
Как в спецификации выглядят ответы и ошибки?
Успешные операции возвращают HTTP 200 или 201, а примеры оборачивают результат в конверт с полями status, ok, message и data. Среди 202 операций спецификация описывает 401 (не аутентифицирован) 50 раз, 422 (например, ошибка проверки данных или недостаточно средств) 70 раз, 404 пять раз и 400 один раз.
Пример ответа 401 содержит в поле message строку «Unauthenticated.». Сначала читайте код статуса, затем сообщение.
Есть ли читаемая версия спецификации?
Да. Интерактивный справочник API отображает тот же файл, поэтому эндпоинты можно прочитать, запросы попробовать, а примеры скопировать до генерации любого кода. Открыть справочник API
Какие части спецификации устарели?
Операции Tron Paymaster всё ещё есть в файле, всего пять. Paymaster устарел и заменён на TronFuel, поэтому не включайте их в новые интеграции. У Solana эндпоинтов вебхуков нет вообще.
Готовы начать разработку?
Каждая интеграция работает на одном и том же REST API Chaingateway — 7 дней бесплатно, без банковской карты и KYC. Тарифы от 49 €/мес и охватывают все семь поддерживаемых блокчейнов.