Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cardano Cardano » Blocks API

The Cardano » Blocks API from Cardano — 11 operation(s) for cardano » blocks.

Cardano Cardano » Blocks API is one of 21 APIs that Cardano publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Cardano » Blocks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and rate-limit docs.

This API exposes 11 operations across 11 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 0.1.89.

Requests are made against 4 base URLs: https://cardano-mainnet.blockfrost.io/api/v0, https://cardano-preprod.blockfrost.io/api/v0, https://cardano-preview.blockfrost.io/api/v0, https://localhost:3000.

11 operations 11 paths 5 schemas 11 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
0.1.89
Base URL
https://cardano-mainnet.blockfrost.io/api/v0
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Cardano Cardano » Blocks API declares 1 security scheme for authenticating requests. An API key is passed in the header as project_id (project_id). By default, every request must be authenticated.

  • project_id — There are multiple token types available based on network you choose when creating a Blockfrost a project, for a list of token types see available networks.

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 11 GET. Each is listed below with its method, path, parameters, and response codes.

Cardano » Blocks 11
GET
/blocks/latest
Latest block
→ 200400403404418429500
GET
/blocks/latest/txs
Latest block transactions
3 params → 200400403404418429500
GET
/blocks/latest/txs/cbor
Latest block transactions with CBOR data
3 params → 200400403404418429500
GET
/blocks/{hash_or_number}
Specific block
1 param → 200400403404418429500
GET
/blocks/{hash_or_number}/next
Listing of next blocks
3 params → 200400403404418429500
GET
/blocks/{hash_or_number}/previous
Listing of previous blocks
3 params → 200400403404418429500
GET
/blocks/slot/{slot_number}
Specific block in a slot
1 param → 200400403404418429500
GET
/blocks/epoch/{epoch_number}/slot/{slot_number}
Specific block in a slot in an epoch
2 params → 200400403404418429500
GET
/blocks/{hash_or_number}/txs
Block transactions
4 params → 200400403404418429500
GET
/blocks/{hash_or_number}/txs/cbor
Block transactions with CBOR data
4 params → 200400403404418429500
GET
/blocks/{hash_or_number}/addresses
Addresses affected in a specific block
3 params → 200400403404418429500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed is block_content (17 properties). Each schema is shown below with its type and property counts.

block_content_addresses
array
block_content_txs_cbor
array
block_content_txs
array
block_content
object
17 properties 17 required
block_content_array
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cardano-cardano-blocks-api-openapi.yml Raw ↑

Other APIs Cardano publishes across the network.

Blockfrost IPFS API
Cardano Cardano » Accounts API
Cardano Cardano » Addresses API
Cardano Cardano » Assets API
Cardano Cardano » Epochs API
Cardano Cardano » Governance API
Cardano Cardano » Ledger API
Cardano Cardano » Mempool API
Cardano Cardano » Metadata API
Cardano Cardano » Network API
Cardano Cardano » Pools API
Cardano Cardano » Scripts API