Skip To Content

Blockdaemon Documentation

Blocks

Overview
GET Current Block ID (V1)
GET Current Block Number (V1)
GET Block by Number/Hash (V1)
GET Block Identifier by Number/Hash (V1)
GET All Block Identifiers (V1)
GET Current Block ID (V2)
GET Current Block Number (V2)
GET Block by Number/Hash (V2)
GET Block Identifier by Number/Hash (V2)
GET All Block Identifiers (V2)


Overview

The Ubiquity Universal API endpoints listed in this section allow the retrieval of information about blocks for a given protocol and network.

As with all Ubiquity Universal API endpoints, they provide a standard format to obtain consistent information across multiple protocols.


GET Current Block ID (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/sync/block_id

Returns the id (hash) of the current block.

Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
Bitcoin CashMainnet
Testnet
bitcoincash/mainnet
bitcoincash/testnet
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
LitecoinMainnet
Testnet
litecoin/mainnet
litecoin/testnet
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
SolanaMainnetsolana/mainnet
StellarMainnetstellar/mainnet
TerraMainnet
Testnet
terra/mainnet
terra/testnet
TezosMainnettezos/mainnet
XRPMainnetxrp/mainnet

GET Current Block Number (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/sync/block_number

Returns the number of the current block.

Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
Bitcoin CashMainnet
Testnet
bitcoincash/mainnet
bitcoincash/testnet
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
LitecoinMainnet
Testnet
litecoin/mainnet
litecoin/testnet
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
SolanaMainnetsolana/mainnet
StellarMainnetstellar/mainnet
TerraMainnet
Testnet
terra/mainnet
terra/testnet
TezosMainnettezos/mainnet
XRPMainnetxrp/mainnet

GET Block by Number/Hash (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/block/{key}

Returns a block and all its transactions by a given block number or hash.

Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also is required to add a block number or block hash, e.g.:

  • 14621155
  • 0x2444165297806ad5598e4569e5823b3df0cde3e48b346781ab632fa6cef1a0ec

Note: In some networks you can get blocks only by number. See below to learn more.

Supported Protocols and Networks

Here is a full list of supported protocols and networks. It also includes their path parameters and the available ways to get blocks.

ProtocolNetworkPath parametersGet block by
AlgorandMainnetalgorand/mainnetblock number
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
block number or hash
block number or hash
Bitcoin CashMainnet
Testnet
bitcoincash/mainnet
bitcoincash/testnet
block number or hash
block number or hash
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
block number or hash
block number or hash
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
block number or hash
block number or hash
LitecoinMainnet
Testnet
litecoin/mainnet
litecoin/testnet
block number or hash
block number or hash
NEARMainnetnear/mainnetblock number or hash
OasisMainnetoasis/mainnetblock number
PolkadotMainnetpolkadot/mainnetblock number or hash
SolanaMainnetsolana/mainnetblock number
StellarMainnetstellar/mainnetblock number
TerraMainnet
Testnet
terra/mainnet
terra/testnet
block number
block number
TezosMainnettezos/mainnetblock number or hash
XRPMainnetxrp/mainnetblock number or hash

GET Block Identifier by Number/Hash (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/block_identifier/{key}

Returns a block identifier by a given block number or hash.

Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also is required to add a block number or block hash, e.g.:

  • 14621155
  • 0x2444165297806ad5598e4569e5823b3df0cde3e48b346781ab632fa6cef1a0ec

Note: In some networks you can get block identifiers only by number. See below to learn more.

Supported Protocols and Networks

Here is a full list of supported protocols and networks. It also includes their path parameters and the available ways to get block identifiers.

ProtocolNetworkPath parametersGet block identifier by
AlgorandMainnetalgorand/mainnetblock number
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
block number or hash
block number or hash
Bitcoin CashMainnet
Testnet
bitcoincash/mainnet
bitcoincash/testnet
block number or hash
block number or hash
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
block number or hash
block number or hash
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
block number or hash
block number or hash
LitecoinMainnet
Testnet
litecoin/mainnet
litecoin/testnet
block number or hash
block number or hash
NEARMainnetnear/mainnetblock number
OasisMainnetoasis/mainnetblock number
PolkadotMainnetpolkadot/mainnetblock number or hash
SolanaMainnetsolana/mainnetblock number
StellarMainnetstellar/mainnetblock number
TerraMainnet
Testnet
terra/mainnet
terra/testnet
block number
block number
TezosMainnettezos/mainnetblock number or hash
XRPMainnetxrp/mainnetblock number or hash

GET All Block Identifiers (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/block_identifiers

Returns all block identifiers in the network, starting with the oldest one.

Learn how to authorize your request: Authentication Guide

Note: By default, each call returns 25 blocks. Use the returned continuation token as a parameter to get the next part.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
Bitcoin CashMainnet
Testnet
bitcoincash/mainnet
bitcoincash/testnet
LitecoinMainnet
Testnet
litecoin/mainnet
litecoin/testnet
TezosMainnettezos/mainnet

GET Current Block ID (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/sync/block_id

Returns the id (hash) of the current block.

Developer documentation: GET Current Block ID (V2)
Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
DiemMainnetdiem/mainnet
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
StellarMainnetstellar/mainnet
XRPMainnetxrp/mainnet

GET Current Block Number (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/sync/block_number

Returns the number of the current block.

Developer documentation: GET Current Block Number (V2)
Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
DiemMainnetdiem/mainnet
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
StellarMainnetstellar/mainnet
XRPMainnetxrp/mainnet

GET Block by Number/Hash (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/block/{key}

Returns a block and all its transactions by a given block number or hash.

Developer documentation: GET Block by Number/Hash (V2)
Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also is required to add a block number or block hash, e.g.:

  • 14621155
  • 0x2444165297806ad5598e4569e5823b3df0cde3e48b346781ab632fa6cef1a0ec

Note: In some networks you can get blocks only by number. See below to learn more.

Supported Protocols and Networks

Here is a full list of supported protocols and networks. It also includes their path parameters and the available ways to get blocks.

ProtocolNetworkPath parametersGet block by
AlgorandMainnetalgorand/mainnetblock number
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
block number or hash
block number or hash
DiemMainnetdiem/mainnetblock number
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
block number or hash
block number or hash
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
block number or hash
block number or hash
NEARMainnetnear/mainnetblock number or hash
OasisMainnetoasis/mainnetblock number
PolkadotMainnetpolkadot/mainnetblock number or hash
StellarMainnetstellar/mainnetblock number
XRPMainnetxrp/mainnetblock number or hash

GET Block Identifier by Number/Hash (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/block_identifier/{key}

Returns a block identifier by a given block number or hash.

Developer documentation: GET Block Identifier by Number/Hash (V2)
Learn how to authorize your request: Authentication Guide

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also is required to add a block number or block hash, e.g.:

  • 14621155
  • 0x2444165297806ad5598e4569e5823b3df0cde3e48b346781ab632fa6cef1a0ec

Note: In some networks you can get block identifiers only by number. See below to learn more.

Supported Protocols and Networks

Here is a full list of supported protocols and networks. It also includes their path parameters and the available ways to get block identifiers.

ProtocolNetworkPath parametersGet block identifier by
AlgorandMainnetalgorand/mainnetblock number
BitcoinMainnet
Testnet
bitcoin/mainnet
bitcoin/testnet
block number or hash
block number or hash
DiemMainnetdiem/mainnetblock number
DogecoinMainnet
Testnet
dogecoin/mainnet
dogecoin/testnet
block number or hash
block number or hash
EthereumMainnet
Ropsten
ethereum/mainnet
ethereum/ropsten
block number or hash
block number or hash
NEARMainnetnear/mainnetblock number
OasisMainnetoasis/mainnetblock number
PolkadotMainnetpolkadot/mainnetblock number or hash
StellarMainnetstellar/mainnetblock number
XRPMainnetxrp/mainnetblock number or hash

GET All Block Identifiers (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/block_identifiers

Returns all block identifiers in the network, starting with the oldest one.

Learn how to authorize your request: Authentication Guide

Note: By default, each call returns 25 blocks. Use the returned continuation token as a parameter to get the next part.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
BitcoinMainnetbitcoin/mainnet
EthereumMainnetethereum/mainnet
PolkadotMainnetpolkadot/mainnet

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.