This API specification is old and only here for reference, please refer to the latest stable version for production use.

logo
API docs by Redocly

Kiln API (1.2.0)

Download OpenAPI specification:Download

E-mail: contact@kiln.fi License: Apache 2.0 Terms of Service

This API provides reporting staking data on various protocols as well as network wide data, staking transaction crafting features and so on.

ACCESS

In order to use the Kiln API, you must 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 HTTP request headers, and target the Kiln API endpoint with the current MAJOR version of the API as a prefix to routes:

curl "https://api.kiln.fi/v1/..." -H "Authorization: Bearer $KILN_API_TOKEN"
If you need a development environment, please reach out to hello@kiln.fi to have a specific access to our testnet environment and dedicated API endpoint.

CHANGELOG

Version 1.2.0 (2023-09-06) [link]
  • ETH: Add the ability to specify a specific execution fee-recipient when generating Ethereum keys
  • ETH: Add new route GET /v1/eth/exit-messages to get GPG encrypted exit messages
  • ETH: Add optional pagination in the /v1/eth/stakes route
  • ETH: Add optional state filters in the /v1/eth/stakes route
  • ATOM: Add new route GET /v1/atom/stakes to list stakes
  • ATOM: Add new route GET /v1/atom/rewards to list rewards
  • ATOM: Add new method POST /v1/atom/stakes to link a stake to a Atom account
  • ATOM: Add new route GET /v1/atom/operations to to list operations
  • ATOM: Add new route GET /v1/atom/network-stats to view network statistics of Atom
  • ATOM: Add new route GET /v1/atom/reports to generate an Excel report of stakes and rewards
  • ATOM: Add new route POST /v1/atom/transaction/stake to generate a delegation transaction
  • ATOM: Add new route POST /v1/atom/transaction/withdraw-rewards to generate a withdraw-rewards transaction
  • ATOM: Add new route POST /v1/atom/transaction/unstake to generate an undelegate transaction
  • ATOM: Add new route POST /v1/atom/transaction/prepare to prepare a transaction for broadcasting from a payload and a signature
  • ATOM: Add new route POST /v1/atom/transaction/broadcast to broadcast a signed transaction
  • ATOM: Add new route GET /v1/atom/transaction/status to view the status of a broadcasted transaction
  • NEAR: Add new route GET /v1/near/stakes to list stakes
  • NEAR: Add new route GET /v1/near/rewards to list rewards
  • NEAR: Add new method POST /v1/near/stakes to link stakes to a Kiln account
  • NEAR: Add new route GET /v1/near/reports to generate an Excel report of stakes and rewards
  • NEAR: Add new route GET /v1/near/network-stats to view network statistics of NEAR
  • XTZ: Added new fields to GET /v1/xtz/stakes to reflect time and cycle of undelegation when applicable
  • SOL: Add sol_price_usd to /v1/sol/network-stats
  • SOL: Add updated_at to /v1/sol/network-stats
Version 1.1.0 (2023-06-19) [link]
  • ACCOUNTS: Add the ability to list Kiln account via GET /v1/accounts
  • ACCOUNTS: Add the ability to create Kiln account via POST /v1/accounts
  • ACCOUNTS: Add the ability to describe a Kiln account via GET /v1/account
  • ACCOUNTS: Add the ability to update a Kiln account via PUT /v1/account
  • ACCOUNTS: Add the ability to delete a Kiln account via DEL /v1/account
  • ACCOUNTS: Add the ability to get an account portfolio via GET /v1/accounts/{id}/portfolio
  • ORGANIZATIONS: Add the ability to get an organization portfolio via GET /v1/organizatrions/{id}/portfolio
  • ETH: Add the ability to query /v1/eth/stakes, /v1/eth/rewards, /v1/eth/operations by proxies and validator_indexes
  • ETH: Add validator_index in the responses of /v1/eth/stakes, /v1/eth/rewards and /v1/eth/operations
  • ETH: Add delegated_at field to /v1/eth/stakes
  • ETH: Add is_kiln field to /v1/eth/stakes
  • ETH: Add eth_price_usd to /v1/eth/netwok-stats
  • ETH: Add estimated_entry_time_seconds to /v1/eth/netwok-stats
  • ETH: Add estimated_exit_time_seconds to /v1/eth/netwok-stats
  • ETH: Add estimated_withdrawal_time_seconds to /v1/eth/netwok-stats
  • ETH: Add POST method to /v1/eth/stakes to link a stake to a Kiln account
  • ETH: Add new route GET /v1/eth/operations to list on-chain operations on a stake
  • ETH: Add new route GET /v1/eth/kiln-stats to expose Kiln operational statistics
  • ETH: Add new route POST /v1/eth/keys to generate ready-to-stake deposit data payloads
  • ETH: Add new route POST /v1/eth/transaction/stake to generate an EIP-1559 staking transaction ready to be signed
  • ETH: Add new route POST /v1/eth/transaction/prepare to craft a transaction ready to be broadcast from a payload and a signature
  • ETH: Add new route POST /v1/eth/transaction/broadcast to broadcast a signed transaction
  • ETH: Add new route GET /v1/eth/transaction/status to get the status of a broadcasted transaction
  • ETH: Add new route GET /v1/eth/reports to generate an Excel report of stakes and rewards
  • ETH: Use the protocol definition of effective balance in /v1/eth/rewards for the stake_balance field instead of a custom implementation
  • XTZ: Add new route GET /v1/xtz/stakes to list stakes
  • XTZ: Add new route GET /v1/xtz/rewards to list rewards
  • XTZ: Add new route GET /v1/xtz/operations to list on-chain operations of a stake
  • XTZ: Add new route GET /v1/xtz/network-stats to view network statistics of Tezos
  • XTZ: Add new route GET /v1/xtz/reports to generate an Excel report
  • XTZ: Add new route POST /v1/xtz/transaction/stake to generate a delegation transaction
  • XTZ: Add new route POST /v1/xtz/transaction/unstake to generate an undelegation transaction
  • XTZ: Add new route POST /v1/xtz/transaction/prepare to prepare a transaction for broadcasting from a payload and a signature
  • XTZ: Add new route POST /v1/xtz/transaction/broadcast to broadcast a signed transaction
  • XTZ: Add new route GET /v1/xtz/transaction/status to view the status of a broadcasted transaction
  • SOL: Add new route GET /v1/sol/stakes to list stakes
  • SOL: Add new method POST /v1/sol/stakes to link a stake to a Solana account
  • SOL: Add new route GET /v1/sol/rewards to list rewards
  • SOL: Add new route GET /v1/sol/operations to list on-chain operations of a stake
  • SOL: Add new route GET /v1/sol/network-stats to view network statistics of Solana
  • SOL: Add new route GET /v1/sol/reports to generate an Excel report
  • SOL: Add new route POST /v1/sol/transaction/stake to generate a delegation transaction
  • SOL: Add new route POST /v1/sol/transaction/deactivate-stake to generate a deactivate transaction
  • SOL: Add new route POST /v1/sol/transaction/withdraw-stake to prepare a withdraw stake transaction
  • SOL: Add new route POST /v1/sol/transaction/merge-stakes to prepare a merge stakes transaction
  • SOL: Add new route POST /v1/sol/transaction/split-stake to prepare a split stake transaction
  • SOL: Add new route POST /v1/sol/transaction/prepare to prepare any transaction from a payload and signature
  • SOL: Add new route POST /v1/sol/transaction/broadcast to broadcast a signed transaction
  • SOL: Add new route GET /v1/sol/transaction/status to view the status of a broadcasted transaction
  • ADA: Add new route POST /v1/ada/transaction/stake to generate a delegation transaction
  • ADA: Add new route POST /v1/ada/transaction/withdraw-rewards to generate a withdraw-rewards transaction
  • ADA: Add new route POST /v1/ada/transaction/unstake to generate an undelegate transaction
  • ADA: Add new route POST /v1/ada/transaction/prepare to prepare a transaction for broadcasting from a payload and a signature
  • ADA: Add new route POST /v1/ada/transaction/broadcast to broadcast a signed transaction
  • ADA: Add new route GET /v1/ada/transaction/status to view the status of a broadcasted transaction
  • MATIC: Add new route POST /v1/matic/transaction/approve to generate a transaction to allow a smart-contract to spend MATIC tokens on behalf of the user
  • MATIC: Add new route POST /v1/matic/transaction/buy-voucher to generate a transaction to buy shares from a validator
  • MATIC: Add new route POST /v1/matic/transaction/sell-voucher to generate a transaction to sell shares from a validator
  • MATIC: Add new route POST /v1/matic/transaction/unstake-claim-tokens to generate a transaction to withdraw unbounded tokens
  • MATIC: Add new route POST /v1/matic/transaction/withdraw-rewards to generate a transaction to withdraw rewards
  • MATIC: Add new route POST /v1/matic/transaction/restake-rewards to generate a transaction to restake rewards
  • MATIC: Add new route POST /v1/matic/transaction/prepare to prepare a signed transaction for broadcasting
  • MATIC: Add new route POST /v1/matic/transaction/broadcast to broadcast a prepared transaction
  • MATIC: Add new route GET /v1/matic/transaction/status to view the status of a broadcasted transaction
Version 1.0.0 (2023-01-01) [link]
  • ETH: Initial support of GET /v1/eth/stakes endpoint
  • ETH: Initial support of GET /v1/eth/rewards endpoint
  • ETH: Initial support of GET /v1/eth/network-stats endpoint
  • ETH: Initial support of GET /v1/eth/keys endpoint

VERSIONING

Versions of the Kiln API use MAJOR.MINOR.PATCH where:

  • MAJOR version is increased when there is major incompatible API changes, major versions will be communicated in advance to all customers with a smooth transition path that spans over a minimum period of 3 MINOR versions or ~3 months. Intended frequency: 1 year.
  • MINOR version is increased for backward compatible API changes without notice, or communicated breaking changes with a 1 minor version notice and a smooth migration path. Minor versions will be communicated regularly to customers with the changelog. Intended frequency: 1 month.
  • PATCH version is increased for backward compatible hot-fixes, patch versions will be communicated to affected customers.
Due to the nature of blockchains (protocol disappearing, breaking protocol upgrades), Kiln may introduce backward-incompatible changes in MINOR versions after following a 1 MINOR version deprecation path (~1 month). These impacting changes will be narrowed as much as possible to the protocol, heavily communicated with clear guidelines and support. Customer not relying on affected protocols will not be affected.

BACKWARD COMPATIBILITY

Kiln considers the following changes to be backward compatible:

  • Adding new API routes.
  • Adding new optional request parameters to existing API methods.
  • Adding new properties to existing API responses.
  • Changing the order of properties in existing API responses.
  • Adding new event types in existing enums.

Non-breaking changes may be introduced 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 preview Kiln API specifications with upcoming and experimental new features can be found here.

ACCOUNTS

Manage your Kiln accounts. Accounts are like folders in which you can organize your stakes or clients' stakes. An account can contain stakes on multiple protocols.

Accounts

Retrieve accounts in your organization

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "created_at": "2023-02-06T21:48:11.038Z",
      • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
      • "name": "account name",
      • "description": "account description"
      }
    ]
}

Accounts

Create a new account in your organization

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Account to create

name
required
string [ 1 .. 100 ] characters

Account name

description
required
string [ 0 .. 500 ] characters

Account description

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "name": "name",
  • "description": "description"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "name": "account name",
    • "description": "account description"
    }
}

Account

Retrieve an account in your organization

Authorizations:
bearerAuth
path Parameters
id
required
string <uuid>
Example: 92f5bfd4-ea38-4824-84f7-686eddff5539

Account id

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "name": "account name",
    • "description": "account description"
    }
}

Account

Update an account in your organization

Authorizations:
bearerAuth
path Parameters
id
required
string <uuid>
Example: 92f5bfd4-ea38-4824-84f7-686eddff5539

Account id

Request Body schema: application/json; charset=utf-8
required

Account to update

name
required
string [ 1 .. 100 ] characters

Account name

description
required
string [ 0 .. 500 ] characters

Account description

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "name": "name",
  • "description": "description"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "name": "account name",
    • "description": "account description"
    }
}

Account

Delete an account in your organization

Authorizations:
bearerAuth
path Parameters
id
required
string <uuid>
Example: 92f5bfd4-ea38-4824-84f7-686eddff5539

Account id

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "name": "account name",
    • "description": "account description"
    }
}

Account Portfolio

Retrieve an account asset portfolio. USD balances are calculated based on recent asset prices. We use CoinGecko API to retrieve asset prices.

Authorizations:
bearerAuth
path Parameters
id
required
string <uuid>
Example: 92f5bfd4-ea38-4824-84f7-686eddff5539

Account id

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "total_balance_usd": 182981229.16751668,
    • "total_rewards_usd": 4526.16751668,
    • "total_stakes": 56,
    • "total_active_stakes": 52,
    • "protocols": [
      • {
        • "token": "eth",
        • "name": "Ethereum",
        • "total_stakes": 12,
        • "total_active_stakes": 10,
        • "total_balance": {
          • "amount_usd": 10896.4568,
          • "amount": 1896.4563
          },
        • "total_rewards": {
          • "amount_usd": 10896.4568,
          • "amount": 1896.4568
          },
        • "balance_share_percent": 42.59,
        • "rewards_share_percent": 42.59
        }
      ]
    }
}

ORGANIZATIONS

Manage your Kiln organizations.

Organization Portfolio

Retrieve an organization asset portfolio. USD balances are calculated based on recent asset prices. We use CoinGecko API to retrieve asset prices.

Authorizations:
bearerAuth
path Parameters
id
required
string <uuid>
Example: 92f5bfd4-ea38-4824-84f7-686eddff5539

Organization id

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "total_balance_usd": 182981229.16751668,
    • "total_rewards_usd": 4526.16751668,
    • "total_stakes": 56,
    • "total_active_stakes": 52,
    • "protocols": [
      • {
        • "token": "eth",
        • "name": "Ethereum",
        • "total_stakes": 12,
        • "total_active_stakes": 10,
        • "total_balance": {
          • "amount_usd": 10896.4568,
          • "amount": 1896.4563
          },
        • "total_rewards": {
          • "amount_usd": 10896.4568,
          • "amount": 1896.4568
          },
        • "balance_share_percent": 42.59,
        • "rewards_share_percent": 42.59
        }
      ]
    }
}

ETH

Staking facilities for the Ethereum protocol

Stakes

Get the status of Ethereum stakes

Authorizations:
bearerAuth
query Parameters
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

proxies
Array of strings
Example: proxies=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of proxy-contract addresses

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

current_page
integer >= 1
Example: current_page=1

Current page to look-up entries. If not specified, pagination is disabled

page_size
integer [ 1 .. 100 ]
Default: 25
Example: page_size=1

Number of entries to list per page. Only used when current_page is specified

filter_states
Array of strings
Example: filter_states=deposit_in_progress,pending_initialized

Comma-separated list of states to filter on (see state for complete list)

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412",
      • "validator_index": "1",
      • "state": "active_ongoing",
      • "activated_at": "2023-01-14T01:13:59Z",
      • "activated_epoch": 174049,
      • "delegated_at": "2023-01-14T01:13:59Z",
      • "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,
      • "is_kiln": "true",
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

Create stakes

Link ETH stakes to a Kiln account

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stakes": [
    • {
      • "validator": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "tags": [
      • "tag1"
      ],
    • "metadata": { },
    • "protocol": "ethereum",
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of Ethereum stakes

Authorizations:
bearerAuth
query Parameters
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

proxies
Array of strings
Example: proxies=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of proxy-contract addresses

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

accounts
Array of strings <uuid> [ items <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

Get rewards from this date (YYYY-MM-DD)

end_date
string <date>
Example: end_date=2023-01-20

Get rewards to this date (YYYY-MM-DD)

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "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
      }
    ]
}

Operations

Get the operations of Ethereum stakes

Authorizations:
bearerAuth
query Parameters
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

proxies
Array of strings
Example: proxies=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of proxy-contract addresses

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "deposit",
      • "time": "2023-01-14T01:13:59Z",
      • "validator_address": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412",
      • "validator_index": 1,
      • "tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
      • "tx_sender": "0x41bf25fc8c52d292bd66d3bcecd8a919ecb9ef88",
      • "tx_gas_used": "2700999916653262",
      • "tx_effective_gas_price": "1499997889",
      • "proxies": [
        • "0x1e68238cE926DEC62b3FBC99AB06eB1D85CE0270",
        • "0x43244f90814b31dec250de24df5bb023eB1D85CE"
        ],
      • "block": 15955054,
      • "block_base_fee": "7",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "amount": "32000000000000000000000"
      }
    ]
}

Network Stats

Get some network statistics on Ethereum staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "eth_price_usd": 2000,
    • "estimated_entry_time_seconds": 3600,
    • "estimated_exit_time_seconds": 3600,
    • "estimated_withdrawal_time_seconds": 3600
    }
}

Kiln Stats

Get some Kiln statistics on Ethereum staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "gross_apy": {
      • "last_1d": 0,
      • "last_7d": 0,
      • "last_30d": 0
      }
    }
}

Validation Keys

Create Ethereum native validation keys on Kiln's infrastructure.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

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. This is the address that will receive consensus rewards. BLS format is not supported. This address is used as the execution-layer fee-recipient unless fee_recipient_address is specified.

fee_recipient_address
string

Ethereum fee-recipient address for execution rewards. Uses the withdrawal_address both for consensus and execution rewards if not specified.

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.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "withdrawal_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "fee_recipient_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "number": 1,
  • "format": "cli_deposit"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "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"
      }
    ]
}

Validation On-Chain Keys

Create Ethereum validation keys for the Kiln On-Chain smart-contract suite. This route is for Ethereum operators only of the Kiln On-Chain smart-contract. Use /v1/eth/keys if you want to use classic native staking.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Ethereum keys to generate

account_id
required
string <uuid>

Kiln Account ID to stake into.

number
required
number [ 1 .. 150 ]

Number of validator keys to generate. You can generate up to 150 keys at once.

fee_recipient_contract_address
string

Kiln V1 Smart-contract that will handle the dispatch of fees.

staking_contract_address
string

Kiln V1 Smart-contract used to stake generated keys.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "number": 1,
  • "fee_recipient_contract_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "staking_contract_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "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"
      }
    ]
}

Validation vSuite Keys

Create Ethereum validation keys for the Kiln vSuite smart-contract suite. This route is for Ethereum operators only of the Kiln vSuite smart-contract. Use /v1/eth/keys if you want to use classic native staking.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Ethereum keys to generate on withdrawal channel 0 of the vSuite contract

account_id
required
string <uuid>

Kiln Account ID to stake into.

number
required
number [ 1 .. 150 ]

Number of validator keys to generate. You can generate up to 150 keys at once.

factory_contract_address
string

Smart-Contract address on the Ethereum execution layer of the Kiln vSuite Factory.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "number": 1,
  • "factory_contract_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "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"
      }
    ]
}

Stake Transaction

Generates an Ethereum EIP 1559 stake transaction

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet to stake from and be used as a withdrawal credentials in the deposit. Losing access to this wallet will result in losing the stake.

amount_wei
required
string

Amount to stake in WEI (must be a multiple of "32000000000000000000")

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "amount_wei": "32000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc",
    • "to": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
    • "contract_call_data": "0xca0bfcce0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000002600000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000309696c02ec4dbb99f714e26ff1acdf6b258d36dcbad7b8b549553bc99b94ea639cd247f31683564995afd48568c1b6edd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060a3869da2ed5cc558f016d59fc5ceb0cac28e58743836aa3cf146221f1ef0b959e3cc5c589e05e171f1473596aadf36411767ad92edaae421ba0291bd7568267b3faabc3ab6ed9ddfc048ea6640370977f16f4f626a0e567a11ba25acdc520bb000000000000000000000000000000000000000000000000000000000000000012dd65914dda46639df6344701de54ac3ebe34a4b230262d3017fcd6c29954452",
    • "amount_wei": "32000000000000000000",
    • "nonce": 1,
    • "gas_limit": 140244,
    • "max_priority_fee_per_gas_wei": "2000000000",
    • "max_fee_per_gas_wei": "383687469748",
    • "chain_id": 1
    }
}

Prepare Transaction

Prepare an Ethereum transaction for broadcasting. It takes a serialized transaction and its signatures and returns a serialized signed transaction that can be broadcasted.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

r
required
string

r part of the ECDSA signature in hex

s
required
string

s part of the ECDSA signature in hex

v
required
number

v part of the ECDSA signature (0 or 1)

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc",
  • "r": "de28e9efee4c8de422a3c64bfaaee11a32f7cf12bdd3f00dcce41a79fe776c65",
  • "s": "3f233eb69495fa4741ad28ef0ba40612bacaf08331fd76041c371f5a2ecc2ab5",
  • "v": 0
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Broadcast Transaction

Broadcasts a signed Ethereum transaction

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94"
    }
}

Transaction Status

Get the status of an Ethereum transaction

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94

Hash of the transaction

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "success",
    • "receipt": {
      • "blockHash": "0x54a0603e3f39e5d358623c8cd86a628a2999c993c1bdd6e547c45632784bd1d7",
      • "blockNumber": 8608123,
      • "contractAddress": null,
      • "cumulativeGasUsed": 8180146,
      • "effectiveGasPrice": 27391741855,
      • "from": "0x9ce658155a6f05fe4aef83b7fa8f431d5e8ccb55",
      • "gasUsed": 70098,
      • "logs": [
        • {
          • "address": "0xff50ed3d0ec03aC01D4C79aAd74928BFF48a7b2b",
          • "blockHash": "0x54a0603e3f39e5d358623c8cd86a628a2999c993c1bdd6e547c45632784bd1d7",
          • "blockNumber": 8608123,
          • "data": "0x00000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000001800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000003093b5ae8053213154d099ed7fc99f571a0c8124601f8a59540335c7c35e0b40aad7b033f84af365185c04812acab257460000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200100000000000000000000009ce658155a6f05fe4aef83b7fa8f431d5e8ccb550000000000000000000000000000000000000000000000000000000000000008004059730700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000609395a07d5e7eb073725049ecba8144d850b7a1a58f603fd1fc12049d32c98db47e3d81608074bca20ccdcc94f7f4767d0d6b852edf4f6231532f33242e64d0617ac93465bc4cdabe9cebf0abe6d169830fcf375b28c0641487e5f86df2875a970000000000000000000000000000000000000000000000000000000000000008ecce030000000000000000000000000000000000000000000000000000000000",
          • "logIndex": 150,
          • "removed": false,
          • "topics": [
            • "0x649bbc62d0e31342afea4e5cd82d4049e7e1ee912fc0889aa790803be39038c5"
            ],
          • "transactionHash": "0x25f259a770539a4be99f972620b74219d67cd990d245bcc8d8ad5cddeaa37375",
          • "transactionIndex": 33,
          • "id": "log_4115d183"
          },
        • {
          • "address": "0x5FaDfdb7eFffd3B4AA03f0F29d9200Cf5F191F31",
          • "blockHash": "0x54a0603e3f39e5d358623c8cd86a628a2999c993c1bdd6e547c45632784bd1d7",
          • "blockNumber": 8608123,
          • "data": "0x000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000003093b5ae8053213154d099ed7fc99f571a0c8124601f8a59540335c7c35e0b40aad7b033f84af365185c04812acab257460000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200100000000000000000000009ce658155a6f05fe4aef83b7fa8f431d5e8ccb55",
          • "logIndex": 151,
          • "removed": false,
          • "topics": [
            • "0x737feedde71ce80c08f73125e4350b001be2dfb6a00fb455086c2b0a514cdfac"
            ],
          • "transactionHash": "0x25f259a770539a4be99f972620b74219d67cd990d245bcc8d8ad5cddeaa37375",
          • "transactionIndex": 33,
          • "id": "log_b4bb5ff7"
          }
        ],
      • "logsBloom": "0x00000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000008000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000008000000000000000000000000000000400000000000000000000000020000000000000000000000000040000000000000000000000000000020000000000000000000000000000000000000000000000000004000000000000000000000000000000000000008000000000000000000000004",
      • "status": true,
      • "to": "0x5fadfdb7efffd3b4aa03f0f29d9200cf5f191f31",
      • "transactionHash": "0x25f259a770539a4be99f972620b74219d67cd990d245bcc8d8ad5cddeaa37375",
      • "transactionIndex": 33,
      • "type": "0x2"
      }
    }
}

Excel Reports

Generates an Excel report sheet for your stakes and rewards

Authorizations:
bearerAuth
query Parameters
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> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Exit Messages

Get encrypted exit message for a validator. This route is available only on-demand, please reach out to contact@kiln.fi.

Authorizations:
bearerAuth
query Parameters
validators
Array of strings
Example: validators=0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412

Comma-separated list of validators addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412",
      • "gpg_public_key": "Hubert Bonisseur de La Bath (hubert) <hubert@kiln.fi>",
      • "payload": "-----BEGIN PGP MESSAGE-----\n\nhQEMAw2MqHavoVh9AQf/f5paxAuOB25SlXqKmLea0yHJBXnwuMuByfDZbXOBe4mD\niXz4ZJakeKGLbeJ/pP3Nwtu9vnIagQKF0YVNmrenkt8bL1jo/B6r34ycGIat/+GX\n1dc3GxyOBxju2q4JMe5chXdR4HXX3uU9QaynD24D5tsFgTxGM2I8JqV6BXEXgbBZ\nMXqtAjBcYd+krE1w135fuEYA6Nb/89QjLPcWXk92aS1K0WC39iAZxPsa7nyuhvRg\ndGXGQX+RrJ8jHAS4a074C3eAB3wCecvDk9d+FoUI3kaczUd4Ew7vUY0FX55oO60N\nqZxA5VwSHTfoH4fNPINeKr4Dx1mVLNcNM3z5qWcA6NKaAQak+arCnAYhLFCg/ydh\nzEcEWW1ebI4Ab3aweR17jme2I+XoWEwIBtUX7op6K7RUb3x9cBdGy4PDw6syBQJ3\nLExv8qZ43F9u0hD8UizpYQZESduT3x+To1/UQ3qBILuq2yszWaXP/kav1+fafLNb\nyEuHE2EoB27vDv6hSpwlDrXesGoMCc5NlAZBLnWiUcwzu2X19ASWnBSAmQ==\n=9AeP\n-----END PGP MESSAGE-----\n",
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

XTZ

Staking facilities for the Tezos protocol

Stakes

Get the status of Tezos stakes

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=tz1VZ4iC4wzTR7iK2Q7PoQGVDAojuY42fDxD

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "stake_address": "tz1VZ4iC4wzTR7iK2Q7PoQGVDAojuY42fDxD",
      • "baker_address": "tz2FCNBrERXtaTtNX6iimR1UJ5JSDxvdHM93",
      • "state": "active",
      • "activated_at": "2023-01-14T01:13:59Z",
      • "activated_cycle": 542,
      • "delegated_at": "2023-01-14T01:13:59Z",
      • "delegated_cycle": 542,
      • "delegated_block": "16397387",
      • "undelegated_at": "2023-01-14T01:13:59Z",
      • "undelegated_cycle": 542,
      • "balance": "32076187808000000000",
      • "wallet_balance": "32076187808000000000",
      • "rewards": "76187808000000000",
      • "gross_apy": 3.407,
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

Rewards

Get historical rewards of Tezos stakes

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=tz1VZ4iC4wzTR7iK2Q7PoQGVDAojuY42fDxD

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

format
string
extensible-enum: ["daily","cycle"]

The format of the response. Defaults to daily

start_date
string <date>
Example: start_date=2023-01-10

Get rewards from this date (YYYY-MM-DD)

end_date
string <date>
Example: end_date=2023-01-20

Get rewards to this date (YYYY-MM-DD)

start_cycle
number
Example: start_cycle=542

The cycle from which we want to fetch rewards. Must be used with format=cycle

end_cycle
number
Example: end_cycle=542

The cycle until which we want to fetch rewards. Must be used with format=cycle

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "27098488",
      • "active_balance": "420000000000",
      • "gross_apy": 3.42
      }
    ]
}

Operations

Get historical operations of Tezos stakes

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=tz1VZ4iC4wzTR7iK2Q7PoQGVDAojuY42fDxD

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "delegate",
      • "date": "2023-01-14T01:13:59Z",
      • "staker_address": "tz1QQZKGt3ouyd7x8JUDwcvRyxzsmD7CFbMd",
      • "baker_address": "tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez",
      • "operation": "opLq44uJLP7f3V3zCVDCDgXayV3CQLGqihdoAYtMnXLW4f1q2fb",
      • "operation_gas_used": "10",
      • "baker_fee": "42",
      • "block": 1342,
      • "amount": "420000"
      }
    ]
}

Network Stats

Get some network statistics on Tezos staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "nb_validators": 402,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "updated_at": "2023-01-14T01:13:59Z",
    • "xtz_price_usd": 3.5
    }
}

Excel Reports

Generates an Excel report sheet for your stakes and rewards

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=tz1VZ4iC4wzTR7iK2Q7PoQGVDAojuY42fDxD

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Stake Transaction

Generates a delegation transaction on Tezos

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet that you wish to delegate from

baker_address
required
string

Baker address to delegate to.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "wallet": "tz1QQZKGt3ouyd7x8JUDwcvRyxzsmD7CFbMd",
  • "baker_address": "tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "7383fbcd64c1d95c92b5ebee44a569f15e557a773b6d733ab7bb4e3ce98de812",
    • "unsigned_tx_serialized": "aef6da4e377364f07c2aa460d7148a8971dab767417b541fa473b2d8e038974f6e00566eaa0198f3df9230489abd1a64f5ef9b98b270940ac4cb9807f44e00ff00344c5e59a1de5370e1cee5d2fcf706a649bba15b",
    • "unsigned_tx": {
      • "branch": "BM3LZcG2SNz2DCWVGAAvT3gd8Vc17dS649CG6o9PhwJjmpUTptA",
      • "contents": [
        • {
          • "kind": "delegation",
          • "source": "tz1TX3Nh6h6js1VxXCuQ7rAF7LoGpd81FSw3",
          • "fee": "1300",
          • "counter": "15082948",
          • "gas_limit": "10100",
          • "storage_limit": "0",
          • "delegate": "tz1QQZKGt3ouyd7x8JUDwcvRyxzsmD7CFbMd"
          }
        ]
      }
    }
}

Unstake Transaction

Generates an undelegate transaction on Tezos

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet that you wish to undelegate

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "tz1QQZKGt3ouyd7x8JUDwcvRyxzsmD7CFbMd"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "7383fbcd64c1d95c92b5ebee44a569f15e557a773b6d733ab7bb4e3ce98de812",
    • "unsigned_tx_serialized": "aef6da4e377364f07c2aa460d7148a8971dab767417b541fa473b2d8e038974f6e00566eaa0198f3df9230489abd1a64f5ef9b98b270940ac4cb9807f44e00ff00344c5e59a1de5370e1cee5d2fcf706a649bba15b",
    • "unsigned_tx": {
      • "branch": "BM3LZcG2SNz2DCWVGAAvT3gd8Vc17dS649CG6o9PhwJjmpUTptA",
      • "contents": [
        • {
          • "kind": "delegation",
          • "source": "tz1TX3Nh6h6js1VxXCuQ7rAF7LoGpd81FSw3",
          • "fee": "1300",
          • "counter": "15082948",
          • "gas_limit": "10100",
          • "storage_limit": "0",
          • "delegate": "tz1QQZKGt3ouyd7x8JUDwcvRyxzsmD7CFbMd"
          }
        ]
      }
    }
}

Prepare Transaction

Prepare a Tezos transaction for broadcasting. It takes a serialized transaction and its signatures and returns a serialized signed transaction that can be broadcasted.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

signature
required
string

Transaction signature in hex

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc",
  • "signature": "de28e9efee4c8de422a3c64bfaaee11a32f7cf12bdd3f00dcce41a79fe776c65"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Broadcast Transaction

Broadcasts a signed Tezos transaction

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "oo3UAUpr685s3F7Fmc2ry8KHo4vdWGKo7LeimesAg56NBd6sDjs"
    }
}

Transaction Status

Get the status of a Tezos transaction

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94

Hash of the transaction

block_number
required
string
Example: block_number=2344324

Block number in which the transaction was included

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "applied",
    • "receipt": {
      • "protocol": "PtMumbai2TmsJHNGRkD8v8YDbtao7BLUC3wjASn1inAKLFCjaH1",
      • "chain_id": "NetXnHfVqm9iesp",
      • "hash": "op2Gu3xpBifNmj1dD88gwFdXuN4HT7EiqPcaERPCdyf48nYwZa9",
      • "branch": "BMUmBJ3CSxDdzEUUYuS47DNHDv8ayxyMh12zSWZ7hKzYtv8Ny7S",
      • "contents": [
        • {
          • "kind": "transaction",
          • "source": "tz3TMbNR6YcMmRvXpssLi7wNr7RrBKsgruYU",
          • "fee": "10277",
          • "counter": "15413092",
          • "gas_limit": "100000",
          • "storage_limit": "30",
          • "amount": "0",
          • "destination": "KT1VbeN9etQe5c2b6EAFfCZVaSTpiieHj5u1",
          • "parameters": {
            • "entrypoint": "tick",
            • "value": {
              • "string": "tzBTC/EURL"
              }
            },
          • "metadata": {
            • "balance_updates": [
              • {
                • "kind": "contract",
                • "contract": "tz3TMbNR6YcMmRvXpssLi7wNr7RrBKsgruYU",
                • "change": "-10277",
                • "origin": "block"
                },
              • {
                • "kind": "accumulator",
                • "category": "block fees",
                • "change": "10277",
                • "origin": "block"
                }
              ],
            • "operation_result": {
              • "status": "applied",
              • "storage": {
                • "prim": "Pair",
                • "args": [
                  • [
                    • {
                      • "prim": "Pair",
                      • "args": [
                        • {
                          • "prim": "Pair",
                          • "args": [
                            • {
                              • "bytes": "0000b9ba1078c3324ee4e0162c28cbda4765c6518d21"
                              },
                            • {
                              • "prim": "Pair",
                              • "args": [
                                • [
                                  • {
                                    • "prim": "Elt",
                                    • "args": [
                                      • {
                                        • "string": "tzBTC/EURL"
                                        },
                                      • {
                                        • "int": "2078"
                                        }
                                      ]
                                    },
                                  • {
                                    • "prim": "Elt",
                                    • "args": [
                                      • {
                                        • "string": "tzBTC/USDT"
                                        },
                                      • {
                                        • "int": "2079"
                                        }
                                      ]
                                    }
                                  ],
                                • {
                                  • "int": "288949"
                                  }
                                ]
                              }
                            ]
                          },
                        • {
                          • "prim": "Pair",
                          • "args": [
                            • {
                              • "int": "600"
                              },
                            • {
                              • "int": "10000"
                              }
                            ]
                          }
                        ]
                      },
                    • {
                      • "prim": "Pair",
                      • "args": [
                        • {
                          • "bytes": "0000b28066369a8ed09ba9d3d47f19598440266013f0"
                          },
                        • {
                          • "int": "63"
                          }
                        ]
                      },
                    • {
                      • "int": "10"
                      },
                    • {
                      • "int": "288950"
                      }
                    ],
                  • {
                    • "prim": "Pair",
                    • "args": [
                      • {
                        • "prim": "Pair",
                        • "args": [
                          • {
                            • "prim": "Pair",
                            • "args": [
                              • {
                                • "int": "288951"
                                },
                              • {
                                • "int": "1"
                                }
                              ]
                            },
                          • {
                            • "prim": "Pair",
                            • "args": [
                              • {
                                • "int": "288952"
                                },
                              • [
                                • {
                                  • "prim": "Elt",
                                  • "args": [
                                    • {
                                      • "string": "tzBTC/EURL"
                                      },
                                    • [
                                      • [
                                        • {
                                          • "prim": "Pair",
                                          • "args": [
                                            • [
                                              • {
                                                • "int": "0"
                                                },
                                              • {
                                                • "string": "tzBTC"
                                                },
                                              • {
                                                • "prim": "Some",
                                                • "args": [
                                                  • {
                                                    • "bytes": "019f8e6d69a501e050b36807de00fdc3f694dda39000"
                                                    }
                                                  ]
                                                },
                                              • {
                                                • "int": "8"
                                                },
                                              • {
                                                • "prim": "Some",
                                                • "args": [
                                                  • {
                                                    • "string": "FA1.2 token"
                                                    }
                                                  ]
                                                }
                                              ],
                                            • {
                                              • "int": "1"
                                              }
                                            ]
                                          },
                                        • {
                                          • "int": "0"
                                          },
                                        • {
                                          • "string": "EURL"
                                          },
                                        • {
                                          • "prim": "Some",
                                          • "args": [
                                            • {
                                              • "bytes": "01dcb37511b08da5f8d794b690c7ad6a03206af75200"
                                              }
                                            ]
                                          },
                                        • {
                                          • "int": "6"
                                          },
                                        • {
                                          • "prim": "Some",
                                          • "args": [
                                            • {
                                              • "string": "FA2 token"
                                              }
                                            ]
                                          }
                                        ],
                                      • {
                                        • "bytes": "01334d567a3617a22597eb783a65b04630e97c7fd600"
                                        },
                                      • {
                                        • "string": "BTC-EUR"
                                        },
                                      • {
                                        • "int": "6"
                                        },
                                      • {
                                        • "prim": "False"
                                        }
                                      ]
                                    ]
                                  },
                                • {
                                  • "prim": "Elt",
                                  • "args": [
                                    • {
                                      • "string": "tzBTC/USDT"
                                      },
                                    • [
                                      • [
                                        • {
                                          • "prim": "Pair",
                                          • "args": [
                                            • [
                                              • {
                                                • "int": "0"
                                                },
                                              • {
                                                • "string": "tzBTC"
                                                },
                                              • {
                                                • "prim": "Some",
                                                • "args": [
                                                  • {
                                                    • "bytes": "019f8e6d69a501e050b36807de00fdc3f694dda39000"
                                                    }
                                                  ]
                                                },
                                              • {
                                                • "int": "8"
                                                },
                                              • {
                                                • "prim": "Some",
                                                • "args": [
                                                  • {
                                                    • "string": "FA1.2 token"
                                                    }
                                                  ]
                                                }
                                              ],
                                            • {
                                              • "int": "1"
                                              }
                                            ]
                                          },
                                        • {
                                          • "int": "0"
                                          },
                                        • {
                                          • "string": "USDT"
                                          },
                                        • {
                                          • "prim": "Some",
                                          • "args": [
                                            • {
                                              • "bytes": "015dfb31bce51b9f71200fab36654d50cd877ef39500"
                                              }
                                            ]
                                          },
                                        • {
                                          • "int": "6"
                                          },
                                        • {
                                          • "prim": "Some",
                                          • "args": [
                                            • {
                                              • "string": "FA2 token"
                                              }
                                            ]
                                          }
                                        ],
                                      • {
                                        • "bytes": "01334d567a3617a22597eb783a65b04630e97c7fd600"
                                        },
                                      • {
                                        • "string": "BTC-USDT"
                                        },
                                      • {
                                        • "int": "6"
                                        },
                                      • {
                                        • "prim": "False"
                                        }
                                      ]
                                    ]
                                  }
                                ]
                              ]
                            }
                          ]
                        },
                      • [
                        • {
                          • "prim": "Elt",
                          • "args": [
                            • {
                              • "string": "EURL"
                              },
                            • [
                              • {
                                • "int": "0"
                                },
                              • {
                                • "string": "EURL"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "bytes": "01dcb37511b08da5f8d794b690c7ad6a03206af75200"
                                    }
                                  ]
                                },
                              • {
                                • "int": "6"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "string": "FA2 token"
                                    }
                                  ]
                                }
                              ]
                            ]
                          },
                        • {
                          • "prim": "Elt",
                          • "args": [
                            • {
                              • "string": "USDT"
                              },
                            • [
                              • {
                                • "int": "0"
                                },
                              • {
                                • "string": "USDT"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "bytes": "015dfb31bce51b9f71200fab36654d50cd877ef39500"
                                    }
                                  ]
                                },
                              • {
                                • "int": "6"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "string": "FA2 token"
                                    }
                                  ]
                                }
                              ]
                            ]
                          },
                        • {
                          • "prim": "Elt",
                          • "args": [
                            • {
                              • "string": "tzBTC"
                              },
                            • [
                              • {
                                • "int": "0"
                                },
                              • {
                                • "string": "tzBTC"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "bytes": "019f8e6d69a501e050b36807de00fdc3f694dda39000"
                                    }
                                  ]
                                },
                              • {
                                • "int": "8"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "string": "FA1.2 token"
                                    }
                                  ]
                                }
                              ]
                            ]
                          }
                        ]
                      ]
                    }
                  ]
                },
              • "balance_updates": [
                • {
                  • "kind": "contract",
                  • "contract": "tz3TMbNR6YcMmRvXpssLi7wNr7RrBKsgruYU",
                  • "change": "-2500",
                  • "origin": "block"
                  },
                • {
                  • "kind": "burned",
                  • "category": "storage fees",
                  • "change": "2500",
                  • "origin": "block"
                  }
                ],
              • "consumed_milligas": "6668844",
              • "storage_size": "1231820",
              • "paid_storage_size_diff": "10",
              • "lazy_storage_diff": [
                • {
                  • "kind": "big_map",
                  • "id": "288952",
                  • "diff": {
                    • "action": "update",
                    • "updates": [ ]
                    }
                  },
                • {
                  • "kind": "big_map",
                  • "id": "288951",
                  • "diff": {
                    • "action": "update",
                    • "updates": [
                      • {
                        • "key_hash": "exprv54v2iFYQ5fHRM2GLzRgZKHpf3suvC9jyke2F3TcFwDxExPRjB",
                        • "key": {
                          • "string": "tzBTC/EURL"
                          },
                        • "value": {
                          • "prim": "Pair",
                          • "args": [
                            • [
                              • {
                                • "prim": "Pair",
                                • "args": [
                                  • [
                                    • {
                                      • "int": "0"
                                      },
                                    • {
                                      • "string": "tzBTC"
                                      },
                                    • {
                                      • "prim": "Some",
                                      • "args": [
                                        • {
                                          • "bytes": "019f8e6d69a501e050b36807de00fdc3f694dda39000"
                                          }
                                        ]
                                      },
                                    • {
                                      • "int": "8"
                                      },
                                    • {
                                      • "prim": "Some",
                                      • "args": [
                                        • {
                                          • "string": "FA1.2 token"
                                          }
                                        ]
                                      }
                                    ],
                                  • {
                                    • "int": "1"
                                    }
                                  ]
                                },
                              • {
                                • "int": "0"
                                },
                              • {
                                • "string": "EURL"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "bytes": "01dcb37511b08da5f8d794b690c7ad6a03206af75200"
                                    }
                                  ]
                                },
                              • {
                                • "int": "6"
                                },
                              • {
                                • "prim": "Some",
                                • "args": [
                                  • {
                                    • "string": "FA2 token"
                                    }
                                  ]
                                }
                              ],
                            • {
                              • "prim": "Pair",
                              • "args": [
                                • {
                                  • "prim": "Pair",
                                  • "args": [
                                    • {
                                      • "int": "2664904905100"
                                      },
                                    • {
                                      • "int": "10000000000"
                                      }
                                    ]
                                  },
                                • {
                                  • "int": "1683299700"
                                  }
                                ]
                              }
                            ]
                          }
                        }
                      ]
                    }
                  },
                • {
                  • "kind": "big_map",
                  • "id": "288950",
                  • "diff": {
                    • "action": "update",
                    • "updates": [ ]
                    }
                  },
                • {
                  • "kind": "big_map",
                  • "id": "288949",
                  • "diff": {
                    • "action": "update",
                    • "updates": [
                      • {
                        • "key_hash": "exprtX5LinYF4NkttwZC7Y6eqfXT38Dxq1KBV1ctmQAfzsGb1G3nap",
                        • "key": {
                          • "int": "2078"
                          },
                        • "value": [
                          • {
                            • "int": "2078"
                            },
                          • {
                            • "prim": "Left",
                            • "args": [
                              • {
                                • "prim": "Right",
                                • "args": [
                                  • {
                                    • "prim": "Pair",
                                    • "args": [
                                      • {
                                        • "int": "1683299741"
                                        },
                                      • {
                                        • "int": "1683299141"
                                        }
                                      ]
                                    }
                                  ]
                                }
                              ]
                            },
                          • [
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              },
                            • {
                              • "int": "0"
                              }
                            ],
                          • [
                            • {
                              • "int": "0"
                              },
                            • {
                              • "string": "tzBTC"
                              },
                            • {
                              • "prim": "Some",
                              • "args": [
                                • {
                                  • "bytes": "019f8e6d69a501e050b36807de00fdc3f694dda39000"
                                  }
                                ]
                              },
                            • {
                              • "int": "8"
                              },
                            • {
                              • "prim": "Some",
                              • "args": [
                                • {
                                  • "string": "FA1.2 token"
                                  }
                                ]
                              }
                            ],
                          • {
                            • "int": "0"
                            },
                          • {
                            • "string": "EURL"
                            },
                          • {
                            • "prim": "Some",
                            • "args": [
                              • {
                                • "bytes": "01dcb37511b08da5f8d794b690c7ad6a03206af75200"
                                }
                              ]
                            },
                          • {
                            • "int": "6"
                            },
                          • {
                            • "prim": "Some",
                            • "args": [
                              • {
                                • "string": "FA2 token"
                                }
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        ],
      • "signature": "sigaYuApxhkynr4VUasNY6GsSstUvVrcoS84VHtXv6V5e5Fmoqg17oEEsf5Vpahjrx1EFuPhnm4BnPwrxVyXrqh71uhG5Tf7"
      }
    }
}

SOL

Staking facilities for the Solana protocol

Stakes

Get the status of Solana stakes

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=5XUx8ZHPWSKdwfkPWHSTKco3okpHV7zEPccsQAxQzc9f

Comma-separated list of stake addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "stake_account": "3sfokk2DFsd88ujd8sfa9slsdf99kjnFJksdf",
      • "vote_account": "6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78",
      • "withdraw_pubkey": "4wdr76KJTFgH68YtGddmnF45WdD8LMv9eLsdf",
      • "state": "active",
      • "activated_at": "2023-01-14T01:13:59Z",
      • "activated_epoch": 150,
      • "deactivated_at": "2023-01-14T01:13:59Z",
      • "deactivated_epoch": 150,
      • "balance": "1000000000",
      • "rewards": "1000000000",
      • "net_apy": 3.407,
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

Create stakes

Create Solana stakes and linked them to a Kiln account

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stakes": [
    • {
      • "stakeAccount": "3sfokk2DFsd88ujd8sfa9slsdf99kjnFJksdf",
      • "balance": 1000000
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "tags": [
      • "tag1"
      ],
    • "metadata": { },
    • "protocol": "ethereum",
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards of Solana stakes

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=5XUx8ZHPWSKdwfkPWHSTKco3okpHV7zEPccsQAxQzc9f

Comma-separated list of stake addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <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

Get rewards from this date (YYYY-MM-DD)

end_date
string <date>
Example: end_date=2023-01-20

Get rewards to this date (YYYY-MM-DD)

format
string
extensible-enum: ["daily","epoch"]

The format of the response. Defaults to daily

start_epoch
number
Example: start_epoch=542

The epoch from which we want to fetch rewards. Must be used with format=epoch

end_epoch
number
Example: end_epoch=542

The epoch until which we want to fetch rewards. Must be used with format=epoch

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "epoch": 120,
      • "epoch_ts": "2023-01-14T01:13:59Z",
      • "rewards": "1000",
      • "active_balance": "1000",
      • "net_apy": 3.407
      }
    ]
}

Operations

Get the operations of Solana stakes

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=5XUx8ZHPWSKdwfkPWHSTKco3okpHV7zEPccsQAxQzc9f

Comma-separated list of stake addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "create_account_with_seed",
      • "time": "2023-01-14T01:13:59Z",
      • "tx_hash": "2cHnbnyJnP6vffL3iR2pN8va6fxXWEdnYAr9nwM7d3VowDXSxw3B541DR294fHgomK81SQdSHdskhKUCWUKQPHie",
      • "tx_fee": "1000",
      • "tx_memo": "kiln_memo",
      • "block": 1000,
      • "stake_account": "3sfokk2DFsd88ujd8sfa9slsdf99kjnFJksdf",
      • "amount": "1000",
      • "stake_authority": "4wdr76KJTFgH68YtGddmnF45WdD8LMv9eLsdf"
      }
    ]
}

Network Stats

Get some network statistics on Solana staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "nb_validators": 402,
    • "sol_price_usd": 3.5,
    • "updated_at": "2023-01-14T01:13:59Z"
    }
}

Reports

Get reports on Solana staking

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=5XUx8ZHPWSKdwfkPWHSTKco3okpHV7zEPccsQAxQzc9f

Comma-separated list of stake addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

format
string
extensible-enum: ["daily","epoch"]

The format of the response. Defaults to daily

Responses

Stake Transaction

Craft a stake transaction. This results in a new stake account created with the amount given.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stake transaction to create

account_id
required
string

Kiln Account ID

wallet
required
string

Wallet address

amount_lamports
required
string

Amount in lamports (minimum value must be 10000001)

vote_account_address
required
string

Vote account address

memo
string

Custom message to send as a memo in the transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "d3f1b917-72b1-4982-a4dd-93fce579a708",
  • "wallet": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
  • "amount_lamports": "1000000000000000",
  • "vote_account_address": "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
  • "memo": "custom message"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx": {
      • "header": {
        • "numRequiredSignatures": 3,
        • "numReadonlySignedAccounts": 1,
        • "numReadonlyUnsignedAccounts": 8
        },
      • "accountKeys": [
        • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
        • "2sAwSXUrNW9PfaX6joGy62QAfmhHGnxpM7CYGNF7qdPX",
        • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
        • "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
        • "11111111111111111111111111111111",
        • "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
        • "Stake11111111111111111111111111111111111111",
        • "StakeConfig11111111111111111111111111111111",
        • "SysvarC1ock11111111111111111111111111111111",
        • "SysvarRecentB1ockHashes11111111111111111111",
        • "SysvarRent111111111111111111111111111111111",
        • "SysvarStakeHistory1111111111111111111111111"
        ],
      • "recentBlockhash": "HCAcHiKdfbnfZk6rgnrWxeCBxavYxcWWo7JLsQqwDquU",
      • "instructions": [
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 3,
            • 9,
            • 2
            ],
          • "data": "6vx8P"
          },
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 0,
            • 1
            ],
          • "data": "11111255HrbrzNKE34jJbWojuhKCCFF5BqruMbtEe7CY3fPCMjUHYn7uEDqFavZELT1boD"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 10
            ],
          • "data": "1111BNVhr29wy4CUDfmP3ysWa9GUZMwYaMaAp9JVWCAzhqZ78HhuLB7fgzVCHGpmMQg4sJMrzXVvT3BxhUBDvroCMCJ5sKhVwNWL2phXwqXEH6mKiVgsJwPG3iKFVxiQoPLBXFx7Vv9USNmuAMcTWz6tvYb2w"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 5,
            • 8,
            • 11,
            • 7,
            • 0
            ],
          • "data": "3xyZh"
          }
        ],
      • "indexToProgramIds": { }
      }
    }
}

Deactivate Stake Transaction

Craft a deactivate stake account transaction.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stake to deactivate

stake_account
required
string

Stake account address

wallet
required
string

Wallet address

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stake_account": "3M7sFDMdUxfNNSmKk2ZmDKgKJFzuLvxpuXKDTLRGXpcK",
  • "wallet": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx": {
      • "header": {
        • "numRequiredSignatures": 3,
        • "numReadonlySignedAccounts": 1,
        • "numReadonlyUnsignedAccounts": 8
        },
      • "accountKeys": [
        • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
        • "2sAwSXUrNW9PfaX6joGy62QAfmhHGnxpM7CYGNF7qdPX",
        • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
        • "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
        • "11111111111111111111111111111111",
        • "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
        • "Stake11111111111111111111111111111111111111",
        • "StakeConfig11111111111111111111111111111111",
        • "SysvarC1ock11111111111111111111111111111111",
        • "SysvarRecentB1ockHashes11111111111111111111",
        • "SysvarRent111111111111111111111111111111111",
        • "SysvarStakeHistory1111111111111111111111111"
        ],
      • "recentBlockhash": "HCAcHiKdfbnfZk6rgnrWxeCBxavYxcWWo7JLsQqwDquU",
      • "instructions": [
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 3,
            • 9,
            • 2
            ],
          • "data": "6vx8P"
          },
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 0,
            • 1
            ],
          • "data": "11111255HrbrzNKE34jJbWojuhKCCFF5BqruMbtEe7CY3fPCMjUHYn7uEDqFavZELT1boD"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 10
            ],
          • "data": "1111BNVhr29wy4CUDfmP3ysWa9GUZMwYaMaAp9JVWCAzhqZ78HhuLB7fgzVCHGpmMQg4sJMrzXVvT3BxhUBDvroCMCJ5sKhVwNWL2phXwqXEH6mKiVgsJwPG3iKFVxiQoPLBXFx7Vv9USNmuAMcTWz6tvYb2w"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 5,
            • 8,
            • 11,
            • 7,
            • 0
            ],
          • "data": "3xyZh"
          }
        ],
      • "indexToProgramIds": { }
      }
    }
}

Withdraw Stake Transaction

Craft a withdraw stake transaction.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stake to withdraw

stake_account
required
string

Stake account address

wallet
required
string

Wallet address

amount_lamports
string

Amount in lamports

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stake_account": "3M7sFDMdUxfNNSmKk2ZmDKgKJFzuLvxpuXKDTLRGXpcK",
  • "wallet": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
  • "amount_lamports": "1000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx": {
      • "header": {
        • "numRequiredSignatures": 3,
        • "numReadonlySignedAccounts": 1,
        • "numReadonlyUnsignedAccounts": 8
        },
      • "accountKeys": [
        • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
        • "2sAwSXUrNW9PfaX6joGy62QAfmhHGnxpM7CYGNF7qdPX",
        • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
        • "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
        • "11111111111111111111111111111111",
        • "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
        • "Stake11111111111111111111111111111111111111",
        • "StakeConfig11111111111111111111111111111111",
        • "SysvarC1ock11111111111111111111111111111111",
        • "SysvarRecentB1ockHashes11111111111111111111",
        • "SysvarRent111111111111111111111111111111111",
        • "SysvarStakeHistory1111111111111111111111111"
        ],
      • "recentBlockhash": "HCAcHiKdfbnfZk6rgnrWxeCBxavYxcWWo7JLsQqwDquU",
      • "instructions": [
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 3,
            • 9,
            • 2
            ],
          • "data": "6vx8P"
          },
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 0,
            • 1
            ],
          • "data": "11111255HrbrzNKE34jJbWojuhKCCFF5BqruMbtEe7CY3fPCMjUHYn7uEDqFavZELT1boD"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 10
            ],
          • "data": "1111BNVhr29wy4CUDfmP3ysWa9GUZMwYaMaAp9JVWCAzhqZ78HhuLB7fgzVCHGpmMQg4sJMrzXVvT3BxhUBDvroCMCJ5sKhVwNWL2phXwqXEH6mKiVgsJwPG3iKFVxiQoPLBXFx7Vv9USNmuAMcTWz6tvYb2w"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 5,
            • 8,
            • 11,
            • 7,
            • 0
            ],
          • "data": "3xyZh"
          }
        ],
      • "indexToProgramIds": { }
      }
    }
}

Merge Stakes Transaction

Craft a merge stakes transaction.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stakes to merge

stake_account_source
required
string

Stake account address

stake_account_destination
required
string

Stake account address

wallet
required
string

Wallet address

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stake_account_source": "HQQkoFXHz1XemQHFhC3mN1CGdfH8Pokw2DfFUmwZCRWb",
  • "stake_account_destination": "GyPnKF88P8c3jESicELWLrxAmeF9PoaKzqYGREDuEAMx",
  • "wallet": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx": {
      • "header": {
        • "numRequiredSignatures": 3,
        • "numReadonlySignedAccounts": 1,
        • "numReadonlyUnsignedAccounts": 8
        },
      • "accountKeys": [
        • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
        • "2sAwSXUrNW9PfaX6joGy62QAfmhHGnxpM7CYGNF7qdPX",
        • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
        • "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
        • "11111111111111111111111111111111",
        • "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
        • "Stake11111111111111111111111111111111111111",
        • "StakeConfig11111111111111111111111111111111",
        • "SysvarC1ock11111111111111111111111111111111",
        • "SysvarRecentB1ockHashes11111111111111111111",
        • "SysvarRent111111111111111111111111111111111",
        • "SysvarStakeHistory1111111111111111111111111"
        ],
      • "recentBlockhash": "HCAcHiKdfbnfZk6rgnrWxeCBxavYxcWWo7JLsQqwDquU",
      • "instructions": [
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 3,
            • 9,
            • 2
            ],
          • "data": "6vx8P"
          },
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 0,
            • 1
            ],
          • "data": "11111255HrbrzNKE34jJbWojuhKCCFF5BqruMbtEe7CY3fPCMjUHYn7uEDqFavZELT1boD"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 10
            ],
          • "data": "1111BNVhr29wy4CUDfmP3ysWa9GUZMwYaMaAp9JVWCAzhqZ78HhuLB7fgzVCHGpmMQg4sJMrzXVvT3BxhUBDvroCMCJ5sKhVwNWL2phXwqXEH6mKiVgsJwPG3iKFVxiQoPLBXFx7Vv9USNmuAMcTWz6tvYb2w"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 5,
            • 8,
            • 11,
            • 7,
            • 0
            ],
          • "data": "3xyZh"
          }
        ],
      • "indexToProgramIds": { }
      }
    }
}

Split Stake Transaction

Craft a solana split stake transaction

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stake to split

account_id
required
string

Kiln Account ID

stake_account
required
string

Stake account address

wallet
required
string

Wallet address

amount_lamports
required
string

Amount in lamports

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "d3f1b917-72b1-4982-a4dd-93fce579a708",
  • "stake_account": "GyPnKF88P8c3jESicELWLrxAmeF9PoaKzqYGREDuEAMx",
  • "wallet": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
  • "amount_lamports": "200000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
    • "unsigned_tx": {
      • "header": {
        • "numRequiredSignatures": 3,
        • "numReadonlySignedAccounts": 1,
        • "numReadonlyUnsignedAccounts": 8
        },
      • "accountKeys": [
        • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
        • "2sAwSXUrNW9PfaX6joGy62QAfmhHGnxpM7CYGNF7qdPX",
        • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
        • "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
        • "11111111111111111111111111111111",
        • "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
        • "Stake11111111111111111111111111111111111111",
        • "StakeConfig11111111111111111111111111111111",
        • "SysvarC1ock11111111111111111111111111111111",
        • "SysvarRecentB1ockHashes11111111111111111111",
        • "SysvarRent111111111111111111111111111111111",
        • "SysvarStakeHistory1111111111111111111111111"
        ],
      • "recentBlockhash": "HCAcHiKdfbnfZk6rgnrWxeCBxavYxcWWo7JLsQqwDquU",
      • "instructions": [
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 3,
            • 9,
            • 2
            ],
          • "data": "6vx8P"
          },
        • {
          • "programIdIndex": 4,
          • "accounts": [
            • 0,
            • 1
            ],
          • "data": "11111255HrbrzNKE34jJbWojuhKCCFF5BqruMbtEe7CY3fPCMjUHYn7uEDqFavZELT1boD"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 10
            ],
          • "data": "1111BNVhr29wy4CUDfmP3ysWa9GUZMwYaMaAp9JVWCAzhqZ78HhuLB7fgzVCHGpmMQg4sJMrzXVvT3BxhUBDvroCMCJ5sKhVwNWL2phXwqXEH6mKiVgsJwPG3iKFVxiQoPLBXFx7Vv9USNmuAMcTWz6tvYb2w"
          },
        • {
          • "programIdIndex": 6,
          • "accounts": [
            • 1,
            • 5,
            • 8,
            • 11,
            • 7,
            • 0
            ],
          • "data": "3xyZh"
          }
        ],
      • "indexToProgramIds": { }
      }
    }
}

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to sign

unsigned_tx_serialized
required
string

Hex encoded unsigned transaction

signatures
required
Array of strings

Hex encoded signatures

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005812228c3ecf882e4ea4a608f7cbaa9c1557cefbdad3f781d0b6b562351eaef2a00c04273d6f9adc395d4ce59ed5e4b041221ff6892584943f8dd20b2a3d06ab2e486351d862d49c29a86b53cdc225e5ad717c7511a3fdc7a580a56406276191f1036a9efb951a61ca3922e9d7b59c74383b9c0028dc0e7a0270b71e1226070301080c3b9feaffd8e2dd3a59e1bbfe2b2de5090238b622f638cdf8066ebf946f1cd1652f35f8c8d7a43a970660e177489a647dba6caf2006a788657432e8d8e7107a7451f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c0000000000000000000000000000000000000000000000000000000000000000bb92012657eb9b0bbd98e0109c08a1a16514df3f22df949d5d1b9e2f04aaeb6e06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000b6fa88c0c34a62da18b6287ecbb3a406c9182922f331a5f75b801d7acff8fa8c0404030309020404000000040200013400000000002d310100000000c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a74000000003b9feaffd8e2dd3a59e1bbfe2b2de5090238b622f638cdf8066ebf946f1cd1653b9feaffd8e2dd3a59e1bbfe2b2de5090238b622f638cdf8066ebf946f1cd16500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
  • "signatures": [
    • "9b43c27a887b4857ec7fb7a58acdfb10c8b9d94a8e0106b5c9dff4224594b43e43bbdb76c52fbe90ec89e951b1166ab972b5c34295ae6a971f16e88c3a5d950b"
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000"
    }
}

Broadcast Transaction

Broadcast a serialized signed transaction to the blockchain

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Signed transaction to broadcast

tx_serialized
required
string

Hex encoded signed transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "sV6dgQyxByL66t9uTPmffitncWNmnkR8oEC1gQ29jPrKFHm9TkMGvS3TgcQeNz9pSN7913aPXe6MMHFS4xqTafL"
    }
}

Transaction Status

Get the status of a transaction

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94

Hash of the transaction

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "success",
    • "receipt": {
      • "blockTime": 1676916194,
      • "meta": {
        • "computeUnitsConsumed": 0,
        • "err": null,
        • "fee": 15000,
        • "innerInstructions": [ ],
        • "loadedAddresses": {
          • "readonly": [ ],
          • "writable": [ ]
          },
        • "logMessages": [
          • "Program 11111111111111111111111111111111 invoke [1]",
          • "Program 11111111111111111111111111111111 success",
          • "Program 11111111111111111111111111111111 invoke [1]",
          • "Program 11111111111111111111111111111111 success",
          • "Program Stake11111111111111111111111111111111111111 invoke [1]",
          • "Program Stake11111111111111111111111111111111111111 success",
          • "Program Stake11111111111111111111111111111111111111 invoke [1]",
          • "Program Stake11111111111111111111111111111111111111 success"
          ],
        • "postBalances": [
          • 1587335720,
          • 200000000,
          • 1979975000,
          • 10000000,
          • 1,
          • 7292994607,
          • 1,
          • 960480,
          • 1169280,
          • 42706560,
          • 1009200,
          • 114979200
          ],
        • "postTokenBalances": [ ],
        • "preBalances": [
          • 1787350720,
          • 0,
          • 1979975000,
          • 10000000,
          • 1,
          • 7292994607,
          • 1,
          • 960480,
          • 1169280,
          • 42706560,
          • 1009200,
          • 114979200
          ],
        • "preTokenBalances": [ ],
        • "rewards": [ ],
        • "status": {
          • "Ok": null
          }
        },
      • "slot": 197065694,
      • "transaction": {
        • "message": {
          • "header": {
            • "numReadonlySignedAccounts": 1,
            • "numReadonlyUnsignedAccounts": 8,
            • "numRequiredSignatures": 3
            },
          • "accountKeys": [
            • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
            • "8qcpEjkWRi7LuZL4oQARDNTMVUwLQyakuno2syEMLsBi",
            • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
            • "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
            • "11111111111111111111111111111111",
            • "FwR3PbjS5iyqzLiLugrBqKSa5EKZ4vK9SKs7eQXtT59f",
            • "Stake11111111111111111111111111111111111111",
            • "StakeConfig11111111111111111111111111111111",
            • "SysvarC1ock11111111111111111111111111111111",
            • "SysvarRecentB1ockHashes11111111111111111111",
            • "SysvarRent111111111111111111111111111111111",
            • "SysvarStakeHistory1111111111111111111111111"
            ],
          • "recentBlockhash": "4emvYWMe99WbtKFHmtv5gEUYi9HfVnmQyf5Y7ccCEpWR",
          • "instructions": [
            • {
              • "accounts": [
                • 3,
                • 9,
                • 2
                ],
              • "data": "6vx8P",
              • "programIdIndex": 4
              },
            • {
              • "accounts": [
                • 0,
                • 1
                ],
              • "data": "111112cxUqMWZDxCrGjkHwTWjy7bQNEqgy3xB2LZ8vt9NjVisJzdYK3W8eRceiR2k9CjMy",
              • "programIdIndex": 4
              },
            • {
              • "accounts": [
                • 1,
                • 10
                ],
              • "data": "1111BNVhr29wy4CUDfmP3ysWa9GUZMwYaMaAp9JVWCAzhqZ78HhuLB7fgzVCHGpmMQg4sJMrzXVvT3BxhUBDvroCMCJ5sKhVwNWL2phXwqXEH6mKiVgsJwPG3iKFVxiQoPLBXFx7Vv9USNmuAMcTWz6tvYb2w",
              • "programIdIndex": 6
              },
            • {
              • "accounts": [
                • 1,
                • 5,
                • 8,
                • 11,
                • 7,
                • 0
                ],
              • "data": "3xyZh",
              • "programIdIndex": 6
              }
            ],
          • "indexToProgramIds": { }
          },
        • "signatures": [
          • "569uGMNQR4vVeukdSTmLtrzs5ZSiAFTk3tPTBavJjZ1H7b3be2EB8ZjRcfhTA6gBApien2tbJgKYayDVtRKFRfUu",
          • "3hSgNRnKero2XogfU6Dk3jDXrEMmknNaoPbW4dJ6BHCkDUV5J5rr5iRRdaAtoVLvat7QMox7qpanMu6fqUAUvs3w",
          • "5djumEdbCJEAPxJk2r9FybpDLnSy4uazGbgP3EmtQrMQMW4edQrhb1nYK3aJtgf5svMtSXSgKoFho4tUxVAbZSUn"
          ]
        }
      }
    }
}

ATOM

Staking facilities for the ATOM protocol

Stakes

Get the status of ATOM stakes. Units are in uATOM (10⁻⁶ ATOM). All stakes active after Theta v7 (12/04/2022) are available.

Authorizations:
bearerAuth
query Parameters
validators
Array of strings
Example: validators=cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2

Comma-separated list of validators addresses, these addresses are matched with the corresponding delegator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

delegators
Array of strings
Example: delegators=cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl

Comma-separated list of delegator addresses, these addresses are matched with the corresponding validator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2",
      • "delegator_address": "cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "delegated_at": "2023-06-16T03:13:23.058547Z",
      • "delegated_block": 15739267,
      • "undelegated_at": "2023-07-14T03:56:13.561156Z",
      • "undelegated_block": 16126416,
      • "rewards": "735573808534727891000000",
      • "available_rewards": "36748808534727891000000",
      • "balance": "6300000000000000000000000",
      • "net_apy": 5.76,
      • "state": "active",
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

Create stakes

Link an ATOM stake to a Kiln account

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stakes": [
    • {
      • "stakeId": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2_cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "balance": 1000000
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "tags": [
      • "tag1"
      ],
    • "metadata": { },
    • "protocol": "ethereum",
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of ATOM stakes. Units are in uATOM (10⁻⁶ ATOM). Only daily breakdowns after 13/04/2022 (Theta v7) are available.

Authorizations:
bearerAuth
query Parameters
validators
Array of strings
Example: validators=cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2

Comma-separated list of validators addresses, these addresses are matched with the corresponding delegator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

delegators
Array of strings
Example: delegators=cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl

Comma-separated list of delegator addresses, these addresses are matched with the corresponding validator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

accounts
Array of strings <uuid> [ items <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

Get rewards from this date (YYYY-MM-DD)

end_date
string <date>
Example: end_date=2023-01-20

Get rewards to this date (YYYY-MM-DD)

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "3575891083876864200000",
      • "balance": "6300000000000000000000000",
      • "net_apy": 20.76
      }
    ]
}

Operations

Get the operations of ATOM stakes. Units are in uATOM (10⁻⁶ ATOM). All operations after Theta v7 (12/04/2022) are available.

Authorizations:
bearerAuth
query Parameters
validators
Array of strings
Example: validators=cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2

Comma-separated list of validators addresses, these addresses are matched with the corresponding delegator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

delegators
Array of strings
Example: delegators=cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl

Comma-separated list of delegator addresses, these addresses are matched with the corresponding validator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "staking.MsgDelegate",
      • "time": "2023-06-22T15:35:01.892644Z",
      • "block": 15828207,
      • "tx_hash": "7DBC7C481A9A28961BDDF5BCDD47217A126EC0497017908453D71FACA9FA3506",
      • "tx_gas_used": "186733",
      • "message_index": 0,
      • "validator_address": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2",
      • "delegator_address": "cosmos1hz9ew395caudqtynfwry0mxxw9jyvngkw255l5",
      • "amount": "3000000",
      • "withdraw_rewards": "10841"
      }
    ]
}

Network Stats

Get some network statistics on Cosmos

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "nb_validators": 100,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "atom_price_usd": 10.53,
    • "updated_at": "2023-01-14T01:13:59Z"
    }
}

Reports

Get reports on Cosmos staking

Authorizations:
bearerAuth
query Parameters
delegators
Array of strings
Example: delegators=cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl

Comma-separated list of delegator addresses, these addresses are matched with the corresponding validator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

validators
Array of strings
Example: validators=cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2

Comma-separated list of validators addresses, these addresses are matched with the corresponding delegator addresses. To fetch a specific stake, pass your wallet address and the validator address as parameters.

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Stake Transaction

Generates a delegate transaction on Cosmos

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

pubkey
required
string

Wallet compressed or uncompressed public key, this is different than the wallet address

validator
required
string

Validator address

amount_uatom
required
string

Amount to stake in uATOM

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9",
  • "amount_uatom": "1000000000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9",
        • "amount": {
          • "denom": "uatom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uatom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      }
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Cosmos

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

pubkey
required
string

Wallet compressed public key, this is different than the wallet address

validator
required
string

Validator address

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9",
        • "amount": {
          • "denom": "uatom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uatom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      }
    }
}

Unstake Transaction

Generates an undelegate transaction on Cosmos

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

pubkey
required
string

Wallet compressed public key, this is different than the wallet address

validator
required
string

Validator address

amount_uatom
string

Amount to unstake in uATOM. Omit to unstake all the delegated amount

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9",
  • "amount_uatom": "1000000000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9",
        • "amount": {
          • "denom": "uatom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uatom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      }
    }
}

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to prepare

pubkey
required
string

Wallet compressed public key, this is different than the wallet address

tx_body
required
string

Transaction body serialized in hex

tx_auth_info
required
string

Transaction auth info serialized in hex

signature
required
string

Transaction signature serialized in hex

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
  • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
  • "signature": "191f87a54dceafb6ab9a5f112a13444ca37e49a029e531bb21301fd72e9d390304c763cca5a9760a631dc85705dd6b08b50f5fff7d5de8d73b2cebd1f4c3b6a0"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "0aa1010a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d12073130303030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801182012130a0d0a057561746f6d12043530303010e0a7121a40191f87a54dceafb6ab9a5f112a13444ca37e49a029e531bb21301fd72e9d390304c763cca5a9760a631dc85705dd6b08b50f5fff7d5de8d73b2cebd1f4c3b6a0"
    }
}

Broadcast Transaction

Broadcast a signed transaction to the Cosmos network

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to broadcast

tx_serialized
required
string

Signed transaction serialized in hex

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "0aa1010a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d12073130303030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801182012130a0d0a057561746f6d12043530303010e0a7121a40191f87a54dceafb6ab9a5f112a13444ca37e49a029e531bb21301fd72e9d390304c763cca5a9760a631dc85705dd6b08b50f5fff7d5de8d73b2cebd1f4c3b6a0"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "2B4F732E12D5D5AF1F907AD03B199167A718EDC6201DE5713143AB80990420CB"
    }
}

Transaction Status

Get the status of a transaction

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=2B4F732E12D5D5AF1F907AD03B199167A718EDC6201DE5713143AB80990420CB

Hash of the transaction

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "success",
    • "receipt": {
      • "height": 16007296,
      • "txIndex": 0,
      • "hash": "2B4F732E12D5D5AF1F907AD03B199167A718EDC6201DE5713143AB80990420CB",
      • "code": 0,
      • "events": [
        • {
          • "type": "coin_spent",
          • "attributes": [
            • {
              • "key": "spender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5000uatom"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "amount",
              • "value": "5000uatom"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5000uatom"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              }
            ]
          },
        • {
          • "type": "tx",
          • "attributes": [
            • {
              • "key": "fee",
              • "value": "5000uatom"
              },
            • {
              • "key": "fee_payer",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              }
            ]
          },
        • {
          • "type": "tx",
          • "attributes": [
            • {
              • "key": "acc_seq",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev/33"
              }
            ]
          },
        • {
          • "type": "tx",
          • "attributes": [
            • {
              • "key": "signature",
              • "value": "GR+HpU3Or7arml8RKhNETKN+SaAp5TG7ITAf1y6dOQMEx2PMpal2CmMdyFcF3WsItQ9f/31d6Nc7LOvR9MO2oA=="
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "action",
              • "value": "/cosmos.staking.v1beta1.MsgDelegate"
              }
            ]
          },
        • {
          • "type": "coin_spent",
          • "attributes": [
            • {
              • "key": "spender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              },
            • {
              • "key": "amount",
              • "value": "5uatom"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5uatom"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              },
            • {
              • "key": "amount",
              • "value": "5uatom"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              }
            ]
          },
        • {
          • "type": "withdraw_rewards",
          • "attributes": [
            • {
              • "key": "amount",
              • "value": "5uatom"
              },
            • {
              • "key": "validator",
              • "value": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9"
              }
            ]
          },
        • {
          • "type": "coin_spent",
          • "attributes": [
            • {
              • "key": "spender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "100000uatom"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh"
              },
            • {
              • "key": "amount",
              • "value": "100000uatom"
              }
            ]
          },
        • {
          • "type": "delegate",
          • "attributes": [
            • {
              • "key": "validator",
              • "value": "cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9"
              },
            • {
              • "key": "amount",
              • "value": "100000uatom"
              },
            • {
              • "key": "new_shares",
              • "value": "100000.000000000000000000"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "module",
              • "value": "staking"
              },
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              }
            ]
          }
        ],
      • "rawLog": "[{\"events\":[{\"type\":\"coin_received\",\"attributes\":[{\"key\":\"receiver\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"},{\"key\":\"amount\",\"value\":\"5uatom\"},{\"key\":\"receiver\",\"value\":\"cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh\"},{\"key\":\"amount\",\"value\":\"100000uatom\"}]},{\"type\":\"coin_spent\",\"attributes\":[{\"key\":\"spender\",\"value\":\"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl\"},{\"key\":\"amount\",\"value\":\"5uatom\"},{\"key\":\"spender\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"},{\"key\":\"amount\",\"value\":\"100000uatom\"}]},{\"type\":\"delegate\",\"attributes\":[{\"key\":\"validator\",\"value\":\"cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9\"},{\"key\":\"amount\",\"value\":\"100000uatom\"},{\"key\":\"new_shares\",\"value\":\"100000.000000000000000000\"}]},{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"/cosmos.staking.v1beta1.MsgDelegate\"},{\"key\":\"sender\",\"value\":\"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl\"},{\"key\":\"module\",\"value\":\"staking\"},{\"key\":\"sender\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"}]},{\"type\":\"transfer\",\"attributes\":[{\"key\":\"recipient\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"},{\"key\":\"sender\",\"value\":\"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl\"},{\"key\":\"amount\",\"value\":\"5uatom\"}]},{\"type\":\"withdraw_rewards\",\"attributes\":[{\"key\":\"amount\",\"value\":\"5uatom\"},{\"key\":\"validator\",\"value\":\"cosmosvaloper16ys0eg935mkqpkydkgfcj9age2au8l96naere9\"}]}]}]",
      • "tx": {
        • "0": 10,
        • "1": 160,
        • "2": 1,
        • "3": 10,
        • "4": 157,
        • "5": 1,
        • "6": 10,
        • "7": 35,
        • "8": 47,
        • "9": 99,
        • "10": 111,
        • "11": 115,
        • "12": 109,
        • "13": 111,
        • "14": 115,
        • "15": 46,
        • "16": 115,
        • "17": 116,
        • "18": 97,
        • "19": 107,
        • "20": 105,
        • "21": 110,
        • "22": 103,
        • "23": 46,
        • "24": 118,
        • "25": 49,
        • "26": 98,
        • "27": 101,
        • "28": 116,
        • "29": 97,
        • "30": 49,
        • "31": 46,
        • "32": 77,
        • "33": 115,
        • "34": 103,
        • "35": 68,
        • "36": 101,
        • "37": 108,
        • "38": 101,
        • "39": 103,
        • "40": 97,
        • "41": 116,
        • "42": 101,
        • "43": 18,
        • "44": 118,
        • "45": 10,
        • "46": 45,
        • "47": 99,
        • "48": 111,
        • "49": 115,
        • "50": 109,
        • "51": 111,
        • "52": 115,
        • "53": 49,
        • "54": 57,
        • "55": 99,
        • "56": 57,
        • "57": 102,
        • "58": 100,
        • "59": 104,
        • "60": 52,
        • "61": 56,
        • "62": 56,
        • "63": 118,
        • "64": 113,
        • "65": 106,
        • "66": 99,
        • "67": 108,
        • "68": 108,
        • "69": 116,
        • "70": 119,
        • "71": 112,
        • "72": 54,
        • "73": 56,
        • "74": 106,
        • "75": 109,
        • "76": 53,
        • "77": 48,
        • "78": 121,
        • "79": 100,
        • "80": 119,
        • "81": 121,
        • "82": 104,
        • "83": 51,
        • "84": 54,
        • "85": 106,
        • "86": 113,
        • "87": 101,
        • "88": 97,
        • "89": 116,
        • "90": 101,
        • "91": 118,
        • "92": 18,
        • "93": 52,
        • "94": 99,
        • "95": 111,
        • "96": 115,
        • "97": 109,
        • "98": 111,
        • "99": 115,
        • "100": 118,
        • "101": 97,
        • "102": 108,
        • "103": 111,
        • "104": 112,
        • "105": 101,
        • "106": 114,
        • "107": 49,
        • "108": 54,
        • "109": 121,
        • "110": 115,
        • "111": 48,
        • "112": 101,
        • "113": 103,
        • "114": 57,
        • "115": 51,
        • "116": 53,
        • "117": 109,
        • "118": 107,
        • "119": 113,
        • "120": 112,
        • "121": 107,
        • "122": 121,
        • "123": 100,
        • "124": 107,
        • "125": 103,
        • "126": 102,
        • "127": 99,
        • "128": 106,
        • "129": 57,
        • "130": 97,
        • "131": 103,
        • "132": 101,
        • "133": 50,
        • "134": 97,
        • "135": 117,
        • "136": 56,
        • "137": 108,
        • "138": 57,
        • "139": 54,
        • "140": 110,
        • "141": 97,
        • "142": 101,
        • "143": 114,
        • "144": 101,
        • "145": 57,
        • "146": 26,
        • "147": 15,
        • "148": 10,
        • "149": 5,
        • "150": 117,
        • "151": 97,
        • "152": 116,
        • "153": 111,
        • "154": 109,
        • "155": 18,
        • "156": 6,
        • "157": 49,
        • "158": 48,
        • "159": 48,
        • "160": 48,
        • "161": 48,
        • "162": 48,
        • "163": 18,
        • "164": 103,
        • "165": 10,
        • "166": 80,
        • "167": 10,
        • "168": 70,
        • "169": 10,
        • "170": 31,
        • "171": 47,
        • "172": 99,
        • "173": 111,
        • "174": 115,
        • "175": 109,
        • "176": 111,
        • "177": 115,
        • "178": 46,
        • "179": 99,
        • "180": 114,
        • "181": 121,
        • "182": 112,
        • "183": 116,
        • "184": 111,
        • "185": 46,
        • "186": 115,
        • "187": 101,
        • "188": 99,
        • "189": 112,
        • "190": 50,
        • "191": 53,
        • "192": 54,
        • "193": 107,
        • "194": 49,
        • "195": 46,
        • "196": 80,
        • "197": 117,
        • "198": 98,
        • "199": 75,
        • "200": 101,
        • "201": 121,
        • "202": 18,
        • "203": 35,
        • "204": 10,
        • "205": 33,
        • "206": 3,
        • "207": 156,
        • "208": 228,
        • "209": 123,
        • "210": 42,
        • "211": 129,
        • "212": 61,
        • "213": 19,
        • "214": 135,
        • "215": 97,
        • "216": 49,
        • "217": 169,
        • "218": 195,
        • "219": 190,
        • "220": 119,
        • "221": 232,
        • "222": 196,
        • "223": 175,
        • "224": 164,
        • "225": 158,
        • "226": 148,
        • "227": 135,
        • "228": 68,
        • "229": 171,
        • "230": 190,
        • "231": 225,
        • "232": 31,
        • "233": 147,
        • "234": 158,
        • "235": 42,
        • "236": 66,
        • "237": 15,
        • "238": 70,
        • "239": 18,
        • "240": 4,
        • "241": 10,
        • "242": 2,
        • "243": 8,
        • "244": 1,
        • "245": 24,
        • "246": 33,
        • "247": 18,
        • "248": 19,
        • "249": 10,
        • "250": 13,
        • "251": 10,
        • "252": 5,
        • "253": 117,
        • "254": 97,
        • "255": 116,
        • "256": 111,
        • "257": 109,
        • "258": 18,
        • "259": 4,
        • "260": 53,
        • "261": 48,
        • "262": 48,
        • "263": 48,
        • "264": 16,
        • "265": 224,
        • "266": 167,
        • "267": 18,
        • "268": 26,
        • "269": 64,
        • "270": 25,
        • "271": 31,
        • "272": 135,
        • "273": 165,
        • "274": 77,
        • "275": 206,
        • "276": 175,
        • "277": 182,
        • "278": 171,
        • "279": 154,
        • "280": 95,
        • "281": 17,
        • "282": 42,
        • "283": 19,
        • "284": 68,
        • "285": 76,
        • "286": 163,
        • "287": 126,
        • "288": 73,
        • "289": 160,
        • "290": 41,
        • "291": 229,
        • "292": 49,
        • "293": 187,
        • "294": 33,
        • "295": 48,
        • "296": 31,
        • "297": 215,
        • "298": 46,
        • "299": 157,
        • "300": 57,
        • "301": 3,
        • "302": 4,
        • "303": 199,
        • "304": 99,
        • "305": 204,
        • "306": 165,
        • "307": 169,
        • "308": 118,
        • "309": 10,
        • "310": 99,
        • "311": 29,
        • "312": 200,
        • "313": 87,
        • "314": 5,
        • "315": 221,
        • "316": 107,
        • "317": 8,
        • "318": 181,
        • "319": 15,
        • "320": 95,
        • "321": 255,
        • "322": 125,
        • "323": 93,
        • "324": 232,
        • "325": 215,
        • "326": 59,
        • "327": 44,
        • "328": 235,
        • "329": 209,
        • "330": 244,
        • "331": 195,
        • "332": 182,
        • "333": 160
        },
      • "gasUsed": 167798,
      • "gasWanted": 300000
      }
    }
}

ADA

Staking facilities for the Cardano protocol

Stake Transaction

Generates a delegate transaction on Cardano

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet that you wish to delegate from

pool_id
required
string

Pool id to delegate to

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "wallet": "addr1q8rmz6kk2te6z2p44l2uvjgmf5cj5r6l0nwnw6xqk4srnlr5kh8wvl8mw3na7m3fd2py8n3zqs6ueqe0gwcuf9a77z9sxdz9xr",
  • "pool_id": "pool10rdglgh4pzvkf936p2m669qzarr9dusrhmmz9nultm3uvq4eh5k"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "ea62bc381a2d8fc338f24634674a168fdc8f1a09b978f24f026041f4e00c876f",
    • "unsigned_tx_serialized": "84a500818258203d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e100018182583900491a1d0747fa91f319625e39076232ad4cc274e3257f345ced82dbb2a8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b1b0000000255928400021a000493e0031a01ad4330048282008200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b83028200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b581ce54d5f9340218a9816cafafc92dc3d5212b6d149ce75e9637cbcd7e0a0f5f6",
    • "inputs": [
      • {
        • "transaction_id": "3d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e1",
        • "index": 0
        }
      ]
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Cardano

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet that you wish to withdraw rewards to

amount_lovelace
string

Optional amount of rewards to withdraw in lovelace. 1 ADA = 1,000,000 lovelace. If omitted, all available rewards will be withdrawn.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "addr1q8rmz6kk2te6z2p44l2uvjgmf5cj5r6l0nwnw6xqk4srnlr5kh8wvl8mw3na7m3fd2py8n3zqs6ueqe0gwcuf9a77z9sxdz9xr",
  • "amount_lovelace": "1000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "ea62bc381a2d8fc338f24634674a168fdc8f1a09b978f24f026041f4e00c876f",
    • "unsigned_tx_serialized": "84a500818258203d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e100018182583900491a1d0747fa91f319625e39076232ad4cc274e3257f345ced82dbb2a8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b1b0000000255928400021a000493e0031a01ad4330048282008200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b83028200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b581ce54d5f9340218a9816cafafc92dc3d5212b6d149ce75e9637cbcd7e0a0f5f6",
    • "inputs": [
      • {
        • "transaction_id": "3d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e1",
        • "index": 0
        }
      ]
    }
}

Unstake Transaction

Generates an undelegate transaction on Cardano

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet that you wish to undelegate

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "addr1q8rmz6kk2te6z2p44l2uvjgmf5cj5r6l0nwnw6xqk4srnlr5kh8wvl8mw3na7m3fd2py8n3zqs6ueqe0gwcuf9a77z9sxdz9xr"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "ea62bc381a2d8fc338f24634674a168fdc8f1a09b978f24f026041f4e00c876f",
    • "unsigned_tx_serialized": "84a500818258203d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e100018182583900491a1d0747fa91f319625e39076232ad4cc274e3257f345ced82dbb2a8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b1b0000000255928400021a000493e0031a01ad4330048282008200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b83028200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b581ce54d5f9340218a9816cafafc92dc3d5212b6d149ce75e9637cbcd7e0a0f5f6",
    • "inputs": [
      • {
        • "transaction_id": "3d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e1",
        • "index": 0
        }
      ]
    }
}

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

required
Array of objects

Signed messages

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000",
  • "signed_messages": null
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "84a500818258203d244a2821a0cb32df614cf4380e6c6e0114bc7c734cfa2a3940498ad86865e100018182583900491a1d0747fa91f319625e39076232ad4cc274e3257f345ced82dbb2a8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b1b0000000255928400021a000493e0031a01ad4330048282008200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b83028200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b581ce54d5f9340218a9816cafafc92dc3d5212b6d149ce75e9637cbcd7e0a0f5f6"
    }
}

Broadcast Transaction

Broadcast a signed transaction to the Cardano network

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "7f12d9eacd762d130838289397480e495db0fd268bd3be4fd55c74a74fd8372d"
    }
}

Transaction Status

Get the status of a transaction

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=7f12d9eacd762d130838289397480e495db0fd268bd3be4fd55c74a74fd8372d

Hash of the transaction

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "success",
    • "receipt": {
      • "hash": "20082206aadbbb2dfded4afc9346831c5bd3a6a3f8a75f59dbe6166c05e918f6",
      • "block": "2612449e345ec0f58aae05c693a09943f599592e28eedec70ee8c1a4f3d1e834",
      • "block_height": 660450,
      • "block_time": 1677170968,
      • "slot": 21487768,
      • "index": 1,
      • "output_amount": [
        • {
          • "unit": "lovelace",
          • "quantity": "10027100000"
          }
        ],
      • "fees": "300000",
      • "deposit": "2000000",
      • "size": 429,
      • "invalid_before": null,
      • "invalid_hereafter": "21494910",
      • "utxo_count": 2,
      • "withdrawal_count": 0,
      • "mir_cert_count": 0,
      • "delegation_count": 1,
      • "stake_cert_count": 1,
      • "pool_update_count": 0,
      • "pool_retire_count": 0,
      • "asset_mint_or_burn_count": 0,
      • "redeemer_count": 0,
      • "valid_contract": true
      }
    }
}

MATIC

Staking facilities for the Matic protocol

Approve Transaction

Generates an approve transaction to allow a smart contract to spend MATIC tokens on behalf of the user

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet address to approve

contract
required
string

Contract address that needs approval

amount_wei
string

Optional amount to approve in WEI. If not specified, an infinite amount will be approved

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "contract": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "amount_wei": "32000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Buy Voucher Transaction

Generates a buy voucher transaction to buy shares from a validator

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet address

amount_wei
required
string

Amount of MATIC to stake in WEI

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "amount_wei": "32000000000000000000",
  • "validator_share_proxy_address": "0xD14a87025109013B0a2354a775cB335F926Af65A"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Sell Voucher Transaction

Generates a sell voucher transaction to sell shares from a validator. Your token then enter a 3/4 days (80 checkpoints) unbonding period.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet address

amount_wei
required
string

Amount of MATIC to sell in WEI

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "amount_wei": "32000000000000000000",
  • "validator_share_proxy_address": "0xD14a87025109013B0a2354a775cB335F926Af65A"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Unstake Claim Tokens Transaction

Generates an unstakeClaimTokens transaction to withdraw unbonded tokens back to your wallet

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "validator_share_proxy_address": "0xD14a87025109013B0a2354a775cB335F926Af65A"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction to withdraw available rewards to your wallet

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "validator_share_proxy_address": "0xD14a87025109013B0a2354a775cB335F926Af65A"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Restake Rewards Transaction

Generates a restake rewards transaction to restake available rewards to the given validator

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "validator_share_proxy_address": "0xD14a87025109013B0a2354a775cB335F926Af65A"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
    • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Prepare Transaction

Prepare a transaction for broadcasting. It takes a serialized transaction and its signatures and returns a serialized signed transaction that can be broadcasted.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

r
required
string

r part of the ECDSA signature in hex

s
required
string

s part of the ECDSA signature in hex

v
required
number

v part of the ECDSA signature (0 or 1)

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc",
  • "r": "de28e9efee4c8de422a3c64bfaaee11a32f7cf12bdd3f00dcce41a79fe776c65",
  • "s": "3f233eb69495fa4741ad28ef0ba40612bacaf08331fd76041c371f5a2ecc2ab5",
  • "v": 0
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
    }
}

Broadcast Transaction

Broadcasts a signed transaction to the Ethereum network

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "0x20a40259b763d549dfa1c082776a036dd8dabbe8b5e32ee721be017512dc"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94"
    }
}

Transaction Status

Get the status of a transaction on the Ethereum network

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94

Hash of the transaction

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "success",
    • "receipt": {
      • "blockHash": "0x54a0603e3f39e5d358623c8cd86a628a2999c993c1bdd6e547c45632784bd1d7",
      • "blockNumber": 8608123,
      • "contractAddress": null,
      • "cumulativeGasUsed": 8180146,
      • "effectiveGasPrice": 27391741855,
      • "from": "0x9ce658155a6f05fe4aef83b7fa8f431d5e8ccb55",
      • "gasUsed": 70098,
      • "logs": [
        • {
          • "address": "0xff50ed3d0ec03aC01D4C79aAd74928BFF48a7b2b",
          • "blockHash": "0x54a0603e3f39e5d358623c8cd86a628a2999c993c1bdd6e547c45632784bd1d7",
          • "blockNumber": 8608123,
          • "data": "0x00000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000001800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000003093b5ae8053213154d099ed7fc99f571a0c8124601f8a59540335c7c35e0b40aad7b033f84af365185c04812acab257460000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200100000000000000000000009ce658155a6f05fe4aef83b7fa8f431d5e8ccb550000000000000000000000000000000000000000000000000000000000000008004059730700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000609395a07d5e7eb073725049ecba8144d850b7a1a58f603fd1fc12049d32c98db47e3d81608074bca20ccdcc94f7f4767d0d6b852edf4f6231532f33242e64d0617ac93465bc4cdabe9cebf0abe6d169830fcf375b28c0641487e5f86df2875a970000000000000000000000000000000000000000000000000000000000000008ecce030000000000000000000000000000000000000000000000000000000000",
          • "logIndex": 150,
          • "removed": false,
          • "topics": [
            • "0x649bbc62d0e31342afea4e5cd82d4049e7e1ee912fc0889aa790803be39038c5"
            ],
          • "transactionHash": "0x25f259a770539a4be99f972620b74219d67cd990d245bcc8d8ad5cddeaa37375",
          • "transactionIndex": 33,
          • "id": "log_4115d183"
          },
        • {
          • "address": "0x5FaDfdb7eFffd3B4AA03f0F29d9200Cf5F191F31",
          • "blockHash": "0x54a0603e3f39e5d358623c8cd86a628a2999c993c1bdd6e547c45632784bd1d7",
          • "blockNumber": 8608123,
          • "data": "0x000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000003093b5ae8053213154d099ed7fc99f571a0c8124601f8a59540335c7c35e0b40aad7b033f84af365185c04812acab257460000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200100000000000000000000009ce658155a6f05fe4aef83b7fa8f431d5e8ccb55",
          • "logIndex": 151,
          • "removed": false,
          • "topics": [
            • "0x737feedde71ce80c08f73125e4350b001be2dfb6a00fb455086c2b0a514cdfac"
            ],
          • "transactionHash": "0x25f259a770539a4be99f972620b74219d67cd990d245bcc8d8ad5cddeaa37375",
          • "transactionIndex": 33,
          • "id": "log_b4bb5ff7"
          }
        ],
      • "logsBloom": "0x00000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000008000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000008000000000000000000000000000000400000000000000000000000020000000000000000000000000040000000000000000000000000000020000000000000000000000000000000000000000000000000004000000000000000000000000000000000000008000000000000000000000004",
      • "status": true,
      • "to": "0x5fadfdb7efffd3b4aa03f0f29d9200cf5f191f31",
      • "transactionHash": "0x25f259a770539a4be99f972620b74219d67cd990d245bcc8d8ad5cddeaa37375",
      • "transactionIndex": 33,
      • "type": "0x2"
      }
    }
}

NEAR

Staking facilities for the Near protocol

Stakes

Get the status of NEAR stakes

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=validator.testnet_account_1.testnet,validator.testnet_accoun2.testnet

Comma-separated list of Kiln internal stake account ID

wallets
Array of strings
Example: wallets=account_1.testnet,account_2.testnet

Comma-separated list of NEAR account ID

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "stake_account": "validator.testnet_account.testnet",
      • "account": "account.testnet",
      • "validator": "validator.testnet",
      • "balance": "1000000000",
      • "rewards": "1000000000",
      • "unstaked_balance": "1000000000",
      • "can_withdraw": true,
      • "activated_at": "2023-01-14T01:13:59Z",
      • "activated_epoch": 123,
      • "activated_block": 123,
      • "net_apy": 3.407,
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

Create stakes

Create NEAR stakes and linked them to a Kiln account

Authorizations:
bearerAuth
Request Body schema: application/json; charset=utf-8
required

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stakes": [
    • {
      • "stakeAccount": "validator.testnet_account.testnet",
      • "account": "account",
      • "balance": "1000000000"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "tags": [
      • "tag1"
      ],
    • "metadata": { },
    • "protocol": "ethereum",
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards of NEAR stakes

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=validator.testnet_account_1.testnet,validator.testnet_accoun2.testnet

Comma-separated list of Kiln internal stake account ID

wallets
Array of strings
Example: wallets=account_1.testnet,account_2.testnet

Comma-separated list of NEAR account ID

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

format
string
extensible-enum: ["daily","epoch"]

The format of the response. Defaults to daily

start_date
string <date>
Example: start_date=2023-01-10

Get rewards from this date (YYYY-MM-DD)

end_date
string <date>
Example: end_date=2023-01-20

Get rewards to this date (YYYY-MM-DD)

start_epoch
number
Example: start_epoch=542

The epoch from which we want to fetch rewards. Must be used with format=epoch

end_epoch
number
Example: end_epoch=542

The epoch until which we want to fetch rewards. Must be used with format=epoch

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "1000",
      • "active_balance": "1000",
      • "net_apy": 3.407
      }
    ]
}

Reports

Get reports on NEAR staking

Authorizations:
bearerAuth
query Parameters
stake_accounts
Array of strings
Example: stake_accounts=validator.testnet_account_1.testnet,validator.testnet_accoun2.testnet

Comma-separated list of Kiln internal stake account ID

wallets
Array of strings
Example: wallets=account_1.testnet,account_2.testnet

Comma-separated list of NEAR account ID

accounts
Array of strings <uuid> [ items <uuid > ]
Example: accounts=b7177fd2-fbb3-479f-aa92-db9fb16e229f

Comma-separated list of Kiln accounts identifiers

format
string
extensible-enum: ["daily","epoch"]

The format of the response. Defaults to daily

Responses

Network Stats

Get stats on NEAR network

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "nb_validators": 402,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "updated_at": "2023-01-14T01:13:59Z",
    • "near_price_usd": 3.5
    }
}