Перейти к содержимому
/
Get a specific block

Vilna API (1.0.0)

Добро пожаловать в справочник Vilna API. Это полная спецификация OpenAPI для всех endpoints API.

Быстрые ссылки

API Endpoints

Управление активами

  • Активы - Обнаружение и управление цифровыми активами

Операции с адресами

Мониторинг и уведомления

Система

Нужна помощь?

Посетите наш портал документации для подробных руководств и примеров.

Скачать описание OpenAPI
spec.json
spec.yaml
Обзор
URL
https://vilna.io
Vilna API Team
[email protected]
Лицензия
Apache 2.0
Условия предоставления услуг
Языки
Серверы
Mock server
https://docs.vilna.io/_mock/ru/apis/spec/
Production environment
https://{namespace}.vilna.app/{version}/

system

System and service status operations

Операции

blockchain

Operations related to supported blockchains for monitoring and balance queries

Операции

block

Operations for retrieving and filtering blockchain blocks

Операции

Get blocks across blockchains

Запрос

Returns a paginated list of blocks from all or specified blockchains.

Безопасность
ApiKeyAuth
Запрос
pageinteger>= 1

Page number for pagination

По умолчанию 1
Пример: page=1
limitinteger[ 1 .. 100 ]

Maximum number of items to return

По умолчанию 20
Пример: limit=20
sort_bystring

Field to sort results by. Use "-" prefix for descending order

По умолчанию "number"
Перечисление"number""-number""status""-status"
Пример: sort_by=number
chain_gidsArray of strings(ChainGID)

Comma-separated list of chain GIDs to filter blocks by.

Пример: chain_gids=eip155:1&chain_gids=eip155:137
statusesArray of strings

Comma-separated list of block statuses to include.

Элементы Перечисление"new""fetched""processed""confirmed""reorged"
Пример: statuses=confirmed&statuses=processed
from_blockinteger(int64)>= 0

Start from this block number (inclusive).

Пример: from_block=18500000
to_blockinteger(int64)>= 0

End at this block number (inclusive).

Пример: to_block=18500100
curl -i -X GET \
  'https://docs.vilna.io/_mock/ru/apis/spec/blocks?page=1&limit=20&sort_by=number&chain_gids=eip155%3A1%2Ceip155%3A137&statuses=confirmed%2Cprocessed&from_block=18500000&to_block=18500100' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Ответы

List of blockchain blocks with their processing status

Телоapplication/json
itemsArray of objects(Block)обязательный
items[].​chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$обязательный

Blockchain identifier according to CAIP-2.

The chain_gid is a case-sensitive string uniquely identifying a blockchain. It is composed of:

  • namespace — a short identifier describing an ecosystem or standard (e.g. eip155, cosmos)
  • reference — an identifier for a specific blockchain within that namespace

Syntax

chain_id = namespace ":" reference
namespace = [-a-z0-9]{3,8}
reference = [-_a-zA-Z0-9]{1,32}

Examples

  • eip155:1 — Ethereum mainnet
  • eip155:56 — Binance Smart Chain
  • cosmos:cosmoshub-4 — Cosmos Hub mainnet
  • bip122:000000000019d6689c085ae165831e93 — Bitcoin mainnet
Пример: "eip155:1"
items[].​numberinteger(int64)обязательный

Block number/height on the blockchain

Пример: 18500000
items[].​hashstring

Block hash identifier unique per blockchain (null if not yet fetched)

Пример: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
items[].​statusstringобязательный

Current processing status of the block:

  • new: Block has been discovered but not yet fetched
  • processed: Block transactions have been analyzed and stored
  • confirmed: Block has reached minimum required confirmations
  • reorged: Block has been reorganized (chain reorg occurred)
Перечисление"new""processed""confirmed""reorged"
Пример: "confirmed"
metaobject(PaginationMeta)обязательный
meta.​limitinteger(uint)>= 1обязательный

Number of items per page

Пример: 20
meta.​pageinteger(uint)>= 1обязательный

Current page number

Пример: 1
meta.​totalinteger(uint)>= 0обязательный

Total number of items available

Пример: 42
meta.​total_pagesinteger(uint)>= 0обязательный

Total number of pages available

Пример: 3
Ответ
application/json
{
  "items": [
    { … },
    { … },
    { … },
    { … }
  ],
  "meta": {
    "limit": 20,
    "page": 1,
    "total": 18500001,
    "total_pages": 925001
  }
}

Get a specific block

Запрос

Returns details of a specific block by its number for a given blockchain.

Безопасность
ApiKeyAuth
Путь
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$обязательный

Blockchain identifier in CAIP-2 format (namespace:reference)

Пример: eip155:1
block_numberinteger(int64)>= 0обязательный

Block number/height on the blockchain

Пример: 18500000
curl -i -X GET \
  https://docs.vilna.io/_mock/ru/apis/spec/blocks/eip155:1/18500000 \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Ответы

Single blockchain block

Телоapplication/json
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$обязательный

Blockchain identifier according to CAIP-2.

The chain_gid is a case-sensitive string uniquely identifying a blockchain. It is composed of:

  • namespace — a short identifier describing an ecosystem or standard (e.g. eip155, cosmos)
  • reference — an identifier for a specific blockchain within that namespace

Syntax

chain_id = namespace ":" reference
namespace = [-a-z0-9]{3,8}
reference = [-_a-zA-Z0-9]{1,32}

Examples

  • eip155:1 — Ethereum mainnet
  • eip155:56 — Binance Smart Chain
  • cosmos:cosmoshub-4 — Cosmos Hub mainnet
  • bip122:000000000019d6689c085ae165831e93 — Bitcoin mainnet
Пример: "eip155:1"
numberinteger(int64)обязательный

Block number/height on the blockchain

Пример: 18500000
hashstring

Block hash identifier unique per blockchain (null if not yet fetched)

Пример: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
statusstringобязательный

Current processing status of the block:

  • new: Block has been discovered but not yet fetched
  • processed: Block transactions have been analyzed and stored
  • confirmed: Block has reached minimum required confirmations
  • reorged: Block has been reorganized (chain reorg occurred)
Перечисление"new""processed""confirmed""reorged"
Пример: "confirmed"
Ответ
application/json
{
  "chain_gid": "eip155:1",
  "number": 18500000,
  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "status": "confirmed"
}

token

Manage blockchain tokens such as native and ERC-20 assets

Операции

public_key

Public key (BIP44/49/84) management operations for HD wallets

Операции

address

Address management operations for tracking blockchain addresses

Операции

notification_channel

Notification delivery channel management for alerts and event notifications

Операции

transaction

Blockchain transaction tracking and monitoring operations

Операции

simulate

Transaction simulation operations for various blockchain networks

asset

Asset management operations for blockchain assets

Операции