🚀 Getting started

Introduction
Request Authentication
API Endpoints
Thank you

📖 blockbook API

General Info
Status
- List available blockchainsget
- Blockchain Info Summaryget
Blocks
Transactions
Addresses
Tickers
- Get Tickers list V2get
- Get Tickers V2get
Fee Estimation
- Estimate transaction fee V2get
NFT
- Get NFT metadata V2get
JSON-RPC
- JSON-RPC Endpointpost
- JSON-RPC over HTTPget
Websocket

📡 JSON-RPC

Ethereum / EVM-based chains
- Example: eth_blockNumberpost
- Archive Data
Bitcoin-like blockchains (BTC/LTC/DOGE)
XRP Ledger (Ripple)
Monero (XMR)

🌹 Cardano Rosetta API

Getting started with Cardano
Network
Block
- Get a Blockpost
- Get a Block Transactionpost
Mempool
- Get All Mempool Transactionspost
- Get a Mempool Transactionpost
Account
- Get an Account's Balancepost
- Get an Account's Unspent Coinspost
Construction
Call
- Make a Network-Specific Procedure Callpost
Events
- [INDEXER] Get a range of BlockEventspost
Search
- [INDEXER] Search for Transactionspost

⚖ Legal stuff

Legal Notice (Impressum)
Privacy Policy
Terms and Conditions
Service Level Agreement (SLA)
Cancellation Notice

🚀 Getting started

Introduction
Request Authentication
API Endpoints
Thank you

📖 blockbook API

General Info
Status
- List available blockchainsget
- Blockchain Info Summaryget
Blocks
Transactions
Addresses
Tickers
- Get Tickers list V2get
- Get Tickers V2get
Fee Estimation
- Estimate transaction fee V2get
NFT
- Get NFT metadata V2get
JSON-RPC
- JSON-RPC Endpointpost
- JSON-RPC over HTTPget
Websocket

📡 JSON-RPC

Ethereum / EVM-based chains
- Example: eth_blockNumberpost
- Archive Data
Bitcoin-like blockchains (BTC/LTC/DOGE)
XRP Ledger (Ripple)
Monero (XMR)

🌹 Cardano Rosetta API

Getting started with Cardano
Network
Block
- Get a Blockpost
- Get a Block Transactionpost
Mempool
- Get All Mempool Transactionspost
- Get a Mempool Transactionpost
Account
- Get an Account's Balancepost
- Get an Account's Unspent Coinspost
Construction
Call
- Make a Network-Specific Procedure Callpost
Events
- [INDEXER] Get a range of BlockEventspost
Search
- [INDEXER] Search for Transactionspost

⚖ Legal stuff

Legal Notice (Impressum)
Privacy Policy
Terms and Conditions
Service Level Agreement (SLA)
Cancellation Notice

[INDEXER] Get a range of BlockEvents

post https://rpc.chain49.com/cardano/events/blocks

/events/blocks allows the caller to query a sequence of BlockEvents indicating which blocks were added and removed from storage to reach the current state. Following BlockEvents allows lightweight clients to update their state without needing to implement their own syncing logic (like finding the common parent in a reorg). /events/blocks is considered an "indexer" endpoint and Rosetta implementations are not required to complete it to adhere to the Rosetta spec. However, any Rosetta "indexer" MUST support this endpoint.

URL Expired

The URL for this request expired after 30 days.

Body Params

network_identifier

object

required

The network_identifier specifies which network a particular object is associated with.

offset

int64

≥ 0

offset is the offset into the event stream to sync events from. If this field is not populated, we return the limit events backwards from tip. If this is set to 0, we start from the beginning.

limit

int64

≥ 0

limit is the maximum number of events to fetch in one call. The implementation may return <= limit events.

Responses

Response body

object

max_sequence

int64

required

≥ 0

max_sequence is the maximum available sequence number to fetch.

events

array of objects

required

events is an array of BlockEvents indicating the order to add and remove blocks to maintain a canonical view of blockchain state. Lightweight clients can use this event stream to update state without implementing their own block syncing logic.

events*

object

sequence

int64

required

≥ 0

sequence is the unique identifier of a BlockEvent within the context of a NetworkIdentifier.

block_identifier

object

required

The block_identifier uniquely identifies a block in a particular network.

type

string

required

BlockEventType determines if a BlockEvent represents the addition or removal of a block.

block_added block_removed

Response body

object

code

int32

required

≥ 0

Code is a network-specific error code. If desired, this code can be equivalent to an HTTP status code.

message

string

required

Message is a network-specific error message. The message MUST NOT change for a given code. In particular, this means that any contextual information should be included in the details field.

description

string

Description allows the implementer to optionally provide additional information about an error. In many cases, the content of this field will be a copy-and-paste from existing developer documentation. Description can ONLY be populated with generic information about a particular type of error. It MUST NOT be populated with information about a particular instantiation of an error (use details for this). Whereas the content of Error.Message should stay stable across releases, the content of Error.Description will likely change across releases (as implementers improve error documentation). For this reason, the content in this field is not part of any type assertion (unlike Error.Message).

retriable

boolean

required

An error is retriable if the same request may succeed if submitted again.

details

object

Often times it is useful to return context specific to the request that caused the error (i.e. a sample of the stack trace or impacted account) in addition to the standard error message.

Has additional fields

Updated almost 2 years ago

Make a Network-Specific Procedure Call

Did this page help you?

Language

Credentials

Header

URL


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://rpc.chain49.com/cardano/events/blocks \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "network_identifier": {
8
    "blockchain": "cardano",
9
    "network": "mainnet"
10
  }
11
}
12
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated almost 2 years ago

Make a Network-Specific Procedure Call

Did this page help you?

🚀 Getting started
Introduction
Request Authentication
API Endpoints
Thank you

📖 blockbook API
General Info
Status
Blockchain Info Summaryget
List available blockchainsget
Blocks
Get raw block data V2get
Get block hash V2get
Get Block V2get
Transactions
Get Mempool V2get
Send transaction (POST) V2post
Send transaction (in URL) V2get
Get transaction (as is from Backend) V2get
Get transaction V2get
Addresses
Get Balance History V2get
Get UTXO V2get
Get xpub V2get
Get address V2get
Tickers
Get Tickers V2get
Get Tickers list V2get
Fee Estimation
Estimate transaction fee V2get
NFT
Get NFT metadata V2get
JSON-RPC
JSON-RPC over HTTPget
JSON-RPC Endpointpost
Websocket

📡 JSON-RPC
Ethereum / EVM-based chains
Archive Data
Example: eth_blockNumberpost
Bitcoin-like blockchains (BTC/LTC/DOGE)
XRP Ledger (Ripple)
Monero (XMR)

🌹 Cardano Rosetta API
Getting started with Cardano
Network
Get Network Optionspost
Get Network Statuspost
Get List of Available Networkspost
Block
Get a Block Transactionpost
Get a Blockpost
Mempool
Get a Mempool Transactionpost
Get All Mempool Transactionspost
Account
Get an Account's Unspent Coinspost
Get an Account's Balancepost
Construction
Submit a Signed Transactionpost
Get the Hash of a Signed Transactionpost
Parse a Transactionpost
Create Network Transaction from Signaturespost
Generate an Unsigned Transaction and Signing Payloadspost
Get Metadata for Transaction Constructionpost
Create a Request to Fetch Metadatapost
Derive an AccountIdentifier from a PublicKeypost
Call
Make a Network-Specific Procedure Callpost
Events
[INDEXER] Get a range of BlockEventspost
Search
[INDEXER] Search for Transactionspost

🚀 Getting started
Introduction
Request Authentication
API Endpoints
Thank you

📖 blockbook API
General Info
Status
Blockchain Info Summaryget
List available blockchainsget
Blocks
Get raw block data V2get
Get block hash V2get
Get Block V2get
Transactions
Get Mempool V2get
Send transaction (POST) V2post
Send transaction (in URL) V2get
Get transaction (as is from Backend) V2get
Get transaction V2get
Addresses
Get Balance History V2get
Get UTXO V2get
Get xpub V2get
Get address V2get
Tickers
Get Tickers V2get
Get Tickers list V2get
Fee Estimation
Estimate transaction fee V2get
NFT
Get NFT metadata V2get
JSON-RPC
JSON-RPC over HTTPget
JSON-RPC Endpointpost
Websocket

📡 JSON-RPC
Ethereum / EVM-based chains
Archive Data
Example: eth_blockNumberpost
Bitcoin-like blockchains (BTC/LTC/DOGE)
XRP Ledger (Ripple)
Monero (XMR)

🌹 Cardano Rosetta API
Getting started with Cardano
Network
Get Network Optionspost
Get Network Statuspost
Get List of Available Networkspost
Block
Get a Block Transactionpost
Get a Blockpost
Mempool
Get a Mempool Transactionpost
Get All Mempool Transactionspost
Account
Get an Account's Unspent Coinspost
Get an Account's Balancepost
Construction
Submit a Signed Transactionpost
Get the Hash of a Signed Transactionpost
Parse a Transactionpost
Create Network Transaction from Signaturespost
Generate an Unsigned Transaction and Signing Payloadspost
Get Metadata for Transaction Constructionpost
Create a Request to Fetch Metadatapost
Derive an AccountIdentifier from a PublicKeypost
Call
Make a Network-Specific Procedure Callpost
Events
[INDEXER] Get a range of BlockEventspost
Search
[INDEXER] Search for Transactionspost

200Expected response to a valid request

500unexpected error