This API is a preview version and not intended for production use. It may undergo changes and not be fully stable. Please refer to the latest stable version for production use.

Kiln API (Preview)

Download OpenAPI specification:Download

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

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

Preview (experimental & candidate changes for Kiln API 1.4.0) [link]
  • EGLD: Add new routes for fetching stakes and rewards
    • GET /v1/egld/stakes
    • GET /v1/egld/rewards
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
  • 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

current_page
integer >= 1
Example: current_page=1

Current page to look-up entries. Defaults to 1. If the number of entries returned is lesser than page_size, it means it's the last page and there are no more entries.

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

Number of entries to list per page. Defaults to 100. specified

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,
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

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": [
    • {
      • "date": "2023-01-15",
      • "rewards": "27098488",
      • "active_balance": "420000000000",
      • "net_apy": 3.42,
      • "rewards_usd": "12",
      • "stake_balance_usd": "2546"
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "27099488",
      • "active_balance": "420027098488",
      • "net_apy": 3.4,
      • "rewards_usd": "12",
      • "stake_balance_usd": "2546"
      }
    ]
}

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",
      • "active_balance": "6300000000000000000000000",
      • "net_apy": 3.42,
      • "rewards_usd": "12",
      • "stake_balance_usd": "25400"
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "3575891083876864200000",
      • "active_balance": "6300000000000000000000000",
      • "net_apy": 3.4,
      • "rewards_usd": "13",
      • "stake_balance_usd": "25412"
      }
    ]
}

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.

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

DEFI

Facilities for the DeFi protocols

Stakes

Get stakes of wallets on the given vaults

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

Comma-separated list of wallet addresses

vaults
Array of strings
Example: vaults=eth_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5

Comma-separated list of vault addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "current_balance": "1880000",
      • "asset": "0x94a9d9ac8a22534e3faca9f4e7f2e2cf85d5e4c8",
      • "asset_symbol": "skUSDC",
      • "total_rewards": "0",
      • "total_deposited_amount": "1980000",
      • "total_withdrawn_amount": "100000",
      • "vault": "0x9aB5F9101a3C1B868e2c422E294cc2ee685551D5",
      • "chain": "eth"
      }
    ]
}

Operations

Get operations of wallets on the given vaults

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

Comma-separated list of wallet addresses

vaults
Array of strings
Example: vaults=eth_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5

Comma-separated list of vault addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "withdrawal",
      • "assets": "100000",
      • "shares": "100000",
      • "sender": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
      • "timestamp": "1710434028",
      • "tx_hash": "0xca1e9f9a9ed7b632dbb71e9d22730d1541df010e915d65af91d1ca102600c965",
      • "vault": "0x9aB5F9101a3C1B868e2c422E294cc2ee685551D5",
      • "chain": "eth"
      }
    ]
}

Network Stats

Get network stats of the given vaults

Authorizations:
bearerAuth
query Parameters
vaults
Array of strings
Example: vaults=eth_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5

Comma-separated list of vault addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "asset": "0x94a9d9ac8a22534e3faca9f4e7f2e2cf85d5e4c8",
      • "asset_symbol": "skUSDC",
      • "protocol_grr": 0.028795338310400043,
      • "protocol_nrr": 0.028507384927296042,
      • "vault": "0x9aB5F9101a3C1B868e2c422E294cc2ee685551D5",
      • "chain": "eth"
      }
    ]
}

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
<