Listing of previous blocks

GET /blocks/:hash_or_number/previous

Return the list of blocks preceding a specific block.

Request

Path Parameters

hash_or_number 64-character case-sensitive hexadecimal string or block number. required
Hash of the requested block
Example: 4873401

Query Parameters

count integer

Possible values: >= 1 and <= 100

Default value: 100

The number of results displayed on one page.

page integer

Possible values: >= 1 and <= 21474836

Default value: 1

The page number for listing the results.

Responses

• 200
• 400
• 403
• 404
• 418
• 429
• 500

---

Return the contents of the block

application/json

Schema

Example (from schema)

---

Schema

• Array [
time integer required

Block creation time in UNIX time

height integer nullable required

Block number

hash string required

Hash of the block

slot integer nullable required

Slot number

epoch integer nullable required

Epoch number

epoch_slot integer nullable required

Slot within the epoch

slot_leader string required

Bech32 ID of the slot leader or specific block description in case there is no slot leader

size integer required

Block size in Bytes

tx_count integer required

Number of transactions in the block

output string nullable required

Total output within the block in Lovelaces

fees string nullable required

Total fees within the block in Lovelaces

block_vrf string nullable required

Possible values: >= 65 characters and <= 65 characters

VRF key of the block

op_cert string nullable required

The hash of the operational certificate of the block producer

op_cert_counter string nullable required

The value of the counter used to produce the operational certificate

previous_block string nullable required

Hash of the previous block

next_block string nullable required

Hash of the next block

confirmations integer required

Number of block confirmations

• ]

[
  {
    "time": 1641338934,
    "height": 15243593,
    "hash": "4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a",
    "slot": 412162133,
    "epoch": 425,
    "epoch_slot": 12,
    "slot_leader": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy",
    "size": 3,
    "tx_count": 1,
    "output": "128314491794",
    "fees": "592661",
    "block_vrf": "vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty",
    "op_cert": "da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c",
    "op_cert_counter": "18",
    "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
    "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
    "confirmations": 4698
  }
]

Bad request

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 400,
  "error": "Bad Request",
  "message": "Backend did not understand your request."
}

Authentication secret is missing or invalid

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 403,
  "error": "Forbidden",
  "message": "Invalid project token."
}

Component not found

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 404,
  "error": "Not Found",
  "message": "The requested component has not been found."
}

IP has been auto-banned for extensive sending of requests after usage limit has been reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 418,
  "error": "Requested Banned",
  "message": "IP has been auto-banned for flooding."
}

Usage limit reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 429,
  "error": "Project Over Limit",
  "message": "Usage is over limit."
}

Internal Server Error

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 500,
  "error": "Internal Server Error",
  "message": "An unexpected response was received from the backend."
}

Loading...