logo
API docs by Redocly

Kiln API (1.4.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.4.0 (2024-03-22) [link]
  • ETH: Add OnChain V2 reporting routes:
    • GET /v1/eth/onchain/v2/stakes
    • GET /v1/eth/onchain/v2/rewards
    • GET /v1/eth/onchain/v2/operations
    • GET /v1/eth/onchain/v2/network-stats
  • ALL: Add new rewards_usd and stake_balance_usd fields in the /rewards of all protocols
  • ADA: Add new route GET /v1/ada/stakes to list stakes
  • ADA: Add new route GET /v1/ada/rewards to list rewards
  • ADA: Add new route GET /v1/ada/reports to generate an Excel report of stakes and rewards
  • ADA: Add new route POST /v1/ada/stakes to link stakes to Kiln accounts
  • MATIC: Add new route GET /v1/matic/operations to list operations
  • MATIC: Add new route GET /v1/matic/reports to get MATIC stakes reports
  • MATIC: Add new route POST /v1/matic/stakes to link stakes to Kiln accounts
  • MATIC: Add new field unbounds_with_id to MATIC GET /v1/matic/stakes
  • ETH: Add fields execution_claimable_rewards and consensus_claimable_rewards for Kiln on-chain stakes to /v1/eth/stakes route
  • ETH: Add fields exited_epoch and exited_at to /v1/eth/stakes route
  • ETH: Add scope parameter to /v1/eth/stakes and /v1/eth/rewards routes to fetch data from the entire network
  • ETH: Add fields median_execution_rewards, mev_execution_rewards, non_mev_execution_rewards to /v1/eth/rewards route
  • OSMO: Add new route GET /v1/osmo/stakes to list stakes
  • OSMO: Add new route GET /v1/osmo/rewards to list rewards
  • OSMO: Add new method POST /v1/osmo/stakes to link an Osmo stake to a Kiln account
  • OSMO: Add new route GET /v1/osmo/operations to to list operations
  • OSMO: Add new route GET /v1/osmo/network-stats to view network statistics of Osmo
  • OSMO: Add new route GET /v1/osmo/reports to generate an Excel report of stakes and rewards
  • OSMO: Add new route POST /v1/osmo/transaction/restake-rewards to generate a restake-rewards transaction
  • DYDX: Add new route POST /v1/dydx/transaction/stake to generate a delegation transaction
  • DYDX: Add new route GET /v1/dydx/stakes to list stakes
  • DYDX: Add new route GET /v1/dydx/rewards to list rewards
  • DYDX: Add new route GET /v1/dydx/network-stats to view network statistics of Dydx
  • DYDX: Add new route POST /v1/dydx/transaction/withdraw-rewards to generate a withdraw-rewards transaction
  • DYDX: Add new route POST /v1/dydx/transaction/unstake to generate an undelegate transaction
  • DYDX: Add new route POST /v1/dydx/transaction/prepare to prepare a transaction for broadcasting from a payload and a signature
  • DYDX: Add new route POST /v1/dydx/transaction/broadcast to broadcast a signed transaction
  • DYDX: Add new route GET /v1/dydx/transaction/status to view the status of a broadcasted transaction
  • TIA: Add new route POST /v1/tia/transaction/stake to generate a delegation transaction
  • TIA: Add new route POST /v1/tia/transaction/withdraw-rewards to generate a withdraw-rewards transaction
  • TIA: Add new route POST /v1/tia/transaction/restake-rewards to generate a restake-rewards transaction
  • TIA: Add new route POST /v1/tia/transaction/unstake to generate an undelegate transaction
  • TIA: Add new route POST /v1/tia/transaction/prepare to prepare a transaction for broadcasting from a payload and a signature
  • TIA: Add new route POST /v1/tia/transaction/broadcast to broadcast a signed transaction
  • TIA: Add new route GET /v1/tia/transaction/status to view the status of a broadcasted transaction
  • TIA: Add new route GET /v1/tia/stakes to list stakes
  • TIA: Add new route GET /v1/tia/rewards to list rewards
  • TIA: Add new route GET /v1/tia/operations to list operations
  • TIA: Add new route GET /v1/tia/network-stats to view network statistics of Celestia
  • TIA: Add new route GET /v1/tia/reports to generate an Excel report of stakes and rewards
  • ATOM: Add new route POST /v1/atom/transaction/restake-rewards to generate a restake-rewards transaction
  • XTZ: Add a new parameter validators to GET /v1/xtz/stakes to list stakes
  • XTZ: Add a new parameter validators to GET /v1/xtz/rewards to list rewards
  • XTZ: Add a new parameter validators to GET /v1/xtz/operations to list operations
  • ZETA: Add new route GET /v1/zeta/stakes to list stakes
  • ZETA: Add new route GET /v1/zeta/rewards to list rewards
  • ZETA: Add new route GET /v1/zeta/operations to list operations
  • ZETA: Add new route GET /v1/zeta/network-stats to view network statistics of Zeta
Version 1.3.0 (2023-12-04) [link]
  • MATIC: Add new route GET /v1/matic/stakes to list stakes
  • MATIC: Add new route GET /v1/matic/rewards to list rewards
  • MATIC: Add new route GET /v1/matic/network-stats to view network statistics of Polygon
  • ATOM: Add new route POST /v1/atom/transaction/redelegate to craft a redelegate transaction on ATOM
  • OSMO: Add new route GET /v1/osmo/network-stats to view network statistics of Osmosis
  • EGLD: Add new route GET /v1/egld/network-stats to view network statistics of MutilversX
  • NEAR: Add new route GET /v1/near/operations to list operations
  • SOL: Add start_date and end_date to /v1/atom/operations route to filter operations by date
  • SOL: Add start_date and end_date to /v1/eth/operations route to filter operations by date
  • SOL: Add start_date and end_date to /v1/sol/operations route to filter operations by date
  • SOL: Add start_date and end_date to /v1/xtz/operations route to filter operations by date
  • ATOM: Add field unbondings to /v1/atom/stakes route
  • DOT: Add tx crafting endpoints
  • ETH: Add new route GET /v1/eth/transaction/decode to decode a transaction
  • XTZ: Add new route GET /v1/xtz/transaction/decode to decode a transaction
  • SOL: Add new route GET /v1/sol/transaction/decode to decode a transaction
  • ADA: Add new route GET /v1/ada/transaction/decode to decode a transaction
  • MATIC: Add new route GET /v1/matic/transaction/decode to decode a transaction
  • OSMO: Add new route GET /v1/osmo/transaction/decode to decode a transaction
  • NEAR: Add new route GET /v1/near/transaction/decode to decode a transaction
  • DOT: Add new route GET /v1/dot/transaction/decode to decode a transaction
  • ETH: Add new route GET /v1/eth/transaction/exit-request to craft an EIP-1559 exit-request transaction ready to be signed
  • OSMO: Add new route POST /v1/osmo/transaction/stake to generate a delegation transaction
  • OSMO: Add new route POST /v1/osmo/transaction/withdraw-rewards to generate a withdraw-rewards transaction
  • OSMO: Add new route POST /v1/osmo/transaction/unstake to generate an undelegate transaction
  • OSMO: Add new route POST /v1/osmo/transaction/redelegate to broadcast a redelegate transaction
  • OSMO: Add new route POST /v1/osmo/transaction/prepare to prepare a transaction for broadcasting from a payload and a signature
  • OSMO: Add new route POST /v1/osmo/transaction/broadcast to broadcast a signed transaction
  • OSMO: Add new route GET /v1/osmo/transaction/status to view the status of a broadcasted transaction
Version 1.2.0 (2023-09-06) [link]
  • ETH: Add dedicated routes to generate keys for Kiln Smart-Contracts
  • 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 (on-demand)
  • 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 an Atom stake to a Kiln 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: Add 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 
    • <li>
  ORGANIZATIONS: Add the ability to get an organization portfolio via GET
  <b>/v1/organizations/{id}/portfolio</b>
</li>

<li>
  ETH: Add the ability to query <b>/v1/eth/stakes</b>,
  <b>/v1/eth/rewards</b>, <b>/v1/eth/operations</b> by <b>proxies</b> and
  <b>validator_indexes</b>
</li>
<li>
  ETH: Add <b>validator_index</b> in the responses of <b>/v1/eth/stakes</b>,
  <b>/v1/eth/rewards</b> and <b>/v1/eth/operations</b>
</li>
<li>ETH: Add <b>delegated_at</b> field to <b>/v1/eth/stakes</b></li>
<li>ETH: Add <b>is_kiln</b> field to <b>/v1/eth/stakes</b></li>
<li>ETH: Add <b>eth_price_usd</b> to <b>/v1/eth/netwok-stats</b></li>
<li>
  ETH: Add <b>estimated_entry_time_seconds</b> to
  <b>/v1/eth/netwok-stats</b>
</li>
<li>
  ETH: Add <b>estimated_exit_time_seconds</b> to <b>/v1/eth/netwok-stats</b>
</li>
<li>
  ETH: Add <b>estimated_withdrawal_time_seconds</b> to
  <b>/v1/eth/netwok-stats</b>
</li>
<li>
  ETH: Add POST method to <b>/v1/eth/stakes</b> to link a stake to a Kiln
  account
</li>
<li>
  ETH: Add new route GET <b>/v1/eth/operations</b> to list on-chain
  operations on a stake
</li>
<li>
  ETH: Add new route GET <b>/v1/eth/kiln-stats</b> to expose Kiln
  operational statistics
</li>
<li>
  ETH: Add new route POST <b>/v1/eth/keys</b> to generate ready-to-stake
  deposit data payloads
</li>
<li>
  ETH: Add new route POST <b>/v1/eth/transaction/stake</b> to generate an
  EIP-1559 staking transaction ready to be signed
</li>
<li>
  ETH: Add new route POST <b>/v1/eth/transaction/prepare</b> to craft a
  transaction ready to be broadcast from a payload and a signature
</li>
<li>
  ETH: Add new route POST <b>/v1/eth/transaction/broadcast</b> to broadcast
  a signed transaction
</li>
<li>
  ETH: Add new route GET <b>/v1/eth/transaction/status</b> to get the status
  of a broadcasted transaction
</li>
<li>
  ETH: Add new route GET <b>/v1/eth/reports</b> to generate an Excel report
  of stakes and rewards
</li>
<li>
  ETH: Use the protocol definition of effective balance in
  <b>/v1/eth/rewards</b> for the <b>stake_balance</b> field instead of a
  custom implementation
</li>

<li>XTZ: Add new route GET <b>/v1/xtz/stakes</b> to list stakes</li>
<li>XTZ: Add new route GET <b>/v1/xtz/rewards</b> to list rewards</li>
<li>
  XTZ: Add new route GET <b>/v1/xtz/operations</b> to list on-chain
  operations of a stake
</li>
<li>
  XTZ: Add new route GET <b>/v1/xtz/network-stats</b> to view network
  statistics of Tezos
</li>
<li>
  XTZ: Add new route GET <b>/v1/xtz/reports</b> to generate an Excel report
</li>
<li>
  XTZ: Add new route POST <b>/v1/xtz/transaction/stake</b> to generate a
  delegation transaction
</li>
<li>
  XTZ: Add new route POST <b>/v1/xtz/transaction/unstake</b> to generate an
  undelegation transaction
</li>
<li>
  XTZ: Add new route POST <b>/v1/xtz/transaction/prepare</b> to prepare a
  transaction for broadcasting from a payload and a signature
</li>
<li>
  XTZ: Add new route POST <b>/v1/xtz/transaction/broadcast</b> to broadcast
  a signed transaction
</li>
<li>
  XTZ: Add new route GET <b>/v1/xtz/transaction/status</b> to view the
  status of a broadcasted transaction
</li>

<li>SOL: Add new route GET <b>/v1/sol/stakes</b> to list stakes</li>
<li>
  SOL: Add new method POST <b>/v1/sol/stakes</b> to link a stake to a Solana
  account
</li>
<li>SOL: Add new route GET <b>/v1/sol/rewards</b> to list rewards</li>
<li>
  SOL: Add new route GET <b>/v1/sol/operations</b> to list on-chain
  operations of a stake
</li>
<li>
  SOL: Add new route GET <b>/v1/sol/network-stats</b> to view network
  statistics of Solana
</li>
<li>
  SOL: Add new route GET <b>/v1/sol/reports</b> to generate an Excel report
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/stake</b> to generate a
  delegation transaction
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/deactivate-stake</b> to
  generate a deactivate transaction
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/withdraw-stake</b> to
  prepare a withdraw stake transaction
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/merge-stakes</b> to prepare
  a merge stakes transaction
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/split-stake</b> to prepare
  a split stake transaction
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/prepare</b> to prepare any
  transaction from a payload and signature
</li>
<li>
  SOL: Add new route POST <b>/v1/sol/transaction/broadcast</b> to broadcast
  a signed transaction
</li>
<li>
  SOL: Add new route GET <b>/v1/sol/transaction/status</b> to view the
  status of a broadcasted transaction
</li>

<li>
  ADA: Add new route POST <b>/v1/ada/transaction/stake</b> to generate a
  delegation transaction
</li>
<li>
  ADA: Add new route POST <b>/v1/ada/transaction/withdraw-rewards</b> to
  generate a withdraw-rewards transaction
</li>
<li>
  ADA: Add new route POST <b>/v1/ada/transaction/unstake</b> to generate an
  undelegate transaction
</li>
<li>
  ADA: Add new route POST <b>/v1/ada/transaction/prepare</b> to prepare a
  transaction for broadcasting from a payload and a signature
</li>
<li>
  ADA: Add new route POST <b>/v1/ada/transaction/broadcast</b> to broadcast
  a signed transaction
</li>
<li>
  ADA: Add new route GET <b>/v1/ada/transaction/status</b> to view the
  status of a broadcasted transaction
</li>

<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/approve</b> to generate
  a transaction to allow a smart-contract to spend MATIC tokens on behalf of
  the user
</li>
<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/buy-voucher</b> to
  generate a transaction to buy shares from a validator
</li>
<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/sell-voucher</b> to
  generate a transaction to sell shares from a validator
</li>
<li>
  MATIC: Add new route POST
  <b>/v1/matic/transaction/unstake-claim-tokens</b> to generate a
  transaction to withdraw unbounded tokens
</li>
<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/withdraw-rewards</b> to
  generate a transaction to withdraw rewards
</li>
<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/restake-rewards</b> to
  generate a transaction to restake rewards
</li>
<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/prepare</b> to prepare
  a signed transaction for broadcasting
</li>
<li>
  MATIC: Add new route POST <b>/v1/matic/transaction/broadcast</b> to
  broadcast a prepared transaction
</li>
<li>
  MATIC: Add new route GET <b>/v1/matic/transaction/status</b> to view the
  status of a broadcasted transaction
</li>
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.

REWARDS BEHAVIOR

  • No start_date: Returns rewards from validator activation date.
  • No end_date: Returns rewards up to yesterday.

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
        }
      ],
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

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
        }
      ],
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

ADA

Staking facilities for the Cardano protocol

Stakes

Get the status of Cardano stakes

Authorizations:
bearerAuth
query Parameters
stake_addresses
string
Example: stake_addresses=stake1upv7j2865m2283cgruttmg8g4l24xy6xzzjmzrq3d8urqvqla4ngk

Comma separated list of stake addresses

wallets
string
Example: wallets=addr1qqumsdyju8ee4tvee7kyzd6jenkl9jvgdjtzqlf729wqd66eay504fk550rss8ckhksw3t742vf5vy99kyxpz60cxqcqdeu78t

Comma separated list of wallet addresses

pool_ids
string
Example: pool_ids=pool10rdglgh4pzvkf936p2m669qzarr9dusrhmmz9nultm3uvq4eh5k

Comma separated list of pool ids. If used with wallets or stake_addresses, it will return the intersection of the results

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": [
    • {
      • "wallet_addresses": [
        • "addr_test1qqumsdyju8ee4tvee7kyzd6jenkl9jvgdjtzqlf729wqd66eay504fk550rss8ckhksw3t742vf5vy99kyxpz60cxqcqdeu78t"
        ],
      • "stake_address": "stake_test1upv7j2865m2283cgruttmg8g4l24xy6xzzjmzrq3d8urqvqla4ngk",
      • "pool_id": "pool1u4x4ly6qyx9fs9k2lt7f9hpa2gftd52fee67jcmuhnt7qqae3x0",
      • "balance": "30004690613",
      • "rewards": "37201548",
      • "available_rewards": "4588",
      • "delegated_epoch": 42,
      • "delegated_at": "2023-01-06T22:00:00Z",
      • "activated_epoch": 44,
      • "activated_at": "2023-01-16T22:00:00Z",
      • "state": "active",
      • "net_apy": 0.188014
      }
    ]
}

Create stakes

Link ADA 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": [
    • {
      • "stakeAddress": "stake1u84uqy85qpsln9a49dtv7mrzzp0246v7s2cj7ypjr555ldqenardf"
      }
    ],
  • "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 ADA stakes

Authorizations:
bearerAuth
query Parameters
stake_addresses
string
Example: stake_addresses=stake1upv7j2865m2283cgruttmg8g4l24xy6xzzjmzrq3d8urqvqla4ngk

Comma separated list of stake addresses

pool_ids
string
Example: pool_ids=pool10rdglgh4pzvkf936p2m669qzarr9dusrhmmz9nultm3uvq4eh5k

Comma separated list of pool ids. If used with wallets or stake_addresses, it will return the intersection of the results

wallets
string
Example: wallets=addr1qqumsdyju8ee4tvee7kyzd6jenkl9jvgdjtzqlf729wqd66eay504fk550rss8ckhksw3t742vf5vy99kyxpz60cxqcqdeu78t

Comma separated list of wallet 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

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

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

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

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

start_epoch
number
Example: start_epoch=46

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

end_epoch
number
Example: end_epoch=48

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "rewards": "1000000",
      • "date": "2023-01-06",
      • "active_balance": "1000000",
      • "net_apy": 3.05,
      • "rewards_usd": 0,
      • "stake_balance_usd": 0
      }
    ]
}

Reports

Get reports on Cardano staking

Authorizations:
bearerAuth
query Parameters
stake_addresses
string
Example: stake_addresses=stake1upv7j2865m2283cgruttmg8g4l24xy6xzzjmzrq3d8urqvqla4ngk

Comma separated list of stake addresses

wallets
string
Example: wallets=addr1qqumsdyju8ee4tvee7kyzd6jenkl9jvgdjtzqlf729wqd66eay504fk550rss8ckhksw3t742vf5vy99kyxpz60cxqcqdeu78t

Comma separated list of wallet 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

Network Stats

Get some network statistics on ADA staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "network_gross_apy": 3.3,
    • "ada_price_usd": 0.29,
    • "supply_staked_percent": 62.24,
    • "updated_at": "2023-08-09T11:41:36Z"
    }
}

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

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=84a50081825820ec36e28de84b27ead8da428efd8ab9a1d2c0aaaec5a5f485451bdf48cb2d795800018182583900491a1d0747fa91f319625e39076232ad4cc274e3257f345ced82dbb2a8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b1b0000000254f866e0021a000493e0031a02612452048183028200581ca8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b581ce54d5f9340218a9816cafafc92dc3d5212b6d149ce75e9637cbcd7e0a0f5f6

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "body": {
    • "inputs": [
      • {
        • "transaction_id": "ec36e28de84b27ead8da428efd8ab9a1d2c0aaaec5a5f485451bdf48cb2d7958",
        • "index": 0
        }
      ],
    • "outputs": [
      • {
        • "address": "addr_test1qpy358g8glafrucevf0rjpmzx2k5esn5uvjh7dzuakpdhv4g2egyt3y3qw6jrguz0lmyhxygjdg2ytaf5z6ueaety7dsmpcee5",
        • "amount": {
          • "coin": "10015500000"
          }
        }
      ],
    • "fee": "300000",
    • "ttl": "39920722",
    • "certs": [
      • {
        • "StakeDelegation": {
          • "stake_credential": {
            • "Key": "a8565045c49103b521a3827ff64b98889350a22fa9a0b5ccf72b279b"
            },
          • "pool_keyhash": "e54d5f9340218a9816cafafc92dc3d5212b6d149ce75e9637cbcd7e0"
          }
        }
      ]
    },
  • "witness_set": { },
  • "is_valid": true
}

ATOM

Staking facilities for the ATOM protocol

Stakes

Retrieve the status of ATOM stakes, expressed in uATOM (10⁻⁶ ATOM). All stakes that have been active since Theta v7 (12/04/2022) are available. For stakes without a specific delegation timestamp, the API computes the status based on the first available reward snapshot to provide a comprehensive overview.

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",
      • "permissions": [
        • {
          • "source": "granter",
          • "creation_height": 15000000,
          • "permission": "Staking.MsgDelegate",
          • "expires_at": "2023-01-10T01:12:34Z",
          • "allow_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]",
          • "deny_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]"
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

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"
      }
    ],
  • "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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

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

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

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

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

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

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": "cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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 public key (compressed or uncompressed), this is different than the wallet address

validator
required
string

Validator address

amount_uatom
required
string

Amount to stake in uATOM

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

Responses

Request samples

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

Response samples

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

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 public key (compressed or uncompressed), 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": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2"
}

Response samples

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

Restake Rewards Transaction

Generates a restake rewards transaction on Cosmos

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

Transaction to craft

pubkey
required
string

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

validator_address
required
string

Validator address

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "0adf010adc010a2a2f636f736d6f732e7374616b696e672e763162657461312e4d7367426567696e526564656c656761746512ad010a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f70657231307636777664656e65653872396c36776c73706863677572326c746c387a746b6672766a39611a34636f736d6f7376616c6f70657231796d7a336b6a7466397a6b666d6d3273326c7279376568307a6439657a33766335797030306622100a057561746f6d12073433313030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186d12130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a",
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2",
        • "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 public key (compressed or uncompressed), 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": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2",
  • "amount_uatom": "1000000000000000000000000"
}

Response samples

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

Redelegate Transaction

Generates a redelegate transaction on Cosmos to move a stake from a validator to another without going through the 21 days unbonding period.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to which the new stake will be linked

pubkey
required
string

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

validator_source
required
string

Validator source address of current stake

validator_destination
required
string

Validator destination address to which redelegate the stake

amount_uatom
string

Amount to redelegate in uATOM

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "0adf010adc010a2a2f636f736d6f732e7374616b696e672e763162657461312e4d7367426567696e526564656c656761746512ad010a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f70657231307636777664656e65653872396c36776c73706863677572326c746c387a746b6672766a39611a34636f736d6f7376616c6f70657231796d7a336b6a7466397a6b666d6d3273326c7279376568307a6439657a33766335797030306622100a057561746f6d12073433313030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186d12130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a",
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2",
        • "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 public key (compressed or uncompressed), 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": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2"
              }
            ]
          },
        • {
          • "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": "cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2"
              },
            • {
              • "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\":\"cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2\"},{\"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\":\"cosmosvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqvwdul2\"}]}]}]",
      • "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
      }
    }
}

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=0aa1010a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d12073130303030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186612130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "authInfo": {
    • "signerInfos": [
      • {
        • "publicKey": {
          • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
          • "value": {
            • "0": 10,
            • "1": 33,
            • "2": 3,
            • "3": 156,
            • "4": 228,
            • "5": 123,
            • "6": 42,
            • "7": 129,
            • "8": 61,
            • "9": 19,
            • "10": 135,
            • "11": 97,
            • "12": 49,
            • "13": 169,
            • "14": 195,
            • "15": 190,
            • "16": 119,
            • "17": 232,
            • "18": 196,
            • "19": 175,
            • "20": 164,
            • "21": 158,
            • "22": 148,
            • "23": 135,
            • "24": 68,
            • "25": 171,
            • "26": 190,
            • "27": 225,
            • "28": 31,
            • "29": 147,
            • "30": 158,
            • "31": 42,
            • "32": 66,
            • "33": 15,
            • "34": 70
            }
          },
        • "modeInfo": {
          • "single": {
            • "mode": 1
            }
          },
        • "sequence": {
          • "low": 102,
          • "high": 0,
          • "unsigned": true
          }
        }
      ],
    • "fee": {
      • "amount": [
        • {
          • "denom": "uatom",
          • "amount": "5000"
          }
        ],
      • "gasLimit": {
        • "low": 2000000,
        • "high": 0,
        • "unsigned": true
        },
      • "payer": "",
      • "granter": ""
      }
    },
  • "body": {
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "0": 10,
          • "1": 45,
          • "2": 99,
          • "3": 111,
          • "4": 115,
          • "5": 109,
          • "6": 111,
          • "7": 115,
          • "8": 49,
          • "9": 57,
          • "10": 99,
          • "11": 57,
          • "12": 102,
          • "13": 100,
          • "14": 104,
          • "15": 52,
          • "16": 56,
          • "17": 56,
          • "18": 118,
          • "19": 113,
          • "20": 106,
          • "21": 99,
          • "22": 108,
          • "23": 108,
          • "24": 116,
          • "25": 119,
          • "26": 112,
          • "27": 54,
          • "28": 56,
          • "29": 106,
          • "30": 109,
          • "31": 53,
          • "32": 48,
          • "33": 121,
          • "34": 100,
          • "35": 119,
          • "36": 121,
          • "37": 104,
          • "38": 51,
          • "39": 54,
          • "40": 106,
          • "41": 113,
          • "42": 101,
          • "43": 97,
          • "44": 116,
          • "45": 101,
          • "46": 118,
          • "47": 18,
          • "48": 52,
          • "49": 99,
          • "50": 111,
          • "51": 115,
          • "52": 109,
          • "53": 111,
          • "54": 115,
          • "55": 118,
          • "56": 97,
          • "57": 108,
          • "58": 111,
          • "59": 112,
          • "60": 101,
          • "61": 114,
          • "62": 49,
          • "63": 54,
          • "64": 121,
          • "65": 115,
          • "66": 48,
          • "67": 101,
          • "68": 103,
          • "69": 57,
          • "70": 51,
          • "71": 53,
          • "72": 109,
          • "73": 107,
          • "74": 113,
          • "75": 112,
          • "76": 107,
          • "77": 121,
          • "78": 100,
          • "79": 107,
          • "80": 103,
          • "81": 102,
          • "82": 99,
          • "83": 106,
          • "84": 57,
          • "85": 97,
          • "86": 103,
          • "87": 101,
          • "88": 50,
          • "89": 97,
          • "90": 117,
          • "91": 56,
          • "92": 108,
          • "93": 57,
          • "94": 54,
          • "95": 110,
          • "96": 97,
          • "97": 101,
          • "98": 114,
          • "99": 101,
          • "100": 57,
          • "101": 26,
          • "102": 16,
          • "103": 10,
          • "104": 5,
          • "105": 117,
          • "106": 97,
          • "107": 116,
          • "108": 111,
          • "109": 109,
          • "110": 18,
          • "111": 7,
          • "112": 49,
          • "113": 48,
          • "114": 48,
          • "115": 48,
          • "116": 48,
          • "117": 48,
          • "118": 48
          }
        }
      ],
    • "memo": "",
    • "timeoutHeight": {
      • "low": 0,
      • "high": 0,
      • "unsigned": true
      },
    • "extensionOptions": [ ],
    • "nonCriticalExtensionOptions": [ ]
    },
  • "signatures": [
    • {
      • "0": 116,
      • "1": 104,
      • "2": 101,
      • "3": 116,
      • "4": 97,
      • "5": 45,
      • "6": 116,
      • "7": 101,
      • "8": 115,
      • "9": 116,
      • "10": 110,
      • "11": 101,
      • "12": 116,
      • "13": 45,
      • "14": 48,
      • "15": 48,
      • "16": 49
      }
    ]
}

DOT

Staking facilities for the Polkadot protocol

Network Stats

Get stats on Polkadot network

Authorizations:
bearerAuth

Responses

Response samples

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

Bond Transaction

Generates a bond transaction on Polkadot

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

stash_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

reward_destination
required
string

Reward destination address. You can also set it to "Stash" to accumulate rewards in the stash account or "Staked" to accumulate rewards in the stash account and stake them (auto-compounding).

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000",
  • "reward_destination": "Staked"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Bond extra Transaction

Generates a bond extra transaction on Polkadot

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Rebond Transaction

Generates a rebond transaction on Polkadot (to be used to rebond unbonding token)

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Unbond Transaction

Generates an unbond transaction on Polkadot

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Nominate Transaction

Generates a nominate transaction on Polkadot

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

validator_addresses
required
Array of strings

List of validator addresses to nominate

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "validator_addresses": [
    • "5FEjMPSs4X2XNes7QRH6eLmaYCskHdnYM8Zv2kKrBrhnzGbR"
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Withdraw unbonded Transaction

Generates a withdraw unbonded transaction on Polkadot

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Chill Transaction

Generates a chill transaction on Polkadot

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Set payee Transaction

Generates a set payee transaction on Polkadot

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

Transaction to craft

stash_account
required
string

Wallet address controlling the stake

reward_destination
required
string

Reward destination address. You can also set it to "Stash" to accumulate rewards in the stash account or "Staked" to accumulate rewards in the stash account and stake them (auto-compounding).

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stash_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "reward_destination": "Staked"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Join pool Transaction

Generates a join pool transaction on Polkadot

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

member_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

pool_id
required
string

Id of the pool to join. This can be found on explorers like Subscan

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "member_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000",
  • "pool_id": "118"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Bond extra to pool Transaction

Generates a bond extra to pool transaction on Polkadot

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

Transaction to craft

member_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "member_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Bond rewards to pool Transaction

Generates a bond rewards to pool transaction on Polkadot

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

Transaction to craft

member_account
required
string

Wallet address controlling the stake

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "member_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Claim payout from pool Transaction

Generates a claim payout (rewards) from pool transaction on Polkadot

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

Transaction to craft

member_account
required
string

Wallet address controlling the stake

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "member_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Unbond from pool Transaction

Generates an unbond from pool transaction on Polkadot

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

Transaction to craft

member_account
required
string

Wallet address controlling the stake

amount_planck
required
string

Amount in planck

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "member_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "amount_planck": "100000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Withdraw unbonded from pool Transaction

Generates a withdraw unbonded from pool transaction on Polkadot

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

Transaction to craft

member_account
required
string

Wallet address controlling the stake

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "member_account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_payload": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24eb5001d0100d624000016000000e143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
    • "unsigned_tx_serialized": "7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832386333366166303134356663623963383738383531303136313739303439663035373938386263383035393930373332666461353664343563343865313235222c22626c6f636b4e756d626572223a2230783031313035303862222c22657261223a22307862353030222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303437222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d",
    • "unsigned_tx": {
      • "blockHash": "0x28c36af0145fcb9c878851016179049f057988bc805990732fda56d45c48e125",
      • "eraPeriod": 64,
      • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
      • "metadataRpc": "0x",
      • "method": {
        • "args": {
          • "value": "1000000000000",
          • "payee": {
            • "account": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
            }
          },
        • "name": "bond",
        • "pallet": "staking"
        },
      • "nonce": 71,
      • "specVersion": 9430,
      • "tip": 0,
      • "transactionVersion": 22
      }
    }
}

Transaction Status

Get the status of a transaction

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

Hash of the transaction

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "code": 0,
    • "message": "Success",
    • "generated_at": 1697471079,
    • "data": {
      • "block_timestamp": 1697211912,
      • "block_num": 17860727,
      • "extrinsic_index": "17860727-2",
      • "call_module_function": "join",
      • "call_module": "nominationpools",
      • "account_id": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
      • "signature": "0x3e80f71312c759ebffeea594f48c0f66cd276e821b37496bef98ef760ee58a6c6289a9656c32a3f23146cdf6d07f9ef9d046c669570d4e4e778b87de43106b06",
      • "nonce": 80,
      • "extrinsic_hash": "0x1b9097a6e3d50066348cb173f3150546457a6188fada6a3a40d571798da1a53c",
      • "success": false,
      • "params": [
        • {
          • "name": "amount",
          • "type": "compact<U128>",
          • "type_name": "BalanceOf",
          • "value": "100000000000"
          },
        • {
          • "name": "pool_id",
          • "type": "U32",
          • "type_name": "PoolId",
          • "value": 1
          }
        ],
      • "transfer": null,
      • "event": [
        • {
          • "event_index": "17860727-2",
          • "block_num": 17860727,
          • "extrinsic_idx": 2,
          • "module_id": "balances",
          • "event_id": "Withdraw",
          • "params": "[{\"type\":\"[U8; 32]\",\"type_name\":\"AccountId\",\"value\":\"0x373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e\",\"name\":\"who\"},{\"type\":\"U128\",\"type_name\":\"Balance\",\"value\":\"14717944072\",\"name\":\"amount\"}]",
          • "phase": 0,
          • "event_idx": 5,
          • "extrinsic_hash": "0x1b9097a6e3d50066348cb173f3150546457a6188fada6a3a40d571798da1a53c",
          • "finalized": true,
          • "block_timestamp": 0
          },
        • {
          • "event_index": "17860727-2",
          • "block_num": 17860727,
          • "extrinsic_idx": 2,
          • "module_id": "balances",
          • "event_id": "Deposit",
          • "params": "[{\"type\":\"[U8; 32]\",\"type_name\":\"AccountId\",\"value\":\"0x767f36484b1e2acf5c265c7a64bfb46e95259c66a8189bbcd216195def436852\",\"name\":\"who\"},{\"type\":\"U128\",\"type_name\":\"Balance\",\"value\":\"14717944072\",\"name\":\"amount\"}]",
          • "phase": 0,
          • "event_idx": 6,
          • "extrinsic_hash": "0x1b9097a6e3d50066348cb173f3150546457a6188fada6a3a40d571798da1a53c",
          • "finalized": true,
          • "block_timestamp": 0
          },
        • {
          • "event_index": "17860727-2",
          • "block_num": 17860727,
          • "extrinsic_idx": 2,
          • "module_id": "transactionpayment",
          • "event_id": "TransactionFeePaid",
          • "params": "[{\"type\":\"[U8; 32]\",\"type_name\":\"AccountId\",\"value\":\"0x373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e\",\"name\":\"who\"},{\"type\":\"U128\",\"type_name\":\"BalanceOf\",\"value\":\"14717944072\",\"name\":\"actual_fee\"},{\"type\":\"U128\",\"type_name\":\"BalanceOf\",\"value\":\"0\",\"name\":\"tip\"}]",
          • "phase": 0,
          • "event_idx": 7,
          • "extrinsic_hash": "0x1b9097a6e3d50066348cb173f3150546457a6188fada6a3a40d571798da1a53c",
          • "finalized": true,
          • "block_timestamp": 0
          },
        • {
          • "event_index": "17860727-2",
          • "block_num": 17860727,
          • "extrinsic_idx": 2,
          • "module_id": "system",
          • "event_id": "ExtrinsicFailed",
          • "params": "[{\"type\":\"sp_runtime:DispatchError\",\"type_name\":\"DispatchError\",\"value\":{\"Module\":{\"error\":\"0x04000000\",\"index\":29}},\"name\":\"dispatch_error\"},{\"type\":\"frame_support:dispatch:DispatchInfo\",\"type_name\":\"DispatchInfo\",\"value\":{\"class\":\"Normal\",\"pays_fee\":\"Yes\",\"weight\":{\"proof_size\":8877,\"ref_time\":1949112000}},\"name\":\"dispatch_info\"}]",
          • "phase": 0,
          • "event_idx": 8,
          • "extrinsic_hash": "0x1b9097a6e3d50066348cb173f3150546457a6188fada6a3a40d571798da1a53c",
          • "finalized": true,
          • "block_timestamp": 0
          }
        ],
      • "event_count": 4,
      • "fee": "14717944072",
      • "fee_used": "14717944072",
      • "error": {
        • "module": "NominationPools",
        • "name": "AccountBelongsToOtherPool",
        • "doc": "An account is already delegating in another pool. An account may only belong to one,pool at a time.",
        • "value": "",
        • "batch_index": -1
        },
      • "finalized": true,
      • "lifetime": {
        • "birth": 17860724,
        • "death": 17860788
        },
      • "tip": "0",
      • "account_display": {
        • "address": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj"
        },
      • "block_hash": "0x60f526ec0e82a958f6d72e9b9b9d1be392c079bf0c7248e309dd899134add9ee",
      • "pending": false
      }
    }
}

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=7b2261646472657373223a2235444b38536871747975566b32773471724639487761424a6f695a5631627951733541525a336466325074385636566a222c2261737365744964223a302c22626c6f636b48617368223a22307832636361356238303836613437636161646166663537373563333237666637326231326461616438316464386664363339333336663264393462396365386466222c22626c6f636b4e756d626572223a2230783031313139353364222c22657261223a22307864353033222c2267656e6573697348617368223a22307865313433663233383033616335306538663666386536323639356431636539653465316436386161333663316364326366643135333430323133663334323365222c226d65746164617461527063223a223078222c226d6574686f64223a22307830363030303730303130613564346538303333373363366638653834633638323261396638373033356636356363636638393965656633666364656536313037373034316139336531383035626162323465222c226e6f6e6365223a2230783030303030303565222c227369676e6564457874656e73696f6e73223a5b22436865636b4e6f6e5a65726f53656e646572222c22436865636b5370656356657273696f6e222c22436865636b547856657273696f6e222c22436865636b47656e65736973222c22436865636b4d6f7274616c697479222c22436865636b4e6f6e6365222c22436865636b576569676874222c224368617267655472616e73616374696f6e5061796d656e74225d2c227370656356657273696f6e223a2230783030303032346436222c22746970223a2230783030303030303030303030303030303030303030303030303030303030303030222c227472616e73616374696f6e56657273696f6e223a2230783030303030303136222c2276657273696f6e223a347d

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "address": "5DK8ShqtyuVk2w4qrF9HwaBJoiZV1byQs5ARZ3df2Pt8V6Vj",
  • "assetId": 0,
  • "blockHash": "0x2cca5b8086a47caadaff5775c327ff72b12daad81dd8fd639336f2d94b9ce8df",
  • "blockNumber": "0x0111953d",
  • "era": "0xd503",
  • "genesisHash": "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
  • "metadataRpc": "0x",
  • "method": "0x0600070010a5d4e803373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e",
  • "nonce": "0x0000005e",
  • "signedExtensions": [
    • "CheckNonZeroSender",
    • "CheckSpecVersion",
    • "CheckTxVersion",
    • "CheckGenesis",
    • "CheckMortality",
    • "CheckNonce",
    • "CheckWeight",
    • "ChargeTransactionPayment"
    ],
  • "specVersion": "0x000024d6",
  • "tip": "0x00000000000000000000000000000000",
  • "transactionVersion": "0x00000016",
  • "version": 4
}

Prepare Transaction

Prepare a transaction for broadcast on Polkadot by adding a signature to it

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

Signature of the transaction

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcast a signed transaction on Polkadot

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": "0xc1018400373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00ce178c21ced7677c58ebfb93496dd0a305581bfead9d1e1d7834dd8448dd81612a24548a8650650bb75747b5bfd5fc9373903cacf81bfabed7ae05e53dd5ae0fc5001901000601070010a5d4e8"
}

Response samples

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

DYDX

Staking facilities for the DYDX protocol

Stakes

Get the status of DYDX stakes. Units are in uDYDX (10⁻⁶ DYDX).

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

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=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "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",
      • "permissions": [
        • {
          • "source": "granter",
          • "creation_height": 15000000,
          • "permission": "Staking.MsgDelegate",
          • "expires_at": "2023-01-10T01:12:34Z",
          • "allow_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]",
          • "deny_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]"
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes

Link a DYDX 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": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu}_cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl"
      }
    ],
  • "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 DYDX stakes. Units are in uDYDX (10⁻⁶ DYDX).

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

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=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

Operations

Get the operations of DYDX stakes. Units are in uDYDX (10⁻⁶ DYDX).

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

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=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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 data from this date (YYYY-MM-DD)

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

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

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": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "delegator_address": "dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
      • "amount": "3000000",
      • "withdraw_rewards": "10841"
      }
    ]
}

Network Stats

Get some network statistics on dYdX

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,
    • "dydx_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=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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=dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu

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 DYDX

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 public key (compressed or uncompressed), this is different than the wallet address

validator
required
string

Validator address

amount_adydx
required
string

Amount to stake in uDYDX

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

Responses

Request samples

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

Response samples

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

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on DYDX

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

Transaction to craft

pubkey
required
string

Wallet public key (compressed or uncompressed), 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": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
}

Response samples

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

Restake Rewards Transaction

Generates a restake rewards transaction on Dydx

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

Transaction to craft

pubkey
required
string

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

validator_address
required
string

Validator address

Responses

Request samples

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

Response samples

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

Unstake Transaction

Generates an undelegate transaction on DYDX

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

amount_adydx
string

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

Responses

Request samples

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

Response samples

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

Redelegate Transaction

Generates a redelegate transaction on DYDX to move a stake from a validator to another without going through the 30 days unbonding period.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to which the new stake will be linked

pubkey
required
string

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

validator_source
required
string

Validator source address of current stake

validator_destination
required
string

Validator destination address to which redelegate the stake

amount_adydx
string

Amount to redelegate in uDYDX

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "0adf010adc010a2a2f636f736d6f732e7374616b696e672e763162657461312e4d7367426567696e526564656c656761746512ad010a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f70657231307636777664656e65653872396c36776c73706863677572326c746c387a746b6672766a39611a34636f736d6f7376616c6f70657231796d7a336b6a7466397a6b666d6d3273326c7279376568307a6439657a33766335797030306622100a057561746f6d12073433313030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186d12130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a",
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "adydx",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "adydx",
          • "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 public key (compressed or uncompressed), 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 DYDX 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": "5000adydx"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "amount",
              • "value": "5000adydx"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5000adydx"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              }
            ]
          },
        • {
          • "type": "tx",
          • "attributes": [
            • {
              • "key": "fee",
              • "value": "5000adydx"
              },
            • {
              • "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": "5adydx"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5adydx"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              },
            • {
              • "key": "amount",
              • "value": "5adydx"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              }
            ]
          },
        • {
          • "type": "withdraw_rewards",
          • "attributes": [
            • {
              • "key": "amount",
              • "value": "5adydx"
              },
            • {
              • "key": "validator",
              • "value": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
              }
            ]
          },
        • {
          • "type": "coin_spent",
          • "attributes": [
            • {
              • "key": "spender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "100000adydx"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh"
              },
            • {
              • "key": "amount",
              • "value": "100000adydx"
              }
            ]
          },
        • {
          • "type": "delegate",
          • "attributes": [
            • {
              • "key": "validator",
              • "value": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
              },
            • {
              • "key": "amount",
              • "value": "100000adydx"
              },
            • {
              • "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\":\"5adydx\"},{\"key\":\"receiver\",\"value\":\"cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh\"},{\"key\":\"amount\",\"value\":\"100000adydx\"}]},{\"type\":\"coin_spent\",\"attributes\":[{\"key\":\"spender\",\"value\":\"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl\"},{\"key\":\"amount\",\"value\":\"5adydx\"},{\"key\":\"spender\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"},{\"key\":\"amount\",\"value\":\"100000adydx\"}]},{\"type\":\"delegate\",\"attributes\":[{\"key\":\"validator\",\"value\":\"dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu\"},{\"key\":\"amount\",\"value\":\"100000adydx\"},{\"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\":\"5adydx\"}]},{\"type\":\"withdraw_rewards\",\"attributes\":[{\"key\":\"amount\",\"value\":\"5adydx\"},{\"key\":\"validator\",\"value\":\"dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu\"}]}]}]",
      • "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
      }
    }
}

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=0aa1010a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d12073130303030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186612130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "authInfo": {
    • "signerInfos": [
      • {
        • "publicKey": {
          • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
          • "value": {
            • "0": 10,
            • "1": 33,
            • "2": 3,
            • "3": 156,
            • "4": 228,
            • "5": 123,
            • "6": 42,
            • "7": 129,
            • "8": 61,
            • "9": 19,
            • "10": 135,
            • "11": 97,
            • "12": 49,
            • "13": 169,
            • "14": 195,
            • "15": 190,
            • "16": 119,
            • "17": 232,
            • "18": 196,
            • "19": 175,
            • "20": 164,
            • "21": 158,
            • "22": 148,
            • "23": 135,
            • "24": 68,
            • "25": 171,
            • "26": 190,
            • "27": 225,
            • "28": 31,
            • "29": 147,
            • "30": 158,
            • "31": 42,
            • "32": 66,
            • "33": 15,
            • "34": 70
            }
          },
        • "modeInfo": {
          • "single": {
            • "mode": 1
            }
          },
        • "sequence": {
          • "low": 102,
          • "high": 0,
          • "unsigned": true
          }
        }
      ],
    • "fee": {
      • "amount": [
        • {
          • "denom": "uosmo",
          • "amount": "5000"
          }
        ],
      • "gasLimit": {
        • "low": 2000000,
        • "high": 0,
        • "unsigned": true
        },
      • "payer": "",
      • "granter": ""
      }
    },
  • "body": {
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "0": 10,
          • "1": 45,
          • "2": 99,
          • "3": 111,
          • "4": 115,
          • "5": 109,
          • "6": 111,
          • "7": 115,
          • "8": 49,
          • "9": 57,
          • "10": 99,
          • "11": 57,
          • "12": 102,
          • "13": 100,
          • "14": 104,
          • "15": 52,
          • "16": 56,
          • "17": 56,
          • "18": 118,
          • "19": 113,
          • "20": 106,
          • "21": 99,
          • "22": 108,
          • "23": 108,
          • "24": 116,
          • "25": 119,
          • "26": 112,
          • "27": 54,
          • "28": 56,
          • "29": 106,
          • "30": 109,
          • "31": 53,
          • "32": 48,
          • "33": 121,
          • "34": 100,
          • "35": 119,
          • "36": 121,
          • "37": 104,
          • "38": 51,
          • "39": 54,
          • "40": 106,
          • "41": 113,
          • "42": 101,
          • "43": 97,
          • "44": 116,
          • "45": 101,
          • "46": 118,
          • "47": 18,
          • "48": 52,
          • "49": 99,
          • "50": 111,
          • "51": 115,
          • "52": 109,
          • "53": 111,
          • "54": 115,
          • "55": 118,
          • "56": 97,
          • "57": 108,
          • "58": 111,
          • "59": 112,
          • "60": 101,
          • "61": 114,
          • "62": 49,
          • "63": 54,
          • "64": 121,
          • "65": 115,
          • "66": 48,
          • "67": 101,
          • "68": 103,
          • "69": 57,
          • "70": 51,
          • "71": 53,
          • "72": 109,
          • "73": 107,
          • "74": 113,
          • "75": 112,
          • "76": 107,
          • "77": 121,
          • "78": 100,
          • "79": 107,
          • "80": 103,
          • "81": 102,
          • "82": 99,
          • "83": 106,
          • "84": 57,
          • "85": 97,
          • "86": 103,
          • "87": 101,
          • "88": 50,
          • "89": 97,
          • "90": 117,
          • "91": 56,
          • "92": 108,
          • "93": 57,
          • "94": 54,
          • "95": 110,
          • "96": 97,
          • "97": 101,
          • "98": 114,
          • "99": 101,
          • "100": 57,
          • "101": 26,
          • "102": 16,
          • "103": 10,
          • "104": 5,
          • "105": 117,
          • "106": 97,
          • "107": 116,
          • "108": 111,
          • "109": 109,
          • "110": 18,
          • "111": 7,
          • "112": 49,
          • "113": 48,
          • "114": 48,
          • "115": 48,
          • "116": 48,
          • "117": 48,
          • "118": 48
          }
        }
      ],
    • "memo": "",
    • "timeoutHeight": {
      • "low": 0,
      • "high": 0,
      • "unsigned": true
      },
    • "extensionOptions": [ ],
    • "nonCriticalExtensionOptions": [ ]
    },
  • "signatures": [
    • {
      • "0": 116,
      • "1": 104,
      • "2": 101,
      • "3": 116,
      • "4": 97,
      • "5": 45,
      • "6": 116,
      • "7": 101,
      • "8": 115,
      • "9": 116,
      • "10": 110,
      • "11": 101,
      • "12": 116,
      • "13": 45,
      • "14": 48,
      • "15": 48,
      • "16": 49
      }
    ]
}

EGLD

Staking facilities for the MultiversX protocol

Network Stats

Get stats on MutiversX 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",
    • "egld_price_usd": 3.5
    }
}

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

scope
string
Example: scope=network
extensible-enum: ["kiln","network"]

Scope of validators to fetch (all network, all kiln keys)

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. The definition of a proxy is a smart contract that was involved in the deposit transaction and emitted a log.

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

include_eigenlayer
boolean
Example: include_eigenlayer=true

Include EigenLayer reporting data

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). Not available with the scope parameter

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,
      • "exited_at": "2023-01-14T01:13:59Z",
      • "exited_epoch": 174049,
      • "deposit_tx_sender": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "execution_fee_recipient": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "effective_balance": "32000000000000000000",
      • "balance": "32076187808000000000",
      • "consensus_rewards": "76187808000000000",
      • "execution_rewards": "0",
      • "rewards": "76187808000000000",
      • "claimable_execution_rewards": "76187808000000000",
      • "claimable_consensus_rewards": "76187808000000000",
      • "gross_apy": 3.407,
      • "is_kiln": true,
      • "updated_at": "2023-01-14T01:13:59Z",
      • "eigenlayer": {
        • "withdrawals": [
          • {
            • "amount": "32000000000000000000",
            • "created_at_block": 19190700,
            • "claimable": true,
            • "claimable_at_block": 19200000
            }
          ],
        • "restaked_points": "10000000000000000"
        }
      }
    ],
  • "pagination": {
    • "current_page": 2,
    • "next_page": 3,
    • "previous_page": 1,
    • "page_size": 25,
    • "total_pages": 17,
    • "total_entries": 423
    }
}

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": [
    • {
      • "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,
      • "exited_at": "2023-01-14T01:13:59Z",
      • "exited_epoch": 174049,
      • "deposit_tx_sender": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "execution_fee_recipient": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "effective_balance": "32000000000000000000",
      • "balance": "32076187808000000000",
      • "consensus_rewards": "76187808000000000",
      • "execution_rewards": "0",
      • "rewards": "76187808000000000",
      • "claimable_execution_rewards": "76187808000000000",
      • "claimable_consensus_rewards": "76187808000000000",
      • "gross_apy": 3.407,
      • "is_kiln": true,
      • "updated_at": "2023-01-14T01:13:59Z",
      • "eigenlayer": {
        • "withdrawals": [
          • {
            • "amount": "32000000000000000000",
            • "created_at_block": 19190700,
            • "claimable": true,
            • "claimable_at_block": 19200000
            }
          ],
        • "restaked_points": "10000000000000000"
        }
      }
    ],
  • "pagination": {
    • "current_page": 2,
    • "next_page": 3,
    • "previous_page": 1,
    • "page_size": 25,
    • "total_pages": 17,
    • "total_entries": 423
    }
}

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

scope
string
Example: scope=network
extensible-enum: ["kiln","network"]

Scope of validators to fetch (all network, all kiln keys)

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. The definition of a proxy is a smart contract that was involved in the deposit transaction and emitted a log.

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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "consensus_rewards": "2988504000000000",
      • "execution_rewards": "0",
      • "mev_execution_rewards": "0",
      • "non_mev_execution_rewards": "0",
      • "median_execution_reward": "0",
      • "rewards": "2988504000000000",
      • "stake_balance": "64000000000000000000",
      • "gross_apy": 3.407,
      • "cl_apy": 3.407,
      • "el_apy": 0,
      • "active_validator_count": 152636.33,
      • "rewards_usd": 0,
      • "stake_balance_usd": 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. The definition of a proxy is a smart contract that was involved in the deposit transaction and emitted a log.

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 data from this date (YYYY-MM-DD)

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

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

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"
      }
    ]
}

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"
      }
    }
}

Request Exit

Generates an Ethereum EIP 1559 request-exit transaction

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

Transaction to craft

wallet
required
string

Wallet to request-exit from, it must be the owner of the stake.

validators
required
Array of strings

Public keys of the validators to exit

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
  • "validators": [
    • "0x8015a0ef9bf2cf742b5dc34c117ecd0191f27a8748a40cdfa27dbbbe6d6a52066d0743e8a9b7f5c7c2e9fa6db4943a70"
    ]
}

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

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=02f902dc058202978477359400847735940a830223d4945fadfdb7efffd3b4aa03f0f29d9200cf5f191f318901bc16d674ec800000b902a4ca0bfcce0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a0000000000000000000000000000000000000000000000000000000000000026000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000003084eefa87510e735d0e6db65fde2c940517c197f252a0e40b90adf693d7198fa8c610a7b710b5fcaa54fe0dbbc87c0bb500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060b15db0eddc3bdd62a10ec61ff120a6870d176b55249beab45223659547610e688195189e4f614447e68bfe055d903d1a0a74d82af486d01cfd75b9469fcdf776d99ef633ca3797c8670608a5f391f61694ae61f5573f79c90ea719fbe0d23c2d0000000000000000000000000000000000000000000000000000000000000001fb0c78163db38377fbe3e570d5a29ef4345b73087b9f60ec46a06589f6a6bb19c0808080

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "r": "0x0000000000000000000000000000000000000000000000000000000000000000",
  • "s": "0x0000000000000000000000000000000000000000000000000000000000000000",
  • "v": "27",
  • "yParity": 0,
  • "chainId": 5,
  • "type": "eip1559",
  • "to": "0x5fadfdb7efffd3b4aa03f0f29d9200cf5f191f31",
  • "gas": "140244",
  • "data": "0xca0bfcce0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a0000000000000000000000000000000000000000000000000000000000000026000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000003084eefa87510e735d0e6db65fde2c940517c197f252a0e40b90adf693d7198fa8c610a7b710b5fcaa54fe0dbbc87c0bb500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060b15db0eddc3bdd62a10ec61ff120a6870d176b55249beab45223659547610e688195189e4f614447e68bfe055d903d1a0a74d82af486d01cfd75b9469fcdf776d99ef633ca3797c8670608a5f391f61694ae61f5573f79c90ea719fbe0d23c2d0000000000000000000000000000000000000000000000000000000000000001fb0c78163db38377fbe3e570d5a29ef4345b73087b9f60ec46a06589f6a6bb19",
  • "nonce": 663,
  • "value": "32000000000000000000",
  • "maxFeePerGas": "2000000010",
  • "maxPriorityFeePerGas": "2000000000",
  • "functionName": "batchDeposit",
  • "args": [
    • [
      • "0x84eefa87510e735d0e6db65fde2c940517c197f252a0e40b90adf693d7198fa8c610a7b710b5fcaa54fe0dbbc87c0bb5"
      ],
    • [
      • "0x010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994"
      ],
    • [
      • "0xb15db0eddc3bdd62a10ec61ff120a6870d176b55249beab45223659547610e688195189e4f614447e68bfe055d903d1a0a74d82af486d01cfd75b9469fcdf776d99ef633ca3797c8670608a5f391f61694ae61f5573f79c90ea719fbe0d23c2d"
      ],
    • [
      • "0xfb0c78163db38377fbe3e570d5a29ef4345b73087b9f60ec46a06589f6a6bb19"
      ]
    ]
}

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

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"
      }
    ]
}

LST Deposits on EigenLayer

Get deposits of Liquid staking tokens on the EigenLayer strategy manager

Authorizations:
bearerAuth
query Parameters
wallet
required
string
Example: wallet=0x991c468AbcE2b4DD627a6210C145373EbABdd186

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "tx_hash": "0x2ce13a526671452bcde46d84c38298ad8a6e0d1d0d18306839dd810bb0aaccc4",
      • "block_number": 19190141,
      • "timestamp": 1707476531,
      • "shares": "10000000000000000",
      • "amount": "10000000000000000",
      • "token": {
        • "symbol": "stETH",
        • "address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
        }
      }
    ]
}

LST Withdrawals on EigenLayer

Get withdrawals of Liquid staking tokens on the EigenLayer strategy manager

Authorizations:
bearerAuth
query Parameters
wallet
required
string
Example: wallet=0x991c468AbcE2b4DD627a6210C145373EbABdd186

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "tx_hash": "0x4a0580dd8b8397b775bca31d8546ac78aeb639bc0b8a5fb7542058194e3a428d",
      • "block_number": 19190700,
      • "timestamp": 1707483287,
      • "delegated_to": "0x0000000000000000000000000000000000000000",
      • "claimed": false,
      • "claimed_tx_hash": "0x00000000",
      • "claimable": true,
      • "claimable_at_block": 19190700,
      • "tokens": [
        • {
          • "shares": "1951305012863276",
          • "token": {
            • "symbol": "stETH",
            • "address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
            }
          }
        ],
      • "nonce": 4,
      • "withdrawer": "0x991c468abce2b4dd627a6210c145373ebabdd186",
      • "depositor": "0x991c468abce2b4dd627a6210c145373ebabdd186"
      }
    ]
}

LST Points on EigenLayer

Get restaked points of Liquid staking tokens on EigenLayer

Authorizations:
bearerAuth
query Parameters
wallet
required
string
Example: wallet=0x991c468AbcE2b4DD627a6210C145373EbABdd186

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "token": {
        • "symbol": "stETH",
        • "address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
        },
      • "points": "10000000000000000"
      }
    ]
}

Validation On-Chain V1 Keys

Create Ethereum validation keys for the Kiln On-Chain V1 smart-contract suite. This route is for Ethereum operators only of the Kiln On-Chain V1 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
required
string

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

staking_contract_address
required
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 On-Chain V2 Keys

Create Ethereum validation keys for the Kiln On-Chain V2 smart-contract suite. This route is for Ethereum operators only of the Kiln On-Chain V2 (vSuite) smart-contract of type vNFT. Use /v1/eth/keys if you want to use Kiln On-Chain V2 of type vPool (ERC20) or classic native staking.

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

Ethereum keys to generate on withdrawal channel 0 (vNFT) 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"
      }
    ]
}

On-Chain V2 Stakes

Get the status of Ethereum OnChain V2 (vSuite) stakes

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "owner": "0x41bf25fc8c52d292bd66d3bcecd8a919ecb9ef88",
      • "integrator": "Pooled Staked ETH",
      • "integrator_address": "0x5db5235b5c7e247488784986e58019fffd98fda4",
      • "balance": "300000000",
      • "rewards": "300000000",
      • "nrr": 3.407,
      • "structure": [
        • {
          • "pool": "Kiln",
          • "pool_address": "0x00a0be1bbc0c99898df7e6524bf16e893c1e3bb9",
          • "share": 0.5
          }
        ],
      • "delegated_block": 123,
      • "delegated_at": "2023-01-14T01:13:59Z",
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

On-Chain V2 Operations

Get the operations of Ethereum OnChain V2 (vSuite) operations

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

ids
Array of strings
Example: ids=15458, 15459

Comma-separated list of operation IDs

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

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

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "id": "10970",
      • "owner": "0x41bf25fc8c52d292bd66d3bcecd8a919ecb9ef88",
      • "time": "2023-09-11T12:54:36.000Z",
      • "block": "9676129",
      • "tx_hash": "0xce804f083605289e5a1e1d197876067e1d59474e3dbf7faf65f44e7f3db72722",
      • "type": "exit",
      • "ticket_id": "6125082604576892342340792916294922100547",
      • "ticket_status": "unfulfillable",
      • "size": "49982523094294339",
      • "size_shares": "50157843875857851",
      • "claimable": "0",
      • "claimable_shares": "0",
      • "cask_ids": [
        • "43"
        ]
      }
    ]
}

On-Chain V2 Rewards

Get historical rewards of Ethereum OnChain V2 (vSuite) daily rewards

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

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

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

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

integration
string
Example: integration=0x65da6aecfa84b77a25a7e83e65cd3c6bda12186c

The address of the pooling integration

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "1000",
      • "balance": "1000",
      • "nrr": 3.407,
      • "rewards_usd": 400,
      • "balance_usd": 3400
      }
    ]
}

On-Chain V2 Network Stats

Get the network stats of Ethereum OnChain V2 (vSuite) integration

Authorizations:
bearerAuth
query Parameters
integration
string
Example: integration=0x65da6aecfa84b77a25a7e83e65cd3c6bda12186c

The address of the pooling integration

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "address": "0x5db5235b5c7e247488784986e58019fffd98fda4",
    • "name": "Pooled Staked ETH",
    • "symbol": "psETH",
    • "fee": 10,
    • "nrr": 3.407,
    • "total_supply": "104865118570632775697",
    • "total_underlying_supply": "103891951311279705404",
    • "pools": [
      • {
        • "address": "0x00a0be1bbc0c99898df7e6524bf16e893c1e3bb9",
        • "name": "Kiln",
        • "ratio": 100,
        • "commission": 10,
        • "total_deposited": "104865118570632775697",
        • "factory_address": "0xc63d9f0040d35f328274312fc8771a986fc4ba86",
        • "operator_address": "0xf9ef220543aaf0f4dc999382741883ce776064fb"
        }
      ]
    }
}

MATIC

Staking facilities for the Polygon protocol

Stakes

Get the status of Polygon stakes. All stakes made prior to the Ethereum block n°16430248 (18/01/2023) aren't fully sync-ed and will have incorrect data.

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' 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": [
    • {
      • "delegator_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "validator_index": "1",
      • "state": "active",
      • "delegated_block": 6307582,
      • "delegated_at": "2022-02-02T08:31:07Z",
      • "balance": "11364372934211323407387",
      • "shares": "126664878892234995894",
      • "unbounded_balance": "11364372934211323407387",
      • "unbounded_epoch": 8,
      • "is_unbounding_complete": true,
      • "rewards": "689020902235393456944",
      • "net_apy": 4.066307880973232,
      • "available_rewards": "659936623311645699",
      • "updated_at": "2023-07-31T13:56:58Z",
      • "unbounds_with_id": [
        • {
          • "nonce": 1,
          • "balance": "11364372934211323407387",
          • "epoch": 8,
          • "is_complete": true
          }
        ]
      }
    ]
}

Create stakes

Link MATIC 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": [
    • {
      • "stakeId": "1_0x9ce658155a6f05fe4aef83b7fa8f431d5e8ccb55"
      }
    ],
  • "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 Polygon stakes. All stakes made prior to the Ethereum block n°16430248 (18/01/2023) aren't fully sync-ed and will have lower than expected rewards.

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' 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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

Operations

Get the operations of Polygon stakes. All operations made prior to the Ethereum block n°16430248 (18/01/2023) are unknown to the API.

Authorizations:
bearerAuth
query Parameters
wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' 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 data from this date (YYYY-MM-DD)

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "share_minted",
      • "block": 15955054,
      • "time": "2023-07-31T13:56:58Z",
      • "tx_hash": "0x43244f90814b31dec250de24df5bb023a338790c1d5a39244cf1064cf6d98c94",
      • "tx_index": 1,
      • "tx_sender": "0x41bf25fc8c52d292bd66d3bcecd8a919ecb9ef88",
      • "tx_method_name": "buyVoucher",
      • "tx_gas_used": "2700999916653262",
      • "tx_effective_gas_price": "1499997889",
      • "tx_cumulative_gas_used": "1499997889",
      • "validator_id": 1,
      • "user": "0xa",
      • "amount": "300000000",
      • "tokens": "300000000"
      }
    ]
}

Network Stats

Get some network statistics on Polygon staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "network_gross_apy": 4.5,
    • "nb_validators": 100,
    • "supply_staked_percent": 20.4,
    • "updated_at": "2023-07-31T13:56:58Z",
    • "matic_price_usd": 0.84
    }
}

Reports

Get reports on Polygon staking

Authorizations:
bearerAuth
query Parameters
validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

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",
    • "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
    }
}

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",
    • "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
    }
}

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",
    • "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
    }
}

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",
    • "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
    }
}

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",
    • "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
    }
}

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",
    • "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 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"
      }
    }
}

Transaction Decoding

Decode a transaction of the Ethereum network

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=02f872058202a08477359400847735940b8307a12094499d11e0b6eac7c0593d8fb292dcbbf815fb29ae80b844095ea7b300000000000000000000000000200ea4ee292e253e6ca07dba5edc07c8aa37a3000000000000000000000000000000000000000000000001bc16d674ec800000c0808080

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "r": "0xe8998c51a896ee46bba670b71d8c6f64358dda0496b6c02489270f34f9db5da7",
  • "s": "0x599a297b1b05dc6f086f91e9d4f01aeda22620a8c53123bbd072f2d6fd85413b",
  • "v": "28",
  • "yParity": 1,
  • "chainId": 5,
  • "type": "eip1559",
  • "to": "0x1a9155ead92cd339e3ae789fd3a5dc60ae268634",
  • "gas": "266040",
  • "data": "0x6ab1507100000000000000000000000000000000000000000000000009b6f55d1246b6ec0000000000000000000000000000000000000000000000000000000000000000",
  • "nonce": 152,
  • "maxFeePerGas": "1500000019",
  • "maxPriorityFeePerGas": "1500000000"
}

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

validators
Array of strings
Example: validators=validator.testnet_1,validator.testnet_2

Comma-separated list of NEAR validator 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

validators
Array of strings
Example: validators=validator.testnet_1,validator.testnet_2

Comma-separated list of NEAR validator 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 data from this date (YYYY-MM-DD)

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

Get data 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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

Operations

Get the operations 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

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 data from this date (YYYY-MM-DD)

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "receipt_id": "5f5tskdja3MP4YajQuvhz9bmvY4CqJsYunVKbPcEUEFw",
      • "type": "unstake, unstake_all, withdraw, withdraw_all, withdraw, stake, stake_all",
      • "time": "2023-06-22T15:35:01.892644Z",
      • "block": 15828207,
      • "tx_hash": "DvzvJVCsm63RiRo8iEdZUEtTwDty2Wb14yqrUr5v9naa",
      • "tx_fees": "17304",
      • "validator": "validator.testnet",
      • "account": "account.testnet",
      • "amount": "1000000000000000000000000"
      }
    ]
}

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

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=400000003337336336663865383463363832326139663837303335663635636363663839396565663366636465653631303737303431613933653138303562616232346500373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e26a81fd1f55a0000100000006b696c6e2e706f6f6c76312e6e656172a75498ee0fed386c3335285f934672b386ee6632362fad2bcd5fc5931495e3830100000002110000006465706f7369745f616e645f7374616b65020000007b7d00c06e31d9100100000080f64ae1c7022d15000000000000

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "signerId": "373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e",
  • "publicKey": {
    • "keyType": 0,
    • "data": {
      • "0": 55,
      • "1": 60,
      • "2": 111,
      • "3": 142,
      • "4": 132,
      • "5": 198,
      • "6": 130,
      • "7": 42,
      • "8": 159,
      • "9": 135,
      • "10": 3,
      • "11": 95,
      • "12": 101,
      • "13": 204,
      • "14": 207,
      • "15": 137,
      • "16": 158,
      • "17": 239,
      • "18": 63,
      • "19": 205,
      • "20": 238,
      • "21": 97,
      • "22": 7,
      • "23": 112,
      • "24": 65,
      • "25": 169,
      • "26": 62,
      • "27": 24,
      • "28": 5,
      • "29": 186,
      • "30": 178,
      • "31": 78
      }
    },
  • "nonce": "5af5d11fa826",
  • "receiverId": "kiln.poolv1.near",
  • "blockHash": {
    • "0": 167,
    • "1": 84,
    • "2": 152,
    • "3": 238,
    • "4": 15,
    • "5": 237,
    • "6": 56,
    • "7": 108,
    • "8": 51,
    • "9": 53,
    • "10": 40,
    • "11": 95,
    • "12": 147,
    • "13": 70,
    • "14": 114,
    • "15": 179,
    • "16": 134,
    • "17": 238,
    • "18": 102,
    • "19": 50,
    • "20": 54,
    • "21": 47,
    • "22": 173,
    • "23": 43,
    • "24": 205,
    • "25": 95,
    • "26": 197,
    • "27": 147,
    • "28": 20,
    • "29": 149,
    • "30": 227,
    • "31": 131
    },
  • "actions": [
    • {
      • "functionCall": {
        • "methodName": "deposit_and_stake",
        • "args": [
          • 123,
          • 125
          ],
        • "gas": "0110d9316ec000",
        • "deposit": "152d02c7e14af6800000"
        },
      • "enum": "functionCall"
      }
    ]
}

OSMO

Staking facilities for the OSMO protocol

Stakes

Get the status of OSMO stakes. Units are in uOSMO (10⁻⁶ OSMO).

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

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=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
      • "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",
      • "permissions": [
        • {
          • "source": "granter",
          • "creation_height": 15000000,
          • "permission": "Staking.MsgDelegate",
          • "expires_at": "2023-01-10T01:12:34Z",
          • "allow_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]",
          • "deny_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]"
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes

Link an OSMO 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": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy}_cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl"
      }
    ],
  • "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 OSMO stakes. Units are in uOSMO (10⁻⁶ OSMO).

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

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=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

Operations

Get the operations of OSMO stakes. Units are in uOSMO (10⁻⁶ OSMO).

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

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=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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 data from this date (YYYY-MM-DD)

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

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

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": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
      • "delegator_address": "osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3",
      • "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,
    • "osmosis_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=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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=osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy

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 Osmosis

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 public key (compressed or uncompressed), this is different than the wallet address

validator
required
string

Validator address

amount_uosmo
required
string

Amount to stake in uOSMO

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

Responses

Request samples

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

Response samples

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

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Osmosis

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

Transaction to craft

pubkey
required
string

Wallet public key (compressed or uncompressed), 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": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy"
}

Response samples

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

Restake Rewards Transaction

Generates a restake rewards transaction on Osmosis

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

Transaction to craft

pubkey
required
string

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

validator_address
required
string

Validator address

Responses

Request samples

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

Response samples

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

Unstake Transaction

Generates an undelegate transaction on Osmosis

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

amount_uosmo
string

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

Responses

Request samples

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

Response samples

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

Redelegate Transaction

Generates a redelegate transaction on Osmosis to move a stake from a validator to another without going through the 14 days unbonding period.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to which the new stake will be linked

pubkey
required
string

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

validator_source
required
string

Validator source address of current stake

validator_destination
required
string

Validator destination address to which redelegate the stake

amount_uosmo
string

Amount to redelegate in uOSMO

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "0adf010adc010a2a2f636f736d6f732e7374616b696e672e763162657461312e4d7367426567696e526564656c656761746512ad010a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f70657231307636777664656e65653872396c36776c73706863677572326c746c387a746b6672766a39611a34636f736d6f7376616c6f70657231796d7a336b6a7466397a6b666d6d3273326c7279376568307a6439657a33766335797030306622100a057561746f6d12073433313030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186d12130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a",
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
        • "amount": {
          • "denom": "uosmo",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uosmo",
          • "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 public key (compressed or uncompressed), 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": "5000uosmo"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "amount",
              • "value": "5000uosmo"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5000uosmo"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              }
            ]
          },
        • {
          • "type": "tx",
          • "attributes": [
            • {
              • "key": "fee",
              • "value": "5000uosmo"
              },
            • {
              • "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": "5uosmo"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5uosmo"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              },
            • {
              • "key": "amount",
              • "value": "5uosmo"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              }
            ]
          },
        • {
          • "type": "withdraw_rewards",
          • "attributes": [
            • {
              • "key": "amount",
              • "value": "5uosmo"
              },
            • {
              • "key": "validator",
              • "value": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy"
              }
            ]
          },
        • {
          • "type": "coin_spent",
          • "attributes": [
            • {
              • "key": "spender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "100000uosmo"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh"
              },
            • {
              • "key": "amount",
              • "value": "100000uosmo"
              }
            ]
          },
        • {
          • "type": "delegate",
          • "attributes": [
            • {
              • "key": "validator",
              • "value": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy"
              },
            • {
              • "key": "amount",
              • "value": "100000uosmo"
              },
            • {
              • "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\":\"5uosmo\"},{\"key\":\"receiver\",\"value\":\"cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh\"},{\"key\":\"amount\",\"value\":\"100000uosmo\"}]},{\"type\":\"coin_spent\",\"attributes\":[{\"key\":\"spender\",\"value\":\"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl\"},{\"key\":\"amount\",\"value\":\"5uosmo\"},{\"key\":\"spender\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"},{\"key\":\"amount\",\"value\":\"100000uosmo\"}]},{\"type\":\"delegate\",\"attributes\":[{\"key\":\"validator\",\"value\":\"osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy\"},{\"key\":\"amount\",\"value\":\"100000uosmo\"},{\"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\":\"5uosmo\"}]},{\"type\":\"withdraw_rewards\",\"attributes\":[{\"key\":\"amount\",\"value\":\"5uosmo\"},{\"key\":\"validator\",\"value\":\"osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy\"}]}]}]",
      • "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
      }
    }
}

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=0aa1010a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d12073130303030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186612130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "authInfo": {
    • "signerInfos": [
      • {
        • "publicKey": {
          • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
          • "value": {
            • "0": 10,
            • "1": 33,
            • "2": 3,
            • "3": 156,
            • "4": 228,
            • "5": 123,
            • "6": 42,
            • "7": 129,
            • "8": 61,
            • "9": 19,
            • "10": 135,
            • "11": 97,
            • "12": 49,
            • "13": 169,
            • "14": 195,
            • "15": 190,
            • "16": 119,
            • "17": 232,
            • "18": 196,
            • "19": 175,
            • "20": 164,
            • "21": 158,
            • "22": 148,
            • "23": 135,
            • "24": 68,
            • "25": 171,
            • "26": 190,
            • "27": 225,
            • "28": 31,
            • "29": 147,
            • "30": 158,
            • "31": 42,
            • "32": 66,
            • "33": 15,
            • "34": 70
            }
          },
        • "modeInfo": {
          • "single": {
            • "mode": 1
            }
          },
        • "sequence": {
          • "low": 102,
          • "high": 0,
          • "unsigned": true
          }
        }
      ],
    • "fee": {
      • "amount": [
        • {
          • "denom": "uosmo",
          • "amount": "5000"
          }
        ],
      • "gasLimit": {
        • "low": 2000000,
        • "high": 0,
        • "unsigned": true
        },
      • "payer": "",
      • "granter": ""
      }
    },
  • "body": {
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "0": 10,
          • "1": 45,
          • "2": 99,
          • "3": 111,
          • "4": 115,
          • "5": 109,
          • "6": 111,
          • "7": 115,
          • "8": 49,
          • "9": 57,
          • "10": 99,
          • "11": 57,
          • "12": 102,
          • "13": 100,
          • "14": 104,
          • "15": 52,
          • "16": 56,
          • "17": 56,
          • "18": 118,
          • "19": 113,
          • "20": 106,
          • "21": 99,
          • "22": 108,
          • "23": 108,
          • "24": 116,
          • "25": 119,
          • "26": 112,
          • "27": 54,
          • "28": 56,
          • "29": 106,
          • "30": 109,
          • "31": 53,
          • "32": 48,
          • "33": 121,
          • "34": 100,
          • "35": 119,
          • "36": 121,
          • "37": 104,
          • "38": 51,
          • "39": 54,
          • "40": 106,
          • "41": 113,
          • "42": 101,
          • "43": 97,
          • "44": 116,
          • "45": 101,
          • "46": 118,
          • "47": 18,
          • "48": 52,
          • "49": 99,
          • "50": 111,
          • "51": 115,
          • "52": 109,
          • "53": 111,
          • "54": 115,
          • "55": 118,
          • "56": 97,
          • "57": 108,
          • "58": 111,
          • "59": 112,
          • "60": 101,
          • "61": 114,
          • "62": 49,
          • "63": 54,
          • "64": 121,
          • "65": 115,
          • "66": 48,
          • "67": 101,
          • "68": 103,
          • "69": 57,
          • "70": 51,
          • "71": 53,
          • "72": 109,
          • "73": 107,
          • "74": 113,
          • "75": 112,
          • "76": 107,
          • "77": 121,
          • "78": 100,
          • "79": 107,
          • "80": 103,
          • "81": 102,
          • "82": 99,
          • "83": 106,
          • "84": 57,
          • "85": 97,
          • "86": 103,
          • "87": 101,
          • "88": 50,
          • "89": 97,
          • "90": 117,
          • "91": 56,
          • "92": 108,
          • "93": 57,
          • "94": 54,
          • "95": 110,
          • "96": 97,
          • "97": 101,
          • "98": 114,
          • "99": 101,
          • "100": 57,
          • "101": 26,
          • "102": 16,
          • "103": 10,
          • "104": 5,
          • "105": 117,
          • "106": 97,
          • "107": 116,
          • "108": 111,
          • "109": 109,
          • "110": 18,
          • "111": 7,
          • "112": 49,
          • "113": 48,
          • "114": 48,
          • "115": 48,
          • "116": 48,
          • "117": 48,
          • "118": 48
          }
        }
      ],
    • "memo": "",
    • "timeoutHeight": {
      • "low": 0,
      • "high": 0,
      • "unsigned": true
      },
    • "extensionOptions": [ ],
    • "nonCriticalExtensionOptions": [ ]
    },
  • "signatures": [
    • {
      • "0": 116,
      • "1": 104,
      • "2": 101,
      • "3": 116,
      • "4": 97,
      • "5": 45,
      • "6": 116,
      • "7": 101,
      • "8": 115,
      • "9": 116,
      • "10": 110,
      • "11": 101,
      • "12": 116,
      • "13": 45,
      • "14": 48,
      • "15": 48,
      • "16": 49
      }
    ]
}

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

validators
Array of strings
Example: validators=6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78

Comma-separated list of validator 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

validators
Array of strings
Example: validators=6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78

Comma-separated list of validator 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

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

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

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

Get data 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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

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

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

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

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

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

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"
          ]
        }
      }
    }
}

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=030000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000061d1b66df290eb088227c3d92fb617046083673fb018071cae9c0f507b372fec0a5c45e0b43d46fb8a092f7fdcec2c52070497c1b1d681d17f33ee4324538a07deabe78a609fdf76d0f11d2006314cc98fa78f58e90c42d45bf3d36f24748b613eed28a1bb6142c79819b56f7e8fdac39fbb5af683de240d62837db99aa4a00a0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e15580b7b08f8a771c463905b0ece9f9fc642deef72b67f65954c920e801d602651f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff40000008cb7df03f52969a55bab8272195daca0b8619b10db0dffa05572f3ea636dfadd04040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "recentBlockhash": "AUJhGWuM8vPH4qv8uFH8G4WQeYZDbWDKK7mkqVtDVNyz",
  • "feePayer": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
  • "nonceInfo": null,
  • "instructions": [
    • {
      • "keys": [
        • {
          • "pubkey": "HoAGnvTdp4Qgrq3NWtNQFS6FixasBhLqui23Seq7riSw",
          • "isSigner": false,
          • "isWritable": true
          },
        • {
          • "pubkey": "SysvarRecentB1ockHashes11111111111111111111",
          • "isSigner": false,
          • "isWritable": false
          },
        • {
          • "pubkey": "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68",
          • "isSigner": true,
          • "isWritable": false
          }
        ],
      • "programId": "11111111111111111111111111111111",
      • "data": [
        • 4,
        • 0,
        • 0,
        • 0
        ]
      },
    • {
      • "keys": [
        • {
          • "pubkey": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
          • "isSigner": true,
          • "isWritable": true
          },
        • {
          • "pubkey": "2SKRt2UySaYNjfPqLERF2wHnxmzqzsaVDLrS3RmBbvnH",
          • "isSigner": true,
          • "isWritable": true
          }
        ],
      • "programId": "11111111111111111111111111111111",
      • "data": [
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 128,
        • 198,
        • 164,
        • 126,
        • 141,
        • 3,
        • 0,
        • 200,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 6,
        • 161,
        • 216,
        • 23,
        • 145,
        • 55,
        • 84,
        • 42,
        • 152,
        • 52,
        • 55,
        • 189,
        • 254,
        • 42,
        • 122,
        • 178,
        • 85,
        • 127,
        • 83,
        • 92,
        • 138,
        • 120,
        • 114,
        • 43,
        • 104,
        • 164,
        • 157,
        • 192,
        • 0,
        • 0,
        • 0,
        • 0
        ]
      },
    • {
      • "keys": [
        • {
          • "pubkey": "2SKRt2UySaYNjfPqLERF2wHnxmzqzsaVDLrS3RmBbvnH",
          • "isSigner": true,
          • "isWritable": true
          },
        • {
          • "pubkey": "SysvarRent111111111111111111111111111111111",
          • "isSigner": false,
          • "isWritable": false
          }
        ],
      • "programId": "Stake11111111111111111111111111111111111111",
      • "data": [
        • 0,
        • 0,
        • 0,
        • 0,
        • 55,
        • 60,
        • 111,
        • 142,
        • 132,
        • 198,
        • 130,
        • 42,
        • 159,
        • 135,
        • 3,
        • 95,
        • 101,
        • 204,
        • 207,
        • 137,
        • 158,
        • 239,
        • 63,
        • 205,
        • 238,
        • 97,
        • 7,
        • 112,
        • 65,
        • 169,
        • 62,
        • 24,
        • 5,
        • 186,
        • 178,
        • 78,
        • 55,
        • 60,
        • 111,
        • 142,
        • 132,
        • 198,
        • 130,
        • 42,
        • 159,
        • 135,
        • 3,
        • 95,
        • 101,
        • 204,
        • 207,
        • 137,
        • 158,
        • 239,
        • 63,
        • 205,
        • 238,
        • 97,
        • 7,
        • 112,
        • 65,
        • 169,
        • 62,
        • 24,
        • 5,
        • 186,
        • 178,
        • 78,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0,
        • 0
        ]
      },
    • {
      • "keys": [
        • {
          • "pubkey": "2SKRt2UySaYNjfPqLERF2wHnxmzqzsaVDLrS3RmBbvnH",
          • "isSigner": true,
          • "isWritable": true
          },
        • {
          • "pubkey": "5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm",
          • "isSigner": false,
          • "isWritable": false
          },
        • {
          • "pubkey": "SysvarC1ock11111111111111111111111111111111",
          • "isSigner": false,
          • "isWritable": false
          },
        • {
          • "pubkey": "SysvarStakeHistory1111111111111111111111111",
          • "isSigner": false,
          • "isWritable": false
          },
        • {
          • "pubkey": "StakeConfig11111111111111111111111111111111",
          • "isSigner": false,
          • "isWritable": false
          },
        • {
          • "pubkey": "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
          • "isSigner": true,
          • "isWritable": true
          }
        ],
      • "programId": "Stake11111111111111111111111111111111111111",
      • "data": [
        • 2,
        • 0,
        • 0,
        • 0
        ]
      }
    ],
  • "signers": [
    • "4icse2mPXNgyxxn11tVM7sTnSqDqwJSEzdnaCQnRzvA9",
    • "2SKRt2UySaYNjfPqLERF2wHnxmzqzsaVDLrS3RmBbvnH",
    • "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68"
    ]
}

TIA

Staking facilities for the Celestia protocol

Stakes

Get the status of TIA stakes. Units are in uTIA (10⁻⁶ TIA).

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

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=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "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",
      • "permissions": [
        • {
          • "source": "granter",
          • "creation_height": 15000000,
          • "permission": "Staking.MsgDelegate",
          • "expires_at": "2023-01-10T01:12:34Z",
          • "allow_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]",
          • "deny_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]"
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes

Link an CELESTIA 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": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu}_cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl"
      }
    ],
  • "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 CELESTIA stakes. Units are in uTIA (10⁻⁶ TIA).

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

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=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

Operations

Get the operations of TIA stakes. Units are in uTIA (10⁻⁶ TIA).

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

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=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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.

authz
boolean
Default: false

whether or not the operation returned will include authz operations, defaults to false

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 data from this date (YYYY-MM-DD)

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

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

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": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "delegator_address": "celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
      • "amount": "3000000",
      • "withdraw_rewards": "10841"
      }
    ]
}

Network Stats

Get some network statistics on Celestia

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,
    • "celestia_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=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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=celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu

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 Celestia

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 public key (compressed or uncompressed), this is different than the wallet address

validator
required
string

Validator address

amount_utia
required
string

Amount to stake in uTIA

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "0adf010adc010a2a2f636f736d6f732e7374616b696e672e763162657461312e4d7367426567696e526564656c656761746512ad010a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f70657231307636777664656e65653872396c36776c73706863677572326c746c387a746b6672766a39611a34636f736d6f7376616c6f70657231796d7a336b6a7466397a6b666d6d3273326c7279376568307a6439657a33766335797030306622100a057561746f6d12073433313030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186d12130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a",
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "fee": {
      • "amount": [
        • {
          • "denom": "utia",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
          • "validatorAddress": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
          • "amount": {
            • "denom": "utia",
            • "amount": "1000000"
            }
          }
        },
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.StakeAuthorization",
        • "allowList": {
          • "address": [
            • "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
            ]
          },
        • "AuthorizationType": 1
        }
      ]
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Celestia

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

Transaction to craft

pubkey
required
string

Wallet public key (compressed or uncompressed), 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": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
}

Response samples

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

Restake Rewards Transaction

Generates a restake rewards transaction on Celestia

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

Transaction to craft

pubkey
required
string

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

validator_address
required
string

Validator address

Responses

Request samples

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

Response samples

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

Unstake Transaction

Generates an undelegate transaction on Celestia

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

amount_utia
string

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

Responses

Request samples

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

Response samples

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

Redelegate Transaction

Generates a redelegate transaction on Celestia to move a stake from a validator to another without going through the 30 days unbonding period.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to which the new stake will be linked

pubkey
required
string

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

validator_source
required
string

Validator source address of current stake

validator_destination
required
string

Validator destination address to which redelegate the stake

amount_utia
string

Amount to redelegate in uTIA

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "0adf010adc010a2a2f636f736d6f732e7374616b696e672e763162657461312e4d7367426567696e526564656c656761746512ad010a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f70657231307636777664656e65653872396c36776c73706863677572326c746c387a746b6672766a39611a34636f736d6f7376616c6f70657231796d7a336b6a7466397a6b666d6d3273326c7279376568307a6439657a33766335797030306622100a057561746f6d12073433313030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186d12130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a",
    • "unsigned_tx_hash": "b6ce1c8185416ce7d42a8c39566a9a2b6b2361a55c04a1dba3dd7445a0e1e364",
    • "tx_body": "0a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d120731303030303030",
    • "tx_auth_info": "0a2c0a2a0a28636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a716561746576120a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e6165726539",
    • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
    • "message": {
      • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
      • "value": {
        • "delegatorAddress": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev",
        • "validatorAddress": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "utia",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "utia",
          • "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 public key (compressed or uncompressed), 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 Celestia 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": "5000utia"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "amount",
              • "value": "5000utia"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta"
              },
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5000utia"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              }
            ]
          },
        • {
          • "type": "tx",
          • "attributes": [
            • {
              • "key": "fee",
              • "value": "5000utia"
              },
            • {
              • "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": "5utia"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "5utia"
              }
            ]
          },
        • {
          • "type": "transfer",
          • "attributes": [
            • {
              • "key": "recipient",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              },
            • {
              • "key": "amount",
              • "value": "5utia"
              }
            ]
          },
        • {
          • "type": "message",
          • "attributes": [
            • {
              • "key": "sender",
              • "value": "cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl"
              }
            ]
          },
        • {
          • "type": "withdraw_rewards",
          • "attributes": [
            • {
              • "key": "amount",
              • "value": "5utia"
              },
            • {
              • "key": "validator",
              • "value": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
              }
            ]
          },
        • {
          • "type": "coin_spent",
          • "attributes": [
            • {
              • "key": "spender",
              • "value": "cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev"
              },
            • {
              • "key": "amount",
              • "value": "100000utia"
              }
            ]
          },
        • {
          • "type": "coin_received",
          • "attributes": [
            • {
              • "key": "receiver",
              • "value": "cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh"
              },
            • {
              • "key": "amount",
              • "value": "100000utia"
              }
            ]
          },
        • {
          • "type": "delegate",
          • "attributes": [
            • {
              • "key": "validator",
              • "value": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
              },
            • {
              • "key": "amount",
              • "value": "100000utia"
              },
            • {
              • "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\":\"5utia\"},{\"key\":\"receiver\",\"value\":\"cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh\"},{\"key\":\"amount\",\"value\":\"100000utia\"}]},{\"type\":\"coin_spent\",\"attributes\":[{\"key\":\"spender\",\"value\":\"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl\"},{\"key\":\"amount\",\"value\":\"5utia\"},{\"key\":\"spender\",\"value\":\"cosmos19c9fdh488vqjclltwp68jm50ydwyh36jqeatev\"},{\"key\":\"amount\",\"value\":\"100000utia\"}]},{\"type\":\"delegate\",\"attributes\":[{\"key\":\"validator\",\"value\":\"celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu\"},{\"key\":\"amount\",\"value\":\"100000utia\"},{\"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\":\"5utia\"}]},{\"type\":\"withdraw_rewards\",\"attributes\":[{\"key\":\"amount\",\"value\":\"5utia\"},{\"key\":\"validator\",\"value\":\"celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu\"}]}]}]",
      • "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
      }
    }
}

Transaction Decoding

Decode a transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=0aa1010a9e010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512770a2d636f736d6f733139633966646834383876716a636c6c74777036386a6d3530796477796833366a7165617465761234636f736d6f7376616c6f706572313679733065673933356d6b71706b79646b6766636a39616765326175386c39366e61657265391a100a057561746f6d12073130303030303012670a500a460a1f2f636f736d6f732e63727970746f2e736563703235366b312e5075624b657912230a21039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f4612040a020801186612130a0d0a057561746f6d1204353030301080897a1a1174686574612d746573746e65742d30303120e0cd2a

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "utia",
            • "amount": "5000"
            }
          ],
        • "gasLimit": {
          • "low": 2000000,
          • "high": 0,
          • "unsigned": true
          },
        • "payer": "",
        • "granter": ""
        }
      },
    • "body": {
      • "messages": [
        • {
          • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
          • "value": {
            • "0": 10,
            • "1": 45,
            • "2": 99,
            • "3": 111,
            • "4": 115,
            • "5": 109,
            • "6": 111,
            • "7": 115,
            • "8": 49,
            • "9": 57,
            • "10": 99,
            • "11": 57,
            • "12": 102,
            • "13": 100,
            • "14": 104,
            • "15": 52,
            • "16": 56,
            • "17": 56,
            • "18": 118,
            • "19": 113,
            • "20": 106,
            • "21": 99,
            • "22": 108,
            • "23": 108,
            • "24": 116,
            • "25": 119,
            • "26": 112,
            • "27": 54,
            • "28": 56,
            • "29": 106,
            • "30": 109,
            • "31": 53,
            • "32": 48,
            • "33": 121,
            • "34": 100,
            • "35": 119,
            • "36": 121,
            • "37": 104,
            • "38": 51,
            • "39": 54,
            • "40": 106,
            • "41": 113,
            • "42": 101,
            • "43": 97,
            • "44": 116,
            • "45": 101,
            • "46": 118,
            • "47": 18,
            • "48": 52,
            • "49": 99,
            • "50": 111,
            • "51": 115,
            • "52": 109,
            • "53": 111,
            • "54": 115,
            • "55": 118,
            • "56": 97,
            • "57": 108,
            • "58": 111,
            • "59": 112,
            • "60": 101,
            • "61": 114,
            • "62": 49,
            • "63": 54,
            • "64": 121,
            • "65": 115,
            • "66": 48,
            • "67": 101,
            • "68": 103,
            • "69": 57,
            • "70": 51,
            • "71": 53,
            • "72": 109,
            • "73": 107,
            • "74": 113,
            • "75": 112,
            • "76": 107,
            • "77": 121,
            • "78": 100,
            • "79": 107,
            • "80": 103,
            • "81": 102,
            • "82": 99,
            • "83": 106,
            • "84": 57,
            • "85": 97,
            • "86": 103,
            • "87": 101,
            • "88": 50,
            • "89": 97,
            • "90": 117,
            • "91": 56,
            • "92": 108,
            • "93": 57,
            • "94": 54,
            • "95": 110,
            • "96": 97,
            • "97": 101,
            • "98": 114,
            • "99": 101,
            • "100": 57,
            • "101": 26,
            • "102": 16,
            • "103": 10,
            • "104": 5,
            • "105": 117,
            • "106": 97,
            • "107": 116,
            • "108": 111,
            • "109": 109,
            • "110": 18,
            • "111": 7,
            • "112": 49,
            • "113": 48,
            • "114": 48,
            • "115": 48,
            • "116": 48,
            • "117": 48,
            • "118": 48
            }
          }
        ],
      • "memo": "",
      • "timeoutHeight": {
        • "low": 0,
        • "high": 0,
        • "unsigned": true
        },
      • "extensionOptions": [ ],
      • "nonCriticalExtensionOptions": [ ]
      },
    • "signatures": [
      • {
        • "0": 116,
        • "1": 104,
        • "2": 101,
        • "3": 116,
        • "4": 97,
        • "5": 45,
        • "6": 116,
        • "7": 101,
        • "8": 115,
        • "9": 116,
        • "10": 110,
        • "11": 101,
        • "12": 116,
        • "13": 45,
        • "14": 48,
        • "15": 48,
        • "16": 49
        }
      ]
    }
}

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

validators
Array of strings
Example: validators=tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez

Comma-separated list of baker addresses

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

validators
Array of strings
Example: validators=tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez

Comma-separated list of baker addresses

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 data from this date (YYYY-MM-DD)

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

Get data 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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

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

validators
Array of strings
Example: validators=tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez

Comma-separated list of baker addresses

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

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

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

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

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"
      }
    }
}

Transaction Decoding

Decode a Tezos transaction

Authorizations:
bearerAuth
query Parameters
tx_serialized
required
string
Example: tx_serialized=a67058acc52080bb8ab4f4d0c3e08bab1484a6799c216d43fdff0a8aa445e7146e00566eaa0198f3df9230489abd1a64f5ef9b98b270940ac4cb9807f44e00ff00344c5e59a1de5370e1cee5d2fcf706a649bba15b

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "branch": "BLyanvyskrD6KrZaxh7TNp9EfUaHUUnqRRKMFirvrfmu2qcQkB4",
  • "contents": [
    • {
      • "kind": "delegation",
      • "source": "tz1TX3Nh6h6js1VxXCuQ7rAF7LoGpd81FSw3",
      • "fee": "1300",
      • "counter": "15082948",
      • "gas_limit": "10100",
      • "storage_limit": "0",
      • "delegate": "tz1QQZKGt3ouyd7x8JUDwcvRyxzsmD7CFbMd"
      }
    ]
}

ZETA

Staking facilities for the Zetachain protocol

Stakes

Get the status of ZETA stakes. Units are in uZETA (10⁻⁶ ZETA).

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

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=zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460

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": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
      • "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",
      • "permissions": [
        • {
          • "source": "granter",
          • "creation_height": 15000000,
          • "permission": "Staking.MsgDelegate",
          • "expires_at": "2023-01-10T01:12:34Z",
          • "allow_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]",
          • "deny_list": "[\"cosmosvaloper1xyz\", \"cosmosvaloper1abc\"]"
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes

Link a ZETACHAIN 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": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe}_cosmos1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl"
      }
    ],
  • "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 ZETA stakes. Units are in uZETA (10⁻⁶ ZETA).

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

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=zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460

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 data from this date (YYYY-MM-DD)

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

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

include_usd
boolean
Example: include_usd=1

Include rewards and balance in USD in response.
If a format parameter exists it will only work with format=daily

Responses

Response samples

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

Operations

Get the operations of ZETACHAIN stakes. Units are in uZETA (10⁻⁶ ZETA).

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 data from this date (YYYY-MM-DD)

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

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

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": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
      • "delegator_address": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
      • "amount": "3000000",
      • "withdraw_rewards": "10841"
      }
    ]
}

Network Stats

Get some network statistics on Zetachain

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,
    • "zetachain_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=zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460

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=zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe

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