Block Flow - Web3 инфраструктура. Документация.

Введение

Blockflow предоставляет единый JSON‑RPC шлюз для взаимодействия с блокчейн-сетями. Наша инфраструктура включает выделенные ноды, индексёры для мгновенного доступа к данным, NFT-API и аналитические сервисы.

Все запросы отправляются на единый эндпоинт: https://rpc.blockflow.io/v1/{network}/{type}

Архитектура API

Клиент

API шлюз

Индексёры

Ноды

NFT

Ответ < 100ms

Быстрый старт

Всего 3 шага, чтобы начать использовать Blockflow API.

1

Зарегистрируйтесь

Создайте аккаунт в консоли и получите API‑ключ

2

Выберите сеть

Выберите нужный блокчейн и тип данных

3

Отправьте запрос

Используйте JSON‑RPC с вашим API‑ключом

Пример первого запроса

            // Получение баланса Ethereum

            curl -X POST https://rpc.blockflow.io/v1/eth/mainnet \

              -H "Content-Type: application/json" \

              -H "X-API-Key: YOUR_API_KEY" \

              -d '{

                        "jsonrpc": "2.0",

                        "method": "eth_getBalance",

                        "params": ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e", "latest"],

                        "id": 1

                      }'

JSON‑RPC API

Мы поддерживаем все стандартные JSON‑RPC методы для каждой сети, а также расширенные методы для работы с индексёрами и NFT.

Аутентификация

Все запросы должны содержать API‑ключ в заголовке X-API-Key.

Параметры запроса

Параметр	Тип	Описание	Обязательность
`jsonrpc`	string	Версия протокола (всегда "2.0")	Обязательно
`method`	string	Имя вызываемого метода	Обязательно
`params`	array	Параметры метода (зависят от метода)	Опционально
`id`	number	Идентификатор запроса (возвращается в ответе)	Обязательно

Методы индексёров

Метод	Описание	Сети	Скорость
`indexer_getUTXO`	Получение UTXO для адреса (Bitcoin)	Bitcoin, Litecoin	47ms
`indexer_getBalance`	Получение баланса адреса	Все сети	28-55ms
`indexer_getTransactions`	История транзакций адреса	Все сети	35ms
`indexer_getTokenBalances`	Балансы всех токенов адреса	EVM-сети, Solana, TON	42ms

Примеры запросов

Подробные примеры для различных сценариев использования.

1. Получение UTXO для Bitcoin (индексёр)

            // Запрос UTXO за 47ms (вместо 40-80 секунд)

            curl -X POST https://rpc.blockflow.io/v1/btc/mainnet \

              -H "Content-Type: application/json" \

              -H "X-API-Key: YOUR_API_KEY" \

              -d '{

                        "jsonrpc": "2.0",

                        "method": "indexer_getUTXO",

                        "params": ["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"],

                        "id": 1

                      }'

2. Получение метаданных NFT (Ethereum)

            // Метаданные NFT за 32ms

            curl -X POST https://rpc.blockflow.io/v1/eth/mainnet \

              -H "Content-Type: application/json" \

              -H "X-API-Key: YOUR_API_KEY" \

              -d '{

                        "jsonrpc": "2.0",

                        "method": "nft_getMetadata",

                        "params": ["0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d", "1"],

                        "id": 1

                      }'

3. Получение баланса (Solana)

            // Баланс за 28ms

            curl -X POST https://rpc.blockflow.io/v1/sol/mainnet \

              -H "Content-Type: application/json" \

              -H "X-API-Key: YOUR_API_KEY" \

              -d '{

                        "jsonrpc": "2.0",

                        "method": "indexer_getBalance",

                        "params": ["9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWV"],

                        "id": 1

                      }'

4. Получение истории транзакций (Ethereum)

            // Транзакции адреса за последние 100 блоков

            curl -X POST https://rpc.blockflow.io/v1/eth/mainnet \

              -H "Content-Type: application/json" \

              -H "X-API-Key: YOUR_API_KEY" \

              -d '{

                        "jsonrpc": "2.0",

                        "method": "indexer_getTransactions",

                        "params": ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e", 100, "desc"],

                        "id": 1

                      }'

5. WebSocket подключение (реалтайм)

            // Подписка на новые блоки Ethereum

            wscat -c wss://rpc.blockflow.io/ws/v1/eth/mainnet \

              -H "X-API-Key: YOUR_API_KEY"

            // Отправка сообщения

            {

              "jsonrpc": "2.0",

              "method": "eth_subscribe",

              "params": ["newHeads"],

              "id": 1

            }

Коды ошибок

Стандартные коды ошибок JSON‑RPC с дополнительными пояснениями.

Код	Описание	Решение
`-32700`	Некорректный JSON	Проверьте синтаксис JSON
`-32600`	Неверный формат запроса	Проверьте структуру RPC-запроса
`-32601`	Метод не найден	Проверьте правильность имени метода
`-32602`	Неверные параметры	Проверьте типы и количество параметров
`-32000`	Внутренняя ошибка сервера	Повторите запрос позже
`-32001`	Превышен лимит запросов	Обновите тариф или подождите
`-32002`	Неверный API-ключ	Проверьте ключ в заголовке

Документация API