Получите спецификацию 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 €/мес и охватывают все семь поддерживаемых блокчейнов.