Specific account address

GET /accounts/:stake_address

Obtain information about a specific stake account.

Request

Path Parameters

stake_address string required
Bech32 stake address.
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Responses

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

---

Return the account content.

application/json

Schema

Example (from schema)

---

Schema

stake_address string required

Bech32 stake address

active boolean required

Registration state of an account

active_epoch integer nullable required

Epoch of the most recent action - registration or deregistration

controlled_amount string required

Balance of the account in Lovelaces

rewards_sum string required

Sum of all rewards for the account in the Lovelaces

withdrawals_sum string required

Sum of all the withdrawals for the account in Lovelaces

reserves_sum string required

Sum of all funds from reserves for the account in the Lovelaces

treasury_sum string required

Sum of all funds from treasury for the account in the Lovelaces

withdrawable_amount string required

Sum of available rewards that haven't been withdrawn yet for the account in the Lovelaces

pool_id string nullable required

Bech32 pool ID to which this account is delegated

drep_id string nullable required

Bech32 drep ID to which this account is delegated

{
  "stake_address": "stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7",
  "active": true,
  "active_epoch": 412,
  "controlled_amount": "619154618165",
  "rewards_sum": "319154618165",
  "withdrawals_sum": "12125369253",
  "reserves_sum": "319154618165",
  "treasury_sum": "12000000",
  "withdrawable_amount": "319154618165",
  "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
  "drep_id": "drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc"
}

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