Account reward history

GET /accounts/:stake_address/rewards

Obtain information about the reward history of a specific account.

Request

Path Parameters

stake_address string required
Bech32 stake address.
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

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.

order string

Possible values: [asc, desc]

Default value: asc

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

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

---

Return the account content.

application/json

Schema

Example (from schema)

---

Schema

• Array [
epoch integer required

Epoch of the associated reward

amount string required

Rewards for given epoch in Lovelaces

pool_id string required

Bech32 pool ID being delegated to

type string required

Possible values: [leader, member, pool_deposit_refund]

Type of the reward

• ]

[
  {
    "epoch": 215,
    "amount": "12695385",
    "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
    "type": "member"
  },
  {
    "epoch": 216,
    "amount": "3586329",
    "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
    "type": "member"
  },
  {
    "epoch": 217,
    "amount": "1",
    "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
    "type": "member"
  },
  {
    "epoch": 217,
    "amount": "1337",
    "pool_id": "pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs",
    "type": "leader"
  },
  {
    "epoch": 218,
    "amount": "1395265",
    "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
    "type": "member"
  },
  {
    "epoch": 218,
    "amount": "500000000",
    "pool_id": "pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs",
    "type": "pool_deposit_refund"
  }
]

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