Search…
Reference
The Kiln API provides REST endpoints with JSON encoded requests and responses bodies. Our API is versioned, please use the documentation accordingly.

Authentication

The API uses API keys to authenticate requests. These API keys represent your account and its privileges, which is why you must keep them secure. Do not share nor upload them on public areas like GitHub or client-side applications.
You can get your token on the Dashboard by creating a new application.
You can then authenticate to Kiln API by setting the Authorization request header to Bearer $TOKEN with $TOKEN being your API key.
1
curl -X GET "https://api.kiln.fi/v1/eth/stakes" \
2
-H "Authorization: Bearer $TOKEN" \
3
-H "Content-Type: application/json"
Copied!
All API calls must be made with HTTPS, otherwise they will fail.

Environments

Kiln API is deployed in two blockchain environments: testnet and mainnet. Add a prefix to the API url to switch environment.
  • mainnet: https://api.kiln.fi/v1
  • testnet: https://api.testnet.kiln.fi/v1

Errors

Every response request uses the standard HTTP response codes and provides explicit error messages in the error response object which follows this structure:
1
{
2
"statusCode": 400,
3
"message": "The uploaded keystore is not compliant with eth2 standards"
4
}
Copied!