Latest epoch

GET /epochs/latest

Return the information about the latest, therefore current, epoch.

Request

Responses

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

---

Return the data about the epoch

application/json

Schema

Example (from schema)

---

Schema

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