Version: 1.0

Endpoints Summary

GET Latest block transactions
GET Transactions for a given block by block number
GET Transactions for a given block by block hash

GET Latest block transactions

Returns the transactions within the latest block i.e. the tip of the blockchain.

GET /api/core/blocks/latest/transactions

👨‍💻 Code samples

Node.js

const CBI = await new CardanoBI({ apiKey: 'YOUR-KEY', apiSecret: 'YOUR-SECRET' }); 
const transactions_transactions = await CBI.core.blocks.latest.transactions_();
console.log(transactions_transactions); 

Python

CBI = CardanoBI(apiKey='YOUR-KEY', apiSecret='YOUR-SECRET' }); 
transactions_transactions = await CBI.core.blocks.latest.transactions_();
print(transactions_transactions); 

Rust

let CBI = CardanoBI::new(Some("YOUR-KEY"), Some("YOUR-SECRET")).await.expect("Failed to initialize CardanoBI");
let transactions_transactions = CBI.core.blocks.latest.transactions_(HashMap::new()).await.expect("Failed to call endpoint");
println!("transactions_transactions: {:?}", transactions_transactions); 

💌 Response Codes

200

OK: Successful request.

[
 {
  "id": 94211802,
  "hash": "6mZYHIlu2YAhxBxk4RdPIGRfVDkEES7h2bi3Tl5xOSU=",
  "block_id": 10595156,
  "block_index": 0,
  "out_sum": 24895471551,
  "fee": 176809,
  "deposit": 0,
  "size": 476,
  "invalid_before": null,
  "invalid_hereafter": 129151032,
  "valid_contract": true,
  "script_size": 0,
  "hash_hex": "ea66581c896ed98021c41c64e1174f20645f543904112ee1d9b8b74e5e713925",
  "block": null
 },
 "...",
 {
  "id": 94211816,
  "hash": "DsZ2XXf1RFFPahPoBeJUxkWJfFweQ8MVUQDA5B9GnVY=",
  "block_id": 10595156,
  "block_index": 14,
  "out_sum": 811470770,
  "fee": 506105,
  "deposit": 0,
  "size": 7966,
  "invalid_before": null,
  "invalid_hereafter": 129144653,
  "valid_contract": true,
  "script_size": 0,
  "hash_hex": "0ec6765d77f544514f6a13e805e254c645897c5c1e43c3155100c0e41f469d56",
  "block": null
 }
]

400

Bad Request: The request was unacceptable, often due to missing a required parameter.

Response schema is undefined.

401

Unauthorized: No valid API key provided.

Response schema is undefined.

402

Quota Exceeded: This API key has reached its usage limit on request.

Response schema is undefined.

403

Access Denied: The request is missing a valid API key or token.

Response schema is undefined.

404

Not Found: The requested resource cannot be found.

Response schema is undefined.

429

Too Many Requests: This API key has reached its rate limit.

Response schema is undefined.

💌 Response Schemas

200

Status Code 200

Name	Type	Description
id	integer(int64)	The transaction unique identifier.
hash	string(byte)	The hash identifier of the transaction.
block_id	integer(int64)	The Block table index of the block that contains this transaction.
block_index	integer(int32)	The index of this transaction with the block (zero based).
out_sum	number(double)	The sum of the transaction outputs (in Lovelace).
fee	number(double)	The fees paid for this transaction.
deposit	integer(int64)	Deposit (or deposit refund) in this transaction. Deposits are positive, refunds negative.
size	integer(int32)	The size of the transaction in bytes.
invalid_before	number(double)	Transaction in invalid before this slot number.
invalid_hereafter	number(double)	Transaction in invalid at or after this slot number.
valid_contract	boolean	False if the contract is invalid. True if the contract is valid or there is no contract.
script_size	integer(int32)	The sum of the script sizes (in bytes) of scripts in the transaction.
hash_hex	string	The hexadecimal encoding of the hash identifier of the transaction.
block	Block	undefined

Block

Name	Type	Description
id	integer(int64)	The block unique identifier.
hash	string(byte)	The hash identifier of the block.
epoch_no	integer(int32)	The epoch number.
slot_no	integer(int64)	The slot number.
epoch_slot_no	integer(int32)	The slot number within an epoch (resets to zero at the start of each epoch).
block_no	integer(int32)	The block number.
previous_id	integer(int64)	The Block table index of the previous block.
slot_leader_id	integer(int64)	The SlotLeader table index of the creator of this block.
size	integer(int32)	The block size (in bytes). Note, this size value is not expected to be the same as the sum of the tx sizes due to the fact that txs being stored in segwit format and oddities in the CBOR encoding.
time	string(date-time)	The block time (UTCTime).
tx_count	integer(int64)	The number of transactions in this block.
proto_major	integer(int32)	The block's major protocol number.
proto_minor	integer(int32)	The block's major protocol number.
vrf_key	string	The VRF key of the creator of this block.
op_cert	string(byte)	The hash of the operational certificate of the block producer.
op_cert_counter	integer(int64)	The value of the counter used to produce the operational certificate.
hash_hex	string	The hexadecimal encoding of the block hash.
op_cert_hex	string	The hexadecimal encoding of the block producer operational certificate's hash.

400

Status Code 400

Name	Type	Description

Response schema is undefined.

401

Status Code 401

Name	Type	Description

Response schema is undefined.

402

Status Code 402

Name	Type	Description

Response schema is undefined.

403

Status Code 403

Name	Type	Description

Response schema is undefined.

404

Status Code 404

Name	Type	Description

Response schema is undefined.

429

Status Code 429

Name	Type	Description

Response schema is undefined.

GET Transactions for a given block by block number

Returns the transactions within one specific block given its number.

GET /api/core/blocks/{block_no}/transactions

🎰 Parameters

Name	Description	In	Type	Required
block_no	Block number	path	integer	true

👨‍💻 Code samples

Node.js

const CBI = await new CardanoBI({ apiKey: 'YOUR-KEY', apiSecret: 'YOUR-SECRET' }); 
const transactions = await CBI.core.blocks.transactions_({ block_no: 8415364 });
console.log(transactions); 

Python

CBI = CardanoBI(apiKey='YOUR-KEY', apiSecret='YOUR-SECRET' }); 
transactions = await CBI.core.blocks.transactions_(block_no=8415364);
print(transactions); 

Rust

let CBI = CardanoBI::new(Some("YOUR-KEY"), Some("YOUR-SECRET")).await.expect("Failed to initialize CardanoBI");
let transactions_transactions = CBI.core.blocks.transactions_(Some(8415364), HashMap::new()).await.expect("Failed to call endpoint");
println!("transactions_transactions: {:?}", transactions_transactions); 

💌 Response Codes

200

OK: Successful request.

[
 {
  "id": 61552864,
  "hash": "vbiA3P2tGL5KMOKrD7SLPtHv+Jp+OYifjmh5/8cxPwI=",
  "block_id": 8416431,
  "block_index": 0,
  "out_sum": 11747435254,
  "fee": 183987,
  "deposit": 0,
  "size": 269,
  "invalid_before": null,
  "invalid_hereafter": 85169296,
  "valid_contract": true,
  "script_size": 0,
  "hash_hex": "bdb880dcfdad18be4a30e2ab0fb48b3ed1eff89a7e39889f8e6879ffc7313f02",
  "block": null
 },
 "...",
 {
  "id": 61552883,
  "hash": "9a9HKyCMLzYmvNnrq1EDzFsW8Xmem2VMsDpNBUCQc3E=",
  "block_id": 8416431,
  "block_index": 19,
  "out_sum": 41068697259,
  "fee": 207345,
  "deposit": 0,
  "size": 1035,
  "invalid_before": null,
  "invalid_hereafter": 85172931,
  "valid_contract": true,
  "script_size": 0,
  "hash_hex": "f5af472b208c2f3626bcd9ebab5103cc5b16f1799e9b654cb03a4d0540907371",
  "block": null
 }
]

400

Bad Request: The request was unacceptable, often due to missing a required parameter.

Response schema is undefined.

401

Unauthorized: No valid API key provided.

Response schema is undefined.

402

Quota Exceeded: This API key has reached its usage limit on request.

Response schema is undefined.

403

Access Denied: The request is missing a valid API key or token.

Response schema is undefined.

404

Not Found: The requested resource cannot be found.

Response schema is undefined.

429

Too Many Requests: This API key has reached its rate limit.

Response schema is undefined.

💌 Response Schemas

200

Status Code 200

Name	Type	Description
id	integer(int64)	The transaction unique identifier.
hash	string(byte)	The hash identifier of the transaction.
block_id	integer(int64)	The Block table index of the block that contains this transaction.
block_index	integer(int32)	The index of this transaction with the block (zero based).
out_sum	number(double)	The sum of the transaction outputs (in Lovelace).
fee	number(double)	The fees paid for this transaction.
deposit	integer(int64)	Deposit (or deposit refund) in this transaction. Deposits are positive, refunds negative.
size	integer(int32)	The size of the transaction in bytes.
invalid_before	number(double)	Transaction in invalid before this slot number.
invalid_hereafter	number(double)	Transaction in invalid at or after this slot number.
valid_contract	boolean	False if the contract is invalid. True if the contract is valid or there is no contract.
script_size	integer(int32)	The sum of the script sizes (in bytes) of scripts in the transaction.
hash_hex	string	The hexadecimal encoding of the hash identifier of the transaction.
block	Block	undefined

Block

Name	Type	Description
id	integer(int64)	The block unique identifier.
hash	string(byte)	The hash identifier of the block.
epoch_no	integer(int32)	The epoch number.
slot_no	integer(int64)	The slot number.
epoch_slot_no	integer(int32)	The slot number within an epoch (resets to zero at the start of each epoch).
block_no	integer(int32)	The block number.
previous_id	integer(int64)	The Block table index of the previous block.
slot_leader_id	integer(int64)	The SlotLeader table index of the creator of this block.
size	integer(int32)	The block size (in bytes). Note, this size value is not expected to be the same as the sum of the tx sizes due to the fact that txs being stored in segwit format and oddities in the CBOR encoding.
time	string(date-time)	The block time (UTCTime).
tx_count	integer(int64)	The number of transactions in this block.
proto_major	integer(int32)	The block's major protocol number.
proto_minor	integer(int32)	The block's major protocol number.
vrf_key	string	The VRF key of the creator of this block.
op_cert	string(byte)	The hash of the operational certificate of the block producer.
op_cert_counter	integer(int64)	The value of the counter used to produce the operational certificate.
hash_hex	string	The hexadecimal encoding of the block hash.
op_cert_hex	string	The hexadecimal encoding of the block producer operational certificate's hash.

400

Status Code 400

Name	Type	Description

Response schema is undefined.

401

Status Code 401

Name	Type	Description

Response schema is undefined.

402

Status Code 402

Name	Type	Description

Response schema is undefined.

403

Status Code 403

Name	Type	Description

Response schema is undefined.

404

Status Code 404

Name	Type	Description

Response schema is undefined.

429

Status Code 429

Name	Type	Description

Response schema is undefined.

GET Transactions for a given block by block hash

Returns the transactions within one specific block given its hash.

GET /api/core/blocks/{block_hash}/transactions

🎰 Parameters

Name	Description	In	Type	Required
block_hash	Block hash	path	string	true

👨‍💻 Code samples

Node.js

const CBI = await new CardanoBI({ apiKey: 'YOUR-KEY', apiSecret: 'YOUR-SECRET' }); 
const transactions = await CBI.core.blocks.transactions_({ block_hash: "89ff1090614105a919c9ccc8bb3914aaef1ddd28214a4d55ff65436d2c9fc0b2" });
console.log(transactions); 

Python

CBI = CardanoBI(apiKey='YOUR-KEY', apiSecret='YOUR-SECRET' }); 
transactions = await CBI.core.blocks.transactions_(block_hash='89ff1090614105a919c9ccc8bb3914aaef1ddd28214a4d55ff65436d2c9fc0b2');
print(transactions); 

Rust

let CBI = CardanoBI::new(Some("YOUR-KEY"), Some("YOUR-SECRET")).await.expect("Failed to initialize CardanoBI");
let transactions_transactions = CBI.core.blocks.transactions_(Some("89ff1090614105a919c9ccc8bb3914aaef1ddd28214a4d55ff65436d2c9fc0b2"), HashMap::new()).await.expect("Failed to call endpoint");
println!("transactions_transactions: {:?}", transactions_transactions); 

💌 Response Codes

200

OK: Successful request.

[
 {
  "id": 61552864,
  "hash": "vbiA3P2tGL5KMOKrD7SLPtHv+Jp+OYifjmh5/8cxPwI=",
  "block_id": 8416431,
  "block_index": 0,
  "out_sum": 11747435254,
  "fee": 183987,
  "deposit": 0,
  "size": 269,
  "invalid_before": null,
  "invalid_hereafter": 85169296,
  "valid_contract": true,
  "script_size": 0,
  "hash_hex": "bdb880dcfdad18be4a30e2ab0fb48b3ed1eff89a7e39889f8e6879ffc7313f02",
  "block": null
 },
 "...",
 {
  "id": 61552883,
  "hash": "9a9HKyCMLzYmvNnrq1EDzFsW8Xmem2VMsDpNBUCQc3E=",
  "block_id": 8416431,
  "block_index": 19,
  "out_sum": 41068697259,
  "fee": 207345,
  "deposit": 0,
  "size": 1035,
  "invalid_before": null,
  "invalid_hereafter": 85172931,
  "valid_contract": true,
  "script_size": 0,
  "hash_hex": "f5af472b208c2f3626bcd9ebab5103cc5b16f1799e9b654cb03a4d0540907371",
  "block": null
 }
]

400

Bad Request: The request was unacceptable, often due to missing a required parameter.

Response schema is undefined.

401

Unauthorized: No valid API key provided.

Response schema is undefined.

402

Quota Exceeded: This API key has reached its usage limit on request.

Response schema is undefined.

403

Access Denied: The request is missing a valid API key or token.

Response schema is undefined.

404

Not Found: The requested resource cannot be found.

Response schema is undefined.

429

Too Many Requests: This API key has reached its rate limit.

Response schema is undefined.

💌 Response Schemas

200

Status Code 200

Name	Type	Description
id	integer(int64)	The transaction unique identifier.
hash	string(byte)	The hash identifier of the transaction.
block_id	integer(int64)	The Block table index of the block that contains this transaction.
block_index	integer(int32)	The index of this transaction with the block (zero based).
out_sum	number(double)	The sum of the transaction outputs (in Lovelace).
fee	number(double)	The fees paid for this transaction.
deposit	integer(int64)	Deposit (or deposit refund) in this transaction. Deposits are positive, refunds negative.
size	integer(int32)	The size of the transaction in bytes.
invalid_before	number(double)	Transaction in invalid before this slot number.
invalid_hereafter	number(double)	Transaction in invalid at or after this slot number.
valid_contract	boolean	False if the contract is invalid. True if the contract is valid or there is no contract.
script_size	integer(int32)	The sum of the script sizes (in bytes) of scripts in the transaction.
hash_hex	string	The hexadecimal encoding of the hash identifier of the transaction.
block	Block	undefined

Block

Name	Type	Description
id	integer(int64)	The block unique identifier.
hash	string(byte)	The hash identifier of the block.
epoch_no	integer(int32)	The epoch number.
slot_no	integer(int64)	The slot number.
epoch_slot_no	integer(int32)	The slot number within an epoch (resets to zero at the start of each epoch).
block_no	integer(int32)	The block number.
previous_id	integer(int64)	The Block table index of the previous block.
slot_leader_id	integer(int64)	The SlotLeader table index of the creator of this block.
size	integer(int32)	The block size (in bytes). Note, this size value is not expected to be the same as the sum of the tx sizes due to the fact that txs being stored in segwit format and oddities in the CBOR encoding.
time	string(date-time)	The block time (UTCTime).
tx_count	integer(int64)	The number of transactions in this block.
proto_major	integer(int32)	The block's major protocol number.
proto_minor	integer(int32)	The block's major protocol number.
vrf_key	string	The VRF key of the creator of this block.
op_cert	string(byte)	The hash of the operational certificate of the block producer.
op_cert_counter	integer(int64)	The value of the counter used to produce the operational certificate.
hash_hex	string	The hexadecimal encoding of the block hash.
op_cert_hex	string	The hexadecimal encoding of the block producer operational certificate's hash.

400

Status Code 400

Name	Type	Description

Response schema is undefined.

401

Status Code 401

Name	Type	Description

Response schema is undefined.

402

Status Code 402

Name	Type	Description

Response schema is undefined.

403

Status Code 403

Name	Type	Description

Response schema is undefined.

404

Status Code 404

Name	Type	Description

Response schema is undefined.

429

Status Code 429

Name	Type	Description

Response schema is undefined.