Download OpenAPI specification:Download
This API provides reporting staking data on various protocols as well as network wide data, staking transaction crafting features and so on. In order to use it, you should first get an API token from your Kiln dashboard (applications section). If you don't have access to our dashboard, please get in touch at hello@kiln.fi. Once you have your API token, you can set it as a bearer token in your request headers.
Kiln considers the following changes to be backward compatible:
Non-breaking changes may be introduced silently in our API and subject to modification before being officialy communicated and documented here. Your application should not depend on them until part of this specification. The experimental Kiln API specifications can be found here.
For example, Kiln may introduce in its API a new route or a new field to an existing response, not listed as part of this specification, update it in a non-backward compatible way, until being considered production-ready and part of this specification. The moment these changes are part of this specification, Kiln ensures all future changes around it are backward compatible, changelogs are communicated to customers and semver is appropriately updated.
Get the status of Ethereum stakes
validators | Array of strings Example: validators=0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412 Comma-separated list of validators addresses |
wallets | Array of strings Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2 Comma-separated list of wallets addresses |
accounts | Array of strings <uuid> Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f Comma-separated list of Kiln accounts identifiers |
{- "data": [
- {
- "validator_address": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412",
- "state": "active_ongoing",
- "activated_at": "2023-01-14T01:13:59Z",
- "activated_epoch": 174049,
- "delegated_block": 16397387,
- "deposit_tx_sender": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
- "execution_fee_recipient": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
- "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
- "effective_balance": "32000000000000000000",
- "balance": "32076187808000000000",
- "consensus_rewards": "76187808000000000",
- "execution_rewards": "0",
- "rewards": "76187808000000000",
- "gross_apy": 3.407,
- "updated_at": "2023-01-14T01:13:59Z"
}
]
}
Get historical rewards by day of Ethereum stakes
validators | Array of strings Example: validators=0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412 Comma-separated list of validators addresses |
wallets | Array of strings Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2 Comma-separated list of wallets addresses |
accounts | Array of strings <uuid> Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f Comma-separated list of Kiln accounts identifiers |
start_date | string <date> Example: start_date=2023-01-10 test-disabled: true Get rewards from this date (YYYY-MM-DD) |
end_date | string <date> Example: end_date=2023-01-20 test-disabled: true Get rewards to this date (YYYY-MM-DD) |
{- "data": [
- {
- "date": "2023-01-15",
- "consensus_rewards": "2988504000000000",
- "execution_rewards": "0",
- "rewards": "2988504000000000",
- "stake_balance": "64000000000000000000",
- "gross_apy": 3.407,
- "cl_apy": 3.407,
- "el_apy": 0
}
]
}
Create Ethereum validation keys on Kiln's infrastructure.
Ethereum keys to generate
account_id required | string <uuid> Kiln Account ID to stake into |
withdrawal_address required | string Ethereum withdrawal address used for the withdrawals credentials of the validators. BLS format is not supported. |
number required | number [ 1 .. 150 ] Number of validator keys to generate. You can generate up to 150 keys at once. |
format | string Default: "batch_deposit" extensible-enum: ["cli_deposit","batch_deposit"] Response format. Use "cli_deposit" for more information about each key. |
{- "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
- "withdrawal_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
- "number": 1,
- "format": "cli_deposit"
}
{- "data": [
- {
- "format": "cli_deposit",
- "pubkey": "8f36e2f4e921b1ed5ce9c94f21e1f26a748ac4e0c57f0d8973e7d576a2f8953b87dd86300de718238de23b1fecb19db5",
- "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
- "amount": 32000000000,
- "signature": "b7947eabf631d4772c4014a9fec2ecac2c15fc5175ad83023bbdfc9e6618cb8e78829231477c060bc9339482058ff195141f2aeb801c0329a1a4afebd7e76ce0ba1d9d88f8820d052836a79d59aea673db9eb5009db4a4f6e04fb7ffbdbdd604",
- "deposit_message_root": "65db6ae73c6465311a7acf2cd8a2863eececf09901872550639f0d8f6c1876f5",
- "deposit_data_root": "9b74cccf3a3c501374179be4bb6f505c4b40da41c205a101db3342a8df0af2dd",
- "fork_version": "00000000",
- "network_name": "mainnet",
- "deposit_cli_version": "2.2.0"
}
]
}