Перейти к содержимому
/
Update EVM blockchain con...

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

Операции

Get list of supported blockchains

Запрос

Returns a list of blockchains that are actively supported for monitoring and balance queries.

These are the blockchains where the system can track address balances, detect transactions, and send notifications about balance changes. While tokens can be sent on many blockchains, only those listed here have the infrastructure to monitor addresses and provide real-time updates.

Безопасность
ApiKeyAuth
Запрос
limitinteger[ 1 .. 100 ]

Maximum number of items to return

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

Page number for pagination

По умолчанию 1
Пример: page=1
sort_bystring

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

По умолчанию "name"
Перечисление"gid""-gid""name""-name""short_name""-short_name""full_name""-full_name"
Пример: sort_by=name
searchstring<= 64 characters

Performs a partial, case-insensitive match on blockchain name or short name fields.

Пример: search=ethereum
familiesArray of strings(ChainFamily)

Comma-separated list of chain families to include.

Элементы Перечисление"evm""bitcoin""solana""tron"
Пример: families=evm&families=bitcoin
is_activeboolean

When true, returns only active blockchains (being processed by workers). When false, returns only inactive ones.

Пример: is_active=true
curl -i -X GET \
  'https://docs.vilna.io/_mock/ru/apis/spec/blockchains?limit=20&page=1&sort_by=name&search=ethereum&families=evm%2Cbitcoin&is_active=true' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Ответы

List of supported blockchains for monitoring and balance queries

Телоapplication/json
itemsArray of objects(Blockchain)обязательный
items[].​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[].​image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
items[].​namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

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

Short abbreviation for the blockchain (e.g., eth)

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

Whether the blockchain is actively being processed

Пример: true
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": 50,
    "total_pages": 3
  }
}

Create a new supported blockchain

Запрос

Creates a new blockchain for monitoring and balance queries.

The blockchain must exist in the reference data with the provided chain_gid (CAIP-2 format). If the blockchain is not supported in the reference data, the request will be rejected.

Безопасность
ApiKeyAuth
Телоapplication/jsonобязательный

Blockchain creation request

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"
curl -i -X POST \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -d '{
    "chain_gid": "eip155:1"
  }'

Ответы

Successfully created blockchain

Телоapplication/json
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"
image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

Пример: "ethereum"
short_namestringобязательный

Short abbreviation for the blockchain (e.g., eth)

Пример: "eth"
is_activebooleanобязательный

Whether the blockchain is actively being processed

Пример: true
Ответ
application/json
{
  "gid": "eip155:1",
  "image_url": "https://cdn.vilna.io/assets/eip155:1/logo.png",
  "name": "ethereum",
  "short_name": "eth",
  "is_active": true
}

Get a single blockchain

Запрос

Returns details of a specific blockchain by its chain identifier.

This endpoint retrieves information about a blockchain that is supported for monitoring and balance queries. The blockchain must be actively configured in the system.

Безопасность
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
curl -i -X GET \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1 \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Ответы

Successfully created blockchain

Телоapplication/json
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"
image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

Пример: "ethereum"
short_namestringобязательный

Short abbreviation for the blockchain (e.g., eth)

Пример: "eth"
is_activebooleanобязательный

Whether the blockchain is actively being processed

Пример: true
Ответ
application/json
{
  "gid": "eip155:1",
  "image_url": "https://cdn.vilna.io/assets/eip155:1/logo.png",
  "name": "ethereum",
  "short_name": "eth",
  "is_active": true
}

Activate blockchain

Запрос

Activates a blockchain for monitoring and processing by workers.

Безопасность
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
curl -i -X POST \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1/actions/activate \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Ответы

Blockchain activated successfully

Ответ
Нет содержимого

Deactivate blockchain

Запрос

Deactivates a blockchain from monitoring and processing by workers.

Безопасность
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
curl -i -X POST \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1/actions/deactivate \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Ответы

Blockchain deactivated successfully

Ответ
Нет содержимого

Update EVM blockchain configuration

Запрос

Update the configuration of an existing EVM-compatible 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
Телоapplication/jsonобязательный
non-empty
endpoint_urlstring(uri)(EVMEndpointURL)

EVM blockchain RPC endpoint URL for API calls

Пример: "https://ethereum-rpc.publicnode.com"
websocket_urlstring(uri)(EVMWebSocketURL)

EVM blockchain WebSocket endpoint URL for real-time subscriptions

Пример: "wss://ethereum-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1/evm \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -d '{
    "endpoint_url": "https://ethereum-rpc.publicnode.com"
  }'

Ответы

Successfully created blockchain

Телоapplication/json
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"
image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

Пример: "ethereum"
short_namestringобязательный

Short abbreviation for the blockchain (e.g., eth)

Пример: "eth"
is_activebooleanобязательный

Whether the blockchain is actively being processed

Пример: true
Ответ
application/json
{
  "gid": "eip155:1",
  "image_url": "https://cdn.vilna.io/assets/eip155:1/logo.png",
  "name": "ethereum",
  "short_name": "eth",
  "is_active": true
}

Update Solana blockchain configuration

Запрос

Update the configuration of an existing Solana 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
Телоapplication/jsonобязательный
non-empty
endpoint_urlstring(uri)(SolanaEndpointURL)

Solana blockchain RPC endpoint URL for API calls

Пример: "https://solana-rpc.publicnode.com"
websocket_urlstring(uri)(SolanaWebSocketURL)

Solana blockchain WebSocket endpoint URL for real-time subscriptions

Пример: "wss://solana-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1/solana \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -d '{
    "endpoint_url": "https://solana-rpc.publicnode.com"
  }'

Ответы

Successfully created blockchain

Телоapplication/json
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"
image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

Пример: "ethereum"
short_namestringобязательный

Short abbreviation for the blockchain (e.g., eth)

Пример: "eth"
is_activebooleanобязательный

Whether the blockchain is actively being processed

Пример: true
Ответ
application/json
{
  "gid": "eip155:1",
  "image_url": "https://cdn.vilna.io/assets/eip155:1/logo.png",
  "name": "ethereum",
  "short_name": "eth",
  "is_active": true
}

Update Tron blockchain configuration

Запрос

Update the configuration of an existing Tron 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
Телоapplication/jsonобязательный
non-empty
evm_endpoint_urlstring(uri)(TronEVMEndpointURL)

Tron blockchain RPC endpoint URL for API calls

Пример: "https://tron-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1/tron \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -d '{
    "evm_endpoint_url": "https://evm-rpc.example.com"
  }'

Ответы

Successfully created blockchain

Телоapplication/json
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"
image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

Пример: "ethereum"
short_namestringобязательный

Short abbreviation for the blockchain (e.g., eth)

Пример: "eth"
is_activebooleanобязательный

Whether the blockchain is actively being processed

Пример: true
Ответ
application/json
{
  "gid": "eip155:1",
  "image_url": "https://cdn.vilna.io/assets/eip155:1/logo.png",
  "name": "ethereum",
  "short_name": "eth",
  "is_active": true
}

Update Bitcoin blockchain configuration

Запрос

Update the configuration of an existing Bitcoin 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
Телоapplication/jsonобязательный
non-empty
endpoint_urlstring(uri)(BitcoinEndpointURL)

Bitcoin blockchain RPC endpoint URL for API calls

Пример: "https://bitcoin-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/ru/apis/spec/blockchains/eip155:1/bitcoin \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -d '{
    "endpoint_url": "https://bitcoin-rpc.publicnode.com"
  }'

Ответы

Successfully created blockchain

Телоapplication/json
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"
image_urlstring(uri)обязательный

URL to blockchain logo image

Пример: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringобязательный

Unique identifier name for the blockchain (e.g., ethereum)

Пример: "ethereum"
short_namestringобязательный

Short abbreviation for the blockchain (e.g., eth)

Пример: "eth"
is_activebooleanобязательный

Whether the blockchain is actively being processed

Пример: true
Ответ
application/json
{
  "gid": "eip155:1",
  "image_url": "https://cdn.vilna.io/assets/eip155:1/logo.png",
  "name": "ethereum",
  "short_name": "eth",
  "is_active": true
}

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"
}

block

Operations for retrieving and filtering blockchain blocks

Операции

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

Операции