Delegate Representatives (DReps)

Return the information about Delegate Representatives (DReps)

get/governance/dreps

Query parameters

countinteger

The number of results displayed on one page.

pageinteger

The page number for listing the results.

order'asc' | 'desc'

The ordering of items. Direction applied to whichever sort key is selected by order_by. By default, when sorting by registration order, we return oldest first, newest last.

order_by'amount'

Optional sort key. When omitted, DReps are ordered by their internal registration order (the current default). Set to amount to sort by voting power.

retiredboolean

Optional filter. When true, only returns DReps that have been deregistered. When false, only returns DReps that are currently registered. When omitted, both are returned.

expiredboolean

Optional filter. When true, only returns DReps that have been inactive for longer than the drep_activity protocol parameter. When false, only returns DReps that are not expired. When omitted, both are returned.

Response

Paginated array with the Delegate Representatives (DReps) data

drep_idstring required

The Bech32 encoded DRep address

hexstring required

The raw bytes of the DRep

amountstring required

The total amount of voting power this DRep is delegated.

has_scriptboolean required

Flag indicating whether this DRep's credential is a script hash

retiredboolean required

Registration state of the DRep. Set to true if the DRep has been deregistered; otherwise, false.

expiredboolean required

Whether the DRep has been inactive for a consecutive number of epochs (determined by an epoch parameter drep_activity)

last_active_epochinteger nullable required

Epoch of the most recent action - registration, update, deregistration or voting

Example response

[
  {
    "drep_id": "drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn",
    "hex": "db1bc3c3f99ce68977ceaf27ab4dd917123ef9e73f85c304236eab23",
    "amount": "2000000",
    "has_script": false,
    "retired": false,
    "expired": false,
    "last_active_epoch": 509,
    "metadata": {
      "url": "https://aaa.xyz/drep.json",
      "hash": "a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de",
      "json_metadata": {
        "@context": {
          "CIP100": "https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#",
          "CIP119": "https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#"
        },
        "hashAlgorithm": "blake2b-256",
        "body": {
          "givenName": "Ryan Williams",
          "objectives": "Buy myself an island.",
          "motivations": "I really would like to own an island.",
          "qualifications": "I have my 100m swimming badge."
        }
      },
      "bytes": "\\x7b0a20202240636f6e74657874223a..."
    }
  },
  {
    "drep_id": "drep1cxayn4fgy27yaucvhamsvqj3v6835mh3tjjx6x8hdnr4",
    "hex": "c1ba49d52822bc4ef30cbf77060251668f1a6ef15ca46d18f76cc758",
    "amount": "0",
    "has_script": false,
    "retired": true,
    "expired": false,
    "last_active_epoch": 480,
    "metadata": null
  }
]