GET Move Instantaneous Rewards (MIR) history
Returns the MIR history of one account given its stake address.
GET /api/core/accounts/{stake_address}/mirs
🎰 Parameters
| Name | Description | In | Type | Required |
|---|---|---|---|---|
| stake_address | Bech32 Stake address | path | string | true |
👨💻 Code samples
- Node.js
- Python
- Rust
const CBI = await new CardanoBI({ apiKey: 'YOUR-KEY', apiSecret: 'YOUR-SECRET' });
const mirs = await CBI.core.accounts.mirs_({ stake_address: "stake1uypy44wqjznc5w9ns9gsguz4ta83jekrg9d0wupa7j3zsacwvq5ex" });
console.log(mirs);
CBI = CardanoBI(apiKey='YOUR-KEY', apiSecret='YOUR-SECRET' });
mirs = await CBI.core.accounts.mirs_(stake_address='stake1uypy44wqjznc5w9ns9gsguz4ta83jekrg9d0wupa7j3zsacwvq5ex');
print(mirs);
let CBI = CardanoBI::new(Some("YOUR-KEY"), Some("YOUR-SECRET")).await.expect("Failed to initialize CardanoBI");
let mirs_mirs = CBI.core.accounts.mirs_(Some("stake1uypy44wqjznc5w9ns9gsguz4ta83jekrg9d0wupa7j3zsacwvq5ex"), HashMap::new()).await.expect("Failed to call endpoint");
println!("mirs_mirs: {:?}", mirs_mirs);
💌 Response Codes
- 200
- 400
- 401
- 402
- 403
- 404
- 429
OK: Successful request.
[
{
"epoch_no": 241,
"block_no": 5196857,
"tx_hash_hex": "fabfad0aaa2b52b8304f45edc0350659ad0d73f9d1065d9cd3ef7d5a599ac57d",
"amount": 2000000000000,
"mir_type": "treasury"
},
"...",
{
"epoch_no": 409,
"block_no": 8722618,
"tx_hash_hex": "4b4ca196d524ae3877f772d5f0871e76aeedbf0330d2549178a834158593b299",
"amount": 8931404863383,
"mir_type": "treasury"
}
]
Bad Request: The request was unacceptable, often due to missing a required parameter.
Response schema is undefined.
Unauthorized: No valid API key provided.
Response schema is undefined.
Quota Exceeded: This API key has reached its usage limit on request.
Response schema is undefined.
Access Denied: The request is missing a valid API key or token.
Response schema is undefined.
Not Found: The requested resource cannot be found.
Response schema is undefined.
Too Many Requests: This API key has reached its rate limit.
Response schema is undefined.
💌 Response Schemas
- 200
- 400
- 401
- 402
- 403
- 404
- 429
Status Code 200
| Name | Type | Description |
|---|---|---|
| epoch_no | integer(int64) | The epoch number in which the given MIR occured. |
| block_no | integer(int64) | The block number for this MIR. |
| tx_hash_hex | string | The hexadecimal encoding of the hash identifier of the MIR transaction. |
| amount | integer(int64) | The MIR amount (in Lovelace). |
| mir_type | string | The source of the MIR payment (treasury or reserve). |
Status Code 400
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 401
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 402
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 403
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 404
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 429
| Name | Type | Description |
|---|
Response schema is undefined.