Listing of previous epochs

GET /epochs/:number/previous

Return the list of epochs preceding a specific epoch.

Request

Path Parameters

number integer required
Number of the epoch
Example: 225

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 epoch data

application/json

Schema

Example (from schema)

---

Schema

• Array [
epoch integer required

Epoch number

start_time integer required

Unix time of the start of the epoch

end_time integer required

Unix time of the end of the epoch

first_block_time integer required

Unix time of the first block of the epoch

last_block_time integer required

Unix time of the last block of the epoch

block_count integer required

Number of blocks within the epoch

tx_count integer required

Number of transactions within the epoch

output string required

Sum of all the transactions within the epoch in Lovelaces

fees string required

Sum of all the fees within the epoch in Lovelaces

active_stake string nullable required

Sum of all the active stakes within the epoch in Lovelaces

• ]

[
  {
    "epoch": 225,
    "start_time": 1603403091,
    "end_time": 1603835086,
    "first_block_time": 1603403092,
    "last_block_time": 1603835084,
    "block_count": 21298,
    "tx_count": 17856,
    "output": "7849943934049314",
    "fees": "4203312194",
    "active_stake": "784953934049314"
  }
]

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...