🚀 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

Create a Request to Fetch Metadata

post https://rpc.chain49.com/cardano/construction/preprocess

Preprocess is called prior to /construction/payloads to construct a request for any metadata that is needed for transaction construction given (i.e. account nonce). The options object returned from this endpoint will be sent to the /construction/metadata endpoint UNMODIFIED by the caller (in an offline execution environment). If your Construction API implementation has configuration options, they MUST be specified in the /construction/preprocess request (in the metadata field).

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.

operations

array of objects

required

operations*

metadata

object

Responses

Response body

object

options

object

The options that will be sent directly to /construction/metadata by the caller.

Has additional fields

required_public_keys

array of objects

required_public_keys

object

address

string

required

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_account

object

An account may have state specific to a contract address (ERC-20 token) and/or a stake (delegated balance). The sub_account_identifier should specify which state (if applicable) an account instantiation refers to.

metadata

object

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Has additional fields

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

Derive an AccountIdentifier from a PublicKey

Get Metadata for Transaction Construction

Did this page help you?

Language

Credentials

Header

URL


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://rpc.chain49.com/cardano/construction/preprocess \
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

Derive an AccountIdentifier from a PublicKey

Get Metadata for Transaction Construction

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