Skip to content
/
Get list of supported blo...

Vilna API (1.0.0)

Welcome to the Vilna API Reference. This is the complete OpenAPI specification for all API endpoints.

Quick Links

API Endpoints

Asset Management

  • Assets - Discover and manage digital assets

Address Operations

Monitoring and Notifications

System

Need Help?

Visit our documentation portal for detailed guides and examples.

Download OpenAPI description
spec.json
spec.yaml
Overview
URL
https://vilna.io
Vilna API Team
[email protected]
License
Apache 2.0
Terms of Service
Languages
Servers
Mock server
https://docs.vilna.io/_mock/apis/spec/
Production environment
https://{namespace}.vilna.app/{version}/

system

System and service status operations

Operations

blockchain

Operations related to supported blockchains for monitoring and balance queries

Operations

Get list of supported blockchains

Request

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.

Security
ApiKeyAuth
Query
limitinteger[ 1 .. 100 ]

Maximum number of items to return

Default 20
Example: limit=20
pageinteger>= 1

Page number for pagination

Default 1
Example: page=1
sort_bystring

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

Default "name"
Enum"gid""-gid""name""-name""short_name""-short_name""full_name""-full_name"
Example: sort_by=name
searchstring<= 64 characters

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

Example: search=ethereum
familiesArray of strings(ChainFamily)

Comma-separated list of chain families to include.

Items Enum"evm""bitcoin""solana""tron"
Example: families=evm&families=bitcoin
is_activeboolean

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

Example: is_active=true
curl -i -X GET \
  'https://docs.vilna.io/_mock/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'

Responses

List of supported blockchains for monitoring and balance queries

Bodyapplication/json
itemsArray of objects(Blockchain)required
items[].​gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
items[].​image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
items[].​namestringrequired

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

Example: "ethereum"
items[].​short_namestringrequired

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

Example: "eth"
items[].​is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
metaobject(PaginationMeta)required
meta.​limitinteger(uint)>= 1required

Number of items per page

Example: 20
meta.​pageinteger(uint)>= 1required

Current page number

Example: 1
meta.​totalinteger(uint)>= 0required

Total number of items available

Example: 42
meta.​total_pagesinteger(uint)>= 0required

Total number of pages available

Example: 3
Response
application/json
{
  "items": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ],
  "meta": {
    "limit": 20,
    "page": 1,
    "total": 50,
    "total_pages": 3
  }
}

Create a new supported blockchain

Request

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.

Security
ApiKeyAuth
Bodyapplication/jsonrequired

Blockchain creation request

chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Responses

Successfully created blockchain

Bodyapplication/json
gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringrequired

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

Example: "ethereum"
short_namestringrequired

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

Example: "eth"
is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
Response
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

Request

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.

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
curl -i -X GET \
  https://docs.vilna.io/_mock/apis/spec/blockchains/eip155:1 \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Responses

Successfully created blockchain

Bodyapplication/json
gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringrequired

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

Example: "ethereum"
short_namestringrequired

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

Example: "eth"
is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
Response
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

Request

Activates a blockchain for monitoring and processing by workers.

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
curl -i -X POST \
  https://docs.vilna.io/_mock/apis/spec/blockchains/eip155:1/actions/activate \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Responses

Blockchain activated successfully

Response
No content

Deactivate blockchain

Request

Deactivates a blockchain from monitoring and processing by workers.

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
curl -i -X POST \
  https://docs.vilna.io/_mock/apis/spec/blockchains/eip155:1/actions/deactivate \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Responses

Blockchain deactivated successfully

Response
No content

Update EVM blockchain configuration

Request

Update the configuration of an existing EVM-compatible blockchain

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
Bodyapplication/jsonrequired
non-empty
endpoint_urlstring(uri)(EVMEndpointURL)

EVM blockchain RPC endpoint URL for API calls

Example: "https://ethereum-rpc.publicnode.com"
websocket_urlstring(uri)(EVMWebSocketURL)

EVM blockchain WebSocket endpoint URL for real-time subscriptions

Example: "wss://ethereum-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/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"
  }'

Responses

Successfully created blockchain

Bodyapplication/json
gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringrequired

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

Example: "ethereum"
short_namestringrequired

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

Example: "eth"
is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
Response
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

Request

Update the configuration of an existing Solana blockchain

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
Bodyapplication/jsonrequired
non-empty
endpoint_urlstring(uri)(SolanaEndpointURL)

Solana blockchain RPC endpoint URL for API calls

Example: "https://solana-rpc.publicnode.com"
websocket_urlstring(uri)(SolanaWebSocketURL)

Solana blockchain WebSocket endpoint URL for real-time subscriptions

Example: "wss://solana-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/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"
  }'

Responses

Successfully created blockchain

Bodyapplication/json
gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringrequired

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

Example: "ethereum"
short_namestringrequired

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

Example: "eth"
is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
Response
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

Request

Update the configuration of an existing Tron blockchain

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
Bodyapplication/jsonrequired
non-empty
evm_endpoint_urlstring(uri)(TronEVMEndpointURL)

Tron blockchain RPC endpoint URL for API calls

Example: "https://tron-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/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"
  }'

Responses

Successfully created blockchain

Bodyapplication/json
gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringrequired

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

Example: "ethereum"
short_namestringrequired

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

Example: "eth"
is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
Response
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

Request

Update the configuration of an existing Bitcoin blockchain

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
Bodyapplication/jsonrequired
non-empty
endpoint_urlstring(uri)(BitcoinEndpointURL)

Bitcoin blockchain RPC endpoint URL for API calls

Example: "https://bitcoin-rpc.publicnode.com"
curl -i -X PATCH \
  https://docs.vilna.io/_mock/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"
  }'

Responses

Successfully created blockchain

Bodyapplication/json
gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
image_urlstring(uri)required

URL to blockchain logo image

Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"
namestringrequired

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

Example: "ethereum"
short_namestringrequired

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

Example: "eth"
is_activebooleanrequired

Whether the blockchain is actively being processed

Example: true
Response
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

Request

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

Security
ApiKeyAuth
Query
pageinteger>= 1

Page number for pagination

Default 1
Example: page=1
limitinteger[ 1 .. 100 ]

Maximum number of items to return

Default 20
Example: limit=20
sort_bystring

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

Default "number"
Enum"number""-number""status""-status"
Example: sort_by=number
chain_gidsArray of strings(ChainGID)

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

Example: chain_gids=eip155:1&chain_gids=eip155:137
statusesArray of strings

Comma-separated list of block statuses to include.

Items Enum"new""fetched""processed""confirmed""reorged"
Example: statuses=confirmed&statuses=processed
from_blockinteger(int64)>= 0

Start from this block number (inclusive).

Example: from_block=18500000
to_blockinteger(int64)>= 0

End at this block number (inclusive).

Example: to_block=18500100
curl -i -X GET \
  'https://docs.vilna.io/_mock/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'

Responses

List of blockchain blocks with their processing status

Bodyapplication/json
itemsArray of objects(Block)required
items[].​chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
items[].​numberinteger(int64)required

Block number/height on the blockchain

Example: 18500000
items[].​hashstring

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

Example: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
items[].​statusstringrequired

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)
Enum"new""processed""confirmed""reorged"
Example: "confirmed"
metaobject(PaginationMeta)required
meta.​limitinteger(uint)>= 1required

Number of items per page

Example: 20
meta.​pageinteger(uint)>= 1required

Current page number

Example: 1
meta.​totalinteger(uint)>= 0required

Total number of items available

Example: 42
meta.​total_pagesinteger(uint)>= 0required

Total number of pages available

Example: 3
Response
application/json
{
  "items": [
    { … },
    { … },
    { … },
    { … }
  ],
  "meta": {
    "limit": 20,
    "page": 1,
    "total": 18500001,
    "total_pages": 925001
  }
}

Get a specific block

Request

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

Security
ApiKeyAuth
Path
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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

Example: eip155:1
block_numberinteger(int64)>= 0required

Block number/height on the blockchain

Example: 18500000
curl -i -X GET \
  https://docs.vilna.io/_mock/apis/spec/blocks/eip155:1/18500000 \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

Responses

Single blockchain block

Bodyapplication/json
chain_gidstring(ChainGID)^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$required

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
Example: "eip155:1"
numberinteger(int64)required

Block number/height on the blockchain

Example: 18500000
hashstring

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

Example: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
statusstringrequired

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)
Enum"new""processed""confirmed""reorged"
Example: "confirmed"
Response
application/json
{
  "chain_gid": "eip155:1",
  "number": 18500000,
  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "status": "confirmed"
}

block

Operations for retrieving and filtering blockchain blocks

Operations

token

Manage blockchain tokens such as native and ERC-20 assets

Operations

public_key

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

Operations

address

Address management operations for tracking blockchain addresses

Operations

notification_channel

Notification delivery channel management for alerts and event notifications

Operations

transaction

Blockchain transaction tracking and monitoring operations

Operations

simulate

Transaction simulation operations for various blockchain networks

asset

Asset management operations for blockchain assets

Operations