Get Cardano stake distribution information for a specific epoch

Changed on

Returns the information of a Cardano stake distribution at a given epoch

get/artifact/cardano-stake-distribution/epoch/{epoch}

Request

  • Base URL: https://aggregator.release-preprod.api.mithril.network/aggregator
  • URL: https://aggregator.release-preprod.api.mithril.network/aggregator/artifact/cardano-stake-distribution/epoch/{epoch}
  • Auth: none declared

Path parameters

integer required

Cardano chain epoch number

OR
string required

Use the latest epoch with an optional offset

Example:419

Epoch of the Cardano stake distribution to retrieve

Response

Cardano stake distribution found

epochinteger required

Cardano chain epoch number

hashstring bytes required

Hash of the Cardano stake distribution

certificate_hashstring bytes required

Hash of the associated certificate

stake_distributionobject required

The list of Stake Pool Operator pool identifiers with their associated stake in the Cardano chain

created_atstring date-time, required

Date and time of the entity creation

Example response

{
  "epoch": 123,
  "hash": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732",
  "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572",
  "stake_distribution": {
    "pool15ka28a4a3qxgcgh60wavkylku4vqjg385jezsrqxlafyrhahf02": 1192520901428,
    "pool1aymf474uv528zafxlpfg3yr55zp267wj5mpu4qt557z5k5frn9p": 1009503382720
  },
  "created_at": "2022-06-14T10:52:31Z"
}

Changes

  • 86cd66899d91Revision changes
    • info

      for the path request parameter epoch, the type was generalized from integer to no type, and format from int64 to no format

  • 1b81bf42f34bRevision changes
    • breaking

      for the path request parameter epoch, the type changed from no type to integer, and format from no format to int64