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.

logo
API docs by Redocly

Kiln API (Preview)

Download OpenAPI specification:

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

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

ACCESS

In order to use the Kiln API, you must first get an API token from your Kiln dashboard (applications section). If you don't have access to our dashboard, please get in touch at hello@kiln.fi.

Once you have your API token, you can set it as a bearer token in your HTTP request headers, and target the Kiln API endpoint with the current MAJOR version of the API as a prefix to routes:

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

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 Stakes

Add stakes to an account

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

Stakes to add

stake_ids
required
Array of strings

List of stake ids to add

protocol
required
string
Enum: "NEAR" "ETH" "ATOM" "POL" "ADA" "OSMO" "XTZ" "DOT" "KSM" "SOL" "DYDX" "TIA" "EGLD" "ZETA" "INJ" "FET" "TON" "KAVA" "BBN" "CRO" "OM" "SUI" "TRX"

Protocol name

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "stake_ids": [
    • "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e"
    ],
  • "protocol": "ETH"
}

Response samples

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

Account Portfolio

Retrieve an account asset portfolio. USD balances are calculated based on recent asset prices. We use CoinGecko API to retrieve asset prices. The data is cached for 24h but it is possible to get real time data by using the refresh parameter.

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

Account id

query Parameters
refresh
boolean
Example: refresh=1

Set to 1 for real-time data

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": "NEAR",
        • "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
        }
      ],
    • "error": "We could not fetch data for the following protocols: TON",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Account Report

Get report of the account's stakes.

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

Account id

Responses

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. The data is cached for 24h but it is possible to get real time data by using the refresh parameter.

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

Organization id

query Parameters
refresh
boolean
Example: refresh=1

Set to 1 for real-time data

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": "NEAR",
        • "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
        }
      ],
    • "error": "We could not fetch data for the following protocols: TON",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Organization Report

Get report of the organization's stakes.

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

Organization id

Responses

Babylon (BBN)

Staking facilities for the Babylon protocol

Stakes

BBN

Authorizations:
bearerAuth
query Parameters
wallets
string
Example: wallets=bc1q6gd2c5te296j3uh3tpmfppk9p65scu7m53kx93

Comma separated list of wallet addresses

tx_ids
string
Example: tx_ids=fc5e606725329c590945ac585f5907d911012a424879cabe46993fc7cc0b7117

Comma separated list of transaction ids

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": [
    • {
      • "status": "status",
      • "staking_tx": "2e2127d3697df687b73367c1877fbb3e336d85d5068b822ba9c78a020b00bd88",
      • "staker": "bc1q6gd2c5te296j3uh3tpmfppk9p65scu7m53kx93",
      • "amount": 50000,
      • "finality_provider": "053107172a3d5a2715754cd5793efdcf5e54364b855ed2305819e372aa685d76",
      • "lock_time": 150,
      • "activated_at": "2024-12-05T15:36:36+00:00",
      • "points": 15
      }
    ]
}

Create stakes Deprecated

Link BBN 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": [
    • {
      • "tx_id": "2e2127d3697df687b73367c1877fbb3e336d85d5068b822ba9c78a020b00bd88"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Stake Transaction

Craft a staking transaction to stake your bitcoin

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

public_key
required
string

Wallet public key in compressed 33 bytes format

amount_satoshi
required
integer

Amount of BTC to lock up in satoshi unit

time_lock
required
integer

Amount of blocks your BTC will remain locked

fee_rate
required
integer

Fee rate for the transaction, in satoshi per byte

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "public_key": "03bb37a6d29e7fc8eb6726243c08a0f85d431602ddcd669bf33c74ec85ee8f42b6",
  • "amount_satoshi": 100000,
  • "time_lock": 150,
  • "fee_rate": 10
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "70736274ff0100cf02000000016b5253d7d86352e1d3f1eba7a1ebf6216477e4a945d1b879833eb10a3a60653e0200000000fdffffff0350c3000000000000225120b712455a29769599d30a5b589cfea040ca2a5f3b22c403d26667664a442cedfd0000000000000000496a476262623400bb37a6d29e7fc8eb6726243c08a0f85d431602ddcd669bf33c74ec85ee8f42b6053107172a3d5a2715754cd5793efdcf5e54364b855ed2305819e372aa685d7600964aca090000000000160014d21aac5179517528f2f158769086c50ea90c73db000000000001011f5b940a0000000000160014d21aac5179517528f2f158769086c50ea90c73db00000000"
    }
}

Broadcast Transaction

Broadcast a signed transaction to the Babylon network

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

Transaction to broadcast

account_id
string

Kiln Account ID

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
  • "tx_serialized": "0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063b2b5ef76d483b695bc3b954d9a372ca5f744e00279c8578bc4268d570b701a037fac575ae16bb3ba5702b8d5bd9930953453e2d628368f83a11ab5896d20bbcae0b4a119860afd99da20f3462ba15d8bd1528d73724b83e8cc4cee00787df28a181783c264113ef1870bae5a90987fc5cfcdffaddf23c7dcfd7585c13d10b0301080c373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e1bb5f70b4d3ae65feb6d20587f62ccc8d5e720e99abe3d4415972bbf74a8a88a51f5f3871e65b84cc393458d0f23a413184cf2bb7093ae4e2c99d55b39a575c5f98e3135fcb53e71e6fafcb4da3a3cc36af1c76a1a7e72aa12eae1346d724c6c00000000000000000000000000000000000000000000000000000000000000004792650d1e9a4fe99721617c7d47c8712c14c20a76bf043368c6528c9090531a06a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc00000000006a1d817a502050b680791e6ce6db88e1e5b7150f61fc6790a4eb4d10000000006a7d51718c774c928566398691d5eb68b5eb8a39b4b6d5c73555b210000000006a7d517192c568ee08a845f73d29788cf035c3145b21ab344d8062ea940000006a7d517192c5c51218cc94c3d4af17f58daee089ba1fd44e3dbd98a0000000006a7d517193584d0feed9bb3431d13206be544281b57b8566cc5375ff4000000f0973e76495f3ffc65798a529de5cba4ec7f47f17669c9fa256923f099a1cda304040303090204040000000402000134000000000080c6a47e8d0300c80000000000000006a1d8179137542a983437bdfe2a7ab2557f535c8a78722b68a49dc0000000000602010a7400000000373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e373c6f8e84c6822a9f87035f65cccf899eef3fcdee61077041a93e1805bab24e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006060105080b07000402000000"
}

Response samples

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

Cardano (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",
      • "active_pool_saturation": "0.8",
      • "live_pool_saturation": "0.82",
      • "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 Deprecated

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",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "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
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"
      }
    ]
}

Operations

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

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": "stake_registration",
      • "time": "2021-01-03T21:49:34Z",
      • "stake_address": "stake1u84uqy85qpsln9a49dtv7mrzzp0246v7s2cj7ypjr555ldqenardf",
      • "epoch": 239,
      • "block": 5162844,
      • "tx_hash": "052306cc8ded7adee92ccd9e10e31c8352f568408eb1868cf3ca751d67695dc8"
      }
    ]
}

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
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": {
    • "ada_price_usd": 0.29,
    • "nb_validators": 3068,
    • "network_gross_apy": 3.3,
    • "supply_staked_percent": 62.24,
    • "inflation_rate": 0.3,
    • "updated_at": "2023-08-09T11:41:36Z"
    }
}

Stake Transaction

Generates a delegate transaction on Cardano. Your wallet must have at least 4 ADA to cover for fees and pool deposit (2 ADA).

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

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": "d8e3965567ecbc3941d76f13801bd10e6f7ef2cca304c1c45740441947d2289b",
        • "index": 0
        }
      ],
    • "outputs": [
      • {
        • "address": "addr1qxrsnuxvjyux7vmlhwdahc8su2w4fzq4rclyvsg54jnhyc3tul7ymdsqmtg4f7e5c2yncawtwdn3t4jxhmlsam7xf36sd072dp",
        • "amount": {
          • "coin": "192843555",
          • "multiasset": null
          },
        • "plutus_data": null,
        • "script_ref": null
        }
      ],
    • "fee": "300000",
    • "ttl": "150142761",
    • "certs": [
      • {
        • "StakeAndVoteDelegation": {
          • "stake_credential": {
            • "Key": "2be7fc4db600dad154fb34c2893c75cb736715d646beff0eefc64c75"
            },
          • "pool_keyhash": "7b75bdba3b996dc88fdc00099d794d1460cf6bf7a5997a0da1197f4e",
          • "drep": "AlwaysAbstain"
          }
        }
      ],
    • "withdrawals": null,
    • "update": null,
    • "auxiliary_data_hash": null,
    • "validity_start_interval": null,
    • "mint": null,
    • "script_data_hash": null,
    • "collateral": null,
    • "required_signers": null,
    • "network_id": null,
    • "collateral_return": null,
    • "total_collateral": null,
    • "reference_inputs": null,
    • "voting_procedures": null,
    • "voting_proposals": null,
    • "donation": null,
    • "current_treasury_value": null
    },
  • "witness_set": {
    • "vkeys": null,
    • "native_scripts": null,
    • "bootstraps": null,
    • "plutus_scripts": null,
    • "plutus_data": null,
    • "redeemers": null
    },
  • "is_valid": true,
  • "auxiliary_data": null
}

Celestia (TIA)

Staking facilities for the Celestia protocol

Stakes

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

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

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

delegators
Array of strings
Example: delegators=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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

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

Comma-separated list of Kiln accounts identifiers

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "delegator_address": "celestia1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "celestiavaloper1xyz",
            • "celestiavaloper1abc"
            ],
          • "deny_list": [
            • "celestiavaloper1xyz",
            • "celestiavaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link an CELESTIA stake to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of CELESTIA stakes. Units are in uTIA (10⁻⁶ TIA).

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

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

delegators
Array of strings
Example: delegators=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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 TIA stakes. Units are in uTIA (10⁻⁶ TIA).

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

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

delegators
Array of strings
Example: delegators=celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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

authz
boolean
Default: false

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

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

Responses

Response samples

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

Network Stats

Get some network statistics on Celestia

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Cosmos staking

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

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

validators
Array of strings
Example: validators=celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu

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

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

Comma-separated list of Kiln accounts identifiers

Responses

Stake Transaction

Generates a delegate transaction on Celestia

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

pubkey
required
string

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

validator
required
string

Validator address

amount_utia
required
string

Amount to stake in utia

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

grantee_address
string

Responses

Request samples

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

Response samples

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

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Celestia

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

Responses

Request samples

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

Response samples

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

Restake Rewards Transaction

Generates a restake rewards transaction on Celestia

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

Transaction to craft

pubkey
required
string

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

validator_address
required
string

Validator address

grantee_address
required
string

Responses

Request samples

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

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": "celestia1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "celestiavaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "utia",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "utia",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Celestia

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

amount_utia
string

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

Responses

Request samples

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

Response samples

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

Redelegate Transaction

Generates a redelegate transaction on Celestia 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_utia
string

Amount to redelegate in uTIA

Responses

Request samples

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

Response samples

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

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

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

Transaction to prepare

pubkey
required
string

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

tx_body
required
string

Transaction body serialized in hex

tx_auth_info
required
string

Transaction auth info serialized in hex

signature
required
string

Transaction signature serialized in hex

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcast a signed transaction to the Celestia network

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

Transaction to broadcast

tx_serialized
required
string

Signed transaction serialized in hex

Responses

Request samples

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

Response samples

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

Transaction Status

Get the status of a transaction

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

Hash of the transaction

Responses

Response samples

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Cosmos (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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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 Deprecated

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",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

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": {
    • "atom_price_usd": 10.53,
    • "nb_validators": 100,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "inflation_rate": 3.5,
    • "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

grantee_address
string

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

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
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

grantee_address
required
string

Responses

Request samples

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

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"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Cronos (CRO)

Staking facilities for the Cronos protocol

Stakes

Retrieve the status of Cronos stakes, expressed in microCRO (10⁻⁶ CRO).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
      • "delegator_address": "cro1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "crovaloper1xyz",
            • "crovaloper1abc"
            ],
          • "deny_list": [
            • "crovaloper1xyz",
            • "crovaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link an Cronos 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": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry_cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h}"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of Cronos stakes. Units are in microCRO (10⁻⁶ CRO).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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 Cronos stakes. Units are in microCRO (10⁻⁶ CRO).

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

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

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": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
      • "delegator_address": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
      • "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": {
    • "cro_price_usd": 10.53,
    • "nb_validators": 100,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "inflation_rate": 3.5,
    • "updated_at": "2023-01-14T01:13:59Z"
    }
}

Reports

Get reports on Cosmos staking

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

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

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

Get balance

Get balance of a Cronos account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "cro1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
  • "denom": "basecro"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "basecro"
    }
}

Stake Transaction

Generates a delegate transaction on Cronos

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_basecro
required
string

Amount to stake in basecro

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

grantee_address
string

Responses

Request samples

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

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": "basecro",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
          • "validatorAddress": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
          • "amount": {
            • "denom": "basecro",
            • "amount": "1000000"
            }
          }
        },
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.StakeAuthorization",
        • "allowList": {
          • "address": [
            • "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry"
            ]
          },
        • "AuthorizationType": 1
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Cronos

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

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": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
        • "validatorAddress": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
        • "amount": {
          • "denom": "basecro",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "basecro",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Restake Rewards Transaction

Generates a restake rewards transaction on Cronos

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

grantee_address
required
string

Responses

Request samples

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

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": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
        • "validatorAddress": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
        • "amount": {
          • "denom": "basecro",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "basecro",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Cronos

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_basecro
string

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

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
  • "amount_basecro": "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": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
        • "validatorAddress": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
        • "amount": {
          • "denom": "basecro",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "basecro",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Redelegate Transaction

Generates a redelegate transaction on Cronos 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_basecro
string

Amount to redelegate in basecro

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator_source": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
  • "validator_destination": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
  • "amount_basecro": "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": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
        • "validatorAddress": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
        • "amount": {
          • "denom": "basecro",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "basecro",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Send Transaction

Generates a send transaction on Cronos

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

to
required
string

Recipient address

amount_basecro
required
string

Amount to send in basecro

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "to": "cro1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
  • "amount_basecro": "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": "cro1egww25see7x6pg2lp2mhmnd5s6smzlfmdlwm0h",
        • "validatorAddress": "crocncl10skwvezaqkngyw9uyskzsqe2cu8jc2ysrrndry",
        • "amount": {
          • "denom": "basecro",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "basecro",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "basecro",
            • "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 prefixed by chain identifier: eth, arb, bsc, matic, op

vault_ids
Array of strings
Example: vault_ids=1_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5

Comma-separated list of vault ids

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "vault_id": "1_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5",
      • "owner": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
      • "current_balance": "1880000",
      • "shares_balance": "1980000",
      • "total_rewards": "100000",
      • "current_rewards": "100000",
      • "total_deposited_amount": "1980000",
      • "total_withdrawn_amount": "100000",
      • "vault": "0x9aB5F9101a3C1B868e2c422E294cc2ee685551D5",
      • "chain": "eth",
      • "chain_id": 1,
      • "updated_at_block": 220379047
      }
    ]
}

Morpho extra rewards

Get Morpho extra rewards

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

Comma-separated list of wallet addresses

chain_ids
required
Array of strings
Example: chain_ids=1,8453

Comma-separated list of chain ids

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "wallet": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
      • "asset": "0x58D97B57BB95320F9a05dC918Aef65434969c2B2",
      • "asset_symbol": "MORPHO",
      • "asset_decimals": 18,
      • "total": "100123",
      • "claimable": "1231343",
      • "claimable_next": "345453",
      • "chain": "eth",
      • "chain_id": 1
      }
    ]
}

Craft claim Morpho rewards

Craft claim Morpho rewards transaction

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

Comma-separated list of wallet addresses

chain_ids
required
Array of strings
Example: chain_ids=1,8453

Comma-separated list of chain ids

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "wallet": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
      • "asset": "0x58D97B57BB95320F9a05dC918Aef65434969c2B2",
      • "to": "string",
      • "data": "string",
      • "value": "0",
      • "chain_id": "1"
      }
    ]
}

Approve Transaction

Generates an approval transaction that allows a specified vault to deposit a given ERC20 asset on behalf of the user. This is a prerequisite for interacting with Kiln DeFi Vaults as they require asset allowances before deposits.

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

Payload containing the necessary parameters to craft the approval transaction.

wallet
required
string

The Ethereum address of the user initiating the approval.

asset
required
string

The contract address of the ERC20 token being approved for deposit. For Kiln DeFi It will be the asset address you will get from the /network-stats route for the vault you want to deposit into.

chain_id
required
integer

The unique identifier of the blockchain network where the transaction is executed (e.g., 1 for Ethereum Mainnet).

vault
required
string

The contract address of the vault that will receive the asset deposit authorization.

amount
required
string

Amount to approve in the lowest unit of the asset (ie amount * 10**asset_decimals)

skip_gas_estimation
boolean
Default: false

If true, bypasses existing approval checks and proceeds with creating a new approval transaction regardless of current allowance.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0x991c468AbcE2b4DD627a6210C145373EbABdd186",
  • "asset": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
  • "chain_id": 1,
  • "vault": "0x6e90b52a5eab4e4a08135dcf8c93abdf6cae9c91",
  • "amount": "10000000000000000",
  • "skip_gas_estimation": false
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "wallet": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
    • "to": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
    • "data": "0xca0bfcce0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000002600000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000309696c02ec4dbb99f714e26ff1acdf6b258d36dcbad7b8b549553bc99b94ea639cd247f31683564995afd48568c1b6edd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060a3869da2ed5cc558f016d59fc5ceb0cac28e58743836aa3cf146221f1ef0b959e3cc5c589e05e171f1473596aadf36411767ad92edaae421ba0291bd7568267b3faabc3ab6ed9ddfc048ea6640370977f16f4f626a0e567a11ba25acdc520bb000000000000000000000000000000000000000000000000000000000000000012dd65914dda46639df6344701de54ac3ebe34a4b230262d3017fcd6c29954452",
    • "value": "0",
    • "nonce": 1,
    • "gas_limit": 140244,
    • "chain_id": 1
    }
}

Deposit Transaction

Generates a deposit transaction that allows a specified vault to receive a given ERC20 asset from the user.

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

Payload containing the necessary parameters to craft the deposit transaction.

wallet
required
string

The Ethereum address of the user initiating the deposit.

asset
required
string

The contract address of the ERC20 token being deposited. For Kiln DeFi, it will be the asset address you will get from the /network-stats route for the vault you want to deposit into.

chain_id
required
integer

The unique identifier of the blockchain network where the transaction is executed (e.g., 1 for Ethereum Mainnet).

vault
required
string

The contract address of the vault that you will deposit into.

amount
required
string

Amount to deposit into the vault in the lowest unit of the asset (ie amount * 10**asset_decimals).

skip_gas_estimation
boolean
Default: false

If true, bypasses existing deposit checks and proceeds with creating a new deposit transaction regardless of current balance.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0x991c468AbcE2b4DD627a6210C145373EbABdd186",
  • "asset": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
  • "chain_id": 1,
  • "vault": "0x6e90b52a5eab4e4a08135dcf8c93abdf6cae9c91",
  • "amount": "10000000000000000",
  • "skip_gas_estimation": false
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "wallet": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
    • "to": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
    • "data": "0xca0bfcce0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000002600000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000309696c02ec4dbb99f714e26ff1acdf6b258d36dcbad7b8b549553bc99b94ea639cd247f31683564995afd48568c1b6edd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060a3869da2ed5cc558f016d59fc5ceb0cac28e58743836aa3cf146221f1ef0b959e3cc5c589e05e171f1473596aadf36411767ad92edaae421ba0291bd7568267b3faabc3ab6ed9ddfc048ea6640370977f16f4f626a0e567a11ba25acdc520bb000000000000000000000000000000000000000000000000000000000000000012dd65914dda46639df6344701de54ac3ebe34a4b230262d3017fcd6c29954452",
    • "value": "0",
    • "nonce": 1,
    • "gas_limit": 140244,
    • "chain_id": 1
    }
}

Withdraw Transaction

Generates a withdrawal transaction that allows a user to withdraw a specified ERC20 asset from a given vault.

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

Payload containing the necessary parameters to craft the withdrawal transaction.

wallet
required
string

The Ethereum address of the user initiating the withdrawal.

chain_id
required
integer

The unique identifier of the blockchain network where the transaction is executed (e.g., 1 for Ethereum Mainnet).

vault
required
string

The contract address of the vault that you will withdraw from.

amount
required
string

Amount to withdraw from the vault in the lowest unit of the asset (ie amount * 10**asset_decimals). If you want to withdraw the maximum amount, you can use the string "max".

skip_gas_estimation
boolean
Default: false

If true, bypasses existing withdrawal checks and creates a new withdrawal transaction regardless of the current balance in the vault.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0x991c468AbcE2b4DD627a6210C145373EbABdd186",
  • "chain_id": 1,
  • "vault": "0x6e90b52a5eab4e4a08135dcf8c93abdf6cae9c91",
  • "amount": [
    • "10000000000000000",
    • "max"
    ],
  • "skip_gas_estimation": false
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "wallet": "0x356c33675674691ad6b8ac92ecfb91960c5d2c30",
    • "to": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
    • "data": "0xca0bfcce0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000002600000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000309696c02ec4dbb99f714e26ff1acdf6b258d36dcbad7b8b549553bc99b94ea639cd247f31683564995afd48568c1b6edd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000bc86717bad3f8ccf86d2882a6bc351c94580a994000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060a3869da2ed5cc558f016d59fc5ceb0cac28e58743836aa3cf146221f1ef0b959e3cc5c589e05e171f1473596aadf36411767ad92edaae421ba0291bd7568267b3faabc3ab6ed9ddfc048ea6640370977f16f4f626a0e567a11ba25acdc520bb000000000000000000000000000000000000000000000000000000000000000012dd65914dda46639df6344701de54ac3ebe34a4b230262d3017fcd6c29954452",
    • "value": "0",
    • "nonce": 1,
    • "gas_limit": 140244,
    • "chain_id": 1
    }
}

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 prefixed by chain identifier: eth, arb, bsc, matic, op

vault_ids
Array of strings
Example: vault_ids=1_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5

Comma-separated list of vault ids

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "deposit",
      • "assets": "1000000",
      • "shares": "996951",
      • "sender": "0x9d94BF9DE2f770645186814556eA3C080E68D2F4",
      • "timestamp": "2024-06-12T11:37:48+00:00",
      • "tx_hash": "0xae6cd6c0180dc7ea54f7ef701c20d6d7c30533e7030485f6b720284a13e00da3",
      • "vault": "0x682cFC8A3d956FBA2c40791ec8d5a49E13BAaFbD",
      • "owner": "0x9d94BF9DE2f770645186814556eA3C080E68D2F4",
      • "chain": "eth"
      },
    • {
      • "type": "withdrawal",
      • "assets": "1000000000",
      • "shares": "996995364",
      • "sender": "0x821B6341bEC60Cb276fBc5E7E25d68D1ca14b180",
      • "timestamp": "2024-06-11T18:43:12+00:00",
      • "tx_hash": "0x6f26fdfad5b13a79dcfd2f8b1fcfe59c411a6d3ea411902f8abd217199302635",
      • "vault": "0x682cFC8A3d956FBA2c40791ec8d5a49E13BAaFbD",
      • "owner": "0x821B6341bEC60Cb276fBc5E7E25d68D1ca14b180",
      • "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 prefixed by chain identifier: eth, arb, bsc, matic, op

vault_ids
Array of strings
Example: vault_ids=1_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5

Comma-separated list of vault ids

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "vault_id": "1_0x9ab5f9101a3c1b868e2c422e294cc2ee685551d5",
      • "asset": "0x94a9d9ac8a22534e3faca9f4e7f2e2cf85d5e4c8",
      • "asset_icon": "https://public.kiln.fi/icons/assets/usdc.svg",
      • "asset_symbol": "USDC",
      • "asset_decimals": 6,
      • "asset_price_usd": 1,
      • "share_symbol": "skcUSDC",
      • "tvl": "1980000",
      • "protocol": "aave_v3",
      • "protocol_display_name": "Aave V3",
      • "protocol_icon": "https://public.kiln.fi/icons/defi-protocols/aave.svg",
      • "protocol_tvl": "1980000",
      • "protocol_supply_limit": "1980000",
      • "grr": 14.9287953383104,
      • "nrr": 11.9430363,
      • "vault": "0x9aB5F9101a3C1B868e2c422E294cc2ee685551D5",
      • "chain": "eth",
      • "chain_id": 1,
      • "updated_at_block": 220379047,
      • "additional_rewards_nrr": 7.763389587402344,
      • "additional_rewards": [
        • {
          • "asset_symbol": "MORPHO",
          • "asset_decimals": 18,
          • "asset": "0x58D97B57BB95320F9a05dC918Aef65434969c2B2",
          • "nrr": 11.9430363
          }
        ]
      }
    ]
}

Deployments

Get deployments of the current organization

Deployments

Get deployments of the current organization

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "id": "9c4520b7-838c-4feb-aefa-679a498af845",
      • "product_type": "defi",
      • "name": "ETH Dedicated Staking",
      • "display_name": "Dedicated Staking",
      • "description": "A Dedicated Staking deployment that earns ETH rewards",
      • "chain": "eth",
      • "chain_id": 1,
      • "address": "0x81Ca2c97f491b13c1EAFeF1ae2cF72DDD1fCBFB6",
      • "status": "active",
      • "asset_icon": "https://example.com/icon.png",
      • "protocol_icon": "https://example.com/icon.png",
      • "product_fee": "0.01"
      }
    ]
}

DyDx (DYDX)

Staking facilities for the DYDX protocol

Stakes

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

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

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

delegators
Array of strings
Example: delegators=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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

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

Comma-separated list of Kiln accounts identifiers

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "delegator_address": "dydx1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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",
      • "rewards_uusdc": "435289200",
      • "available_rewards_uusdc": "435289200",
      • "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": [
            • "dydxvaloper1xyz",
            • "dydxvaloper1abc"
            ],
          • "deny_list": [
            • "dydxvaloper1xyz",
            • "dydxvaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link a DYDX stake to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of DYDX stakes. Units are in uDYDX (10⁻⁶ DYDX).

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

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

delegators
Array of strings
Example: delegators=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "3575891083876864200000",
      • "rewards_uusdc": "142",
      • "active_balance": "6300000000000000000000000",
      • "net_apy": 3.42,
      • "rewards_usd": "12",
      • "rewards_uusdc_usd": "0.12",
      • "balance_usd": "25400"
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "3575891083876864200000",
      • "rewards_uusdc": "245",
      • "active_balance": "6300000000000000000000000",
      • "net_apy": 3.4,
      • "rewards_usd": "13",
      • "rewards_uusdc_usd": "0.12",
      • "balance_usd": "25412"
      }
    ]
}

Operations

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

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

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

delegators
Array of strings
Example: delegators=dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

Responses

Response samples

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

Network Stats

Get some network statistics on dYdX

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Cosmos staking

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

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

validators
Array of strings
Example: validators=dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu

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

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

Comma-separated list of Kiln accounts identifiers

Responses

Get balance

Get balance of a DYDX account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
  • "denom": "uusdc"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "uusdc"
    }
}

Stake Transaction

Generates a delegate transaction on DYDX

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

pubkey
required
string

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

validator
required
string

Validator address

amount_adydx
required
string

Amount to stake in adydx

Responses

Request samples

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

Response samples

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

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on DYDX

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

Responses

Request samples

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

Response samples

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

Unstake Transaction

Generates an undelegate transaction on DYDX

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

amount_adydx
string

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

Responses

Request samples

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

Response samples

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

Redelegate Transaction

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

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to which the new stake will be linked

pubkey
required
string

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

validator_source
required
string

Validator source address of current stake

validator_destination
required
string

Validator destination address to which redelegate the stake

amount_adydx
string

Amount to redelegate in uDYDX

Responses

Request samples

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

Response samples

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

Noble IBC Transfer Transaction

Generates an IBC transfer transaction on DYDX to Noble

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

amount_uusdc
required
string

The amount to transfer in uUSDC

Responses

Request samples

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

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": "dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "adydx",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "adydx",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

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

Transaction to prepare

pubkey
required
string

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

tx_body
required
string

Transaction body serialized in hex

tx_auth_info
required
string

Transaction auth info serialized in hex

signature
required
string

Transaction signature serialized in hex

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcast a signed transaction to the DYDX network

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

Transaction to broadcast

tx_serialized
required
string

Signed transaction serialized in hex

Responses

Request samples

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

Response samples

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

Transaction Status

Get the status of a transaction

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

Hash of the transaction

Responses

Response samples

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Earn

Reporting on earn products (staking, lending, etc.)

Ethereum (EigenLayer)

ReStaking facilities for EigenLayer

EigenLayer EigenPod

Get the EigenPod of the given wallet

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

wallet address

Responses

Response samples

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

EigenLayer Operator

Get information about an EigenLayer Operator

Authorizations:
bearerAuth
query Parameters
operator
required
string
Example: operator=0xA4e245C3a1Cb2F0512a71B9CD908dCa2F1641781

operator address

Responses

Response samples

Content type
application/json; charset=utf-8
{}

EigenLayer Summary

Get a summary of your wallet on EigenLayer

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

wallet address

eigenpod
string
Example: eigenpod=0xAcc1fb458a1317E886dB376Fc8141540537E68fE

EigenPod address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "eigenpod": "0x991c468AbcE2b4DD627a6210C145373EbABdd186",
    • "owner": "0x7fF0B7D8b99E4cD685355A786B6ad5287B6552C1",
    • "delegated_to": "0xA4e245C3a1Cb2F0512a71B9CD908dCa2F1641781",
    • "eigenpod_queuable_restaked_balance": "233079323000000000",
    • "eigenpod_redelegatable_balance": "233079323000000000",
    • "eigenpod_available_balance": "233079323000000000",
    • "eigenpod_pending_balance": "233079323000000000",
    • "eigenpod_withdrawable_balance": "233079323000000000",
    • "beaconchain_restaked_balance": "64000000000000000000",
    • "beaconchain_pending_balance": "32000000000000000000",
    • "beaconchain_restakable_balance": "32000000000000000000"
    }
}

EigenLayer AVS rewards

Get the claimable AVS rewards of a wallet

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

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      • "token_symbol": "EIGEN",
      • "token_decimals": 18,
      • "claimable_amount": "423768272961631825"
      }
    ]
}

EigenLayer Native Points Deprecated

Get restaked points of your EigenPod

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

wallet address

eigenpod
string
Example: eigenpod=0xAcc1fb458a1317E886dB376Fc8141540537E68fE

EigenPod address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "total": 1321313.12313,
    • "breakdown": [
      • {
        • "validator_address": "0x800390da57b384873178a7db4e0b80bc1ed6528510713bcef75f46d339a7bd4957f54159c375d7dc811e52122ad9b604",
        • "points": 16234.9066666
        }
      ]
    }
}

EigenLayer Native Undelegations

Get undelegations of your EigenPod

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

wallet address

eigenpod
string
Example: eigenpod=0xAcc1fb458a1317E886dB376Fc8141540537E68fE

EigenPod address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "id": "0x116d1dbc99ec69f11fecbf409e0e7a204df2bbd6df606138092b2f4748dc254c00000000",
      • "shares": "1017210384000000000",
      • "staker": "0x991c468abce2b4dd627a6210c145373ebabdd186",
      • "delegated_to": "0xa4e245c3a1cb2f0512a71b9cd908dca2f1641781",
      • "withdrawer": "0x991c468abce2b4dd627a6210c145373ebabdd186",
      • "nonce": "4",
      • "block_number": 1301849,
      • "timestamp": 1712523564,
      • "tx_hash": "0x3780bb9a46d0d9a3279f744cf3a9700d58d99a662f891659f0b3428c0bb69030",
      • "claimable": true,
      • "claimable_at_block": 19200000,
      • "claimed": false,
      • "claimed_tx_hash": "0x6b6823670af880e4394d9602a8dd86e95a88cd9ec2440903715537d7bd3e94a5",
      • "withdrawable_as_eth": true
      }
    ]
}

EigenLayer Liquid Points Deprecated

Get restaked points of your Liquid Staking Tokens

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

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "total": 1321313.12313,
    • "breakdown": [
      • {
        • "strategy": "0x7d704507b76571a51d9cae8addabbfd0ba0e63d3",
        • "token": "0x3f1c547b21f65e10480de3ad8e19faac46c95034",
        • "points": 45.2870433486
        }
      ]
    }
}

EigenLayer Liquid Deposits

Get deposits of Liquid staking tokens on EigenLayer

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

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "id": "0x00000abacf28adf70937550a99b01a745bf49a58893fb1a2383973f1c9e0862ea1000000",
      • "staker": "0x7ff0b7d8b99e4cd685355a786b6ad5287b6552c1",
      • "strategy": "0x7d704507b76571a51d9cae8addabbfd0ba0e63d3",
      • "token": "0x3f1c547b21f65e10480de3ad8e19faac46c95034",
      • "shares": "100035705916232161",
      • "block_number": 1260927,
      • "timestamp": 1711990200,
      • "tx_hash": "0xb46702e30e723fad1e03a95baa5183f4d05e497429f6e89476d2383ddafe3224"
      }
    ]
}

EigenLayer Liquid Withdrawals

Get withdrawals of your Liquid Staking Tokens

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

wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "id": "0x116d1dbc99ec69f11fecbf409e0e7a204df2bbd6df606138092b2f4748dc254c00000000",
      • "withdrawer": "0x991c468abce2b4dd627a6210c145373ebabdd186",
      • "staker": "0x991c468abce2b4dd627a6210c145373ebabdd186",
      • "delegated_to": "0xa4e245c3a1cb2f0512a71b9cd908dca2f1641781",
      • "nonce": 4,
      • "tokens": [
        • {
          • "strategy": "0x7d704507b76571a51d9cae8addabbfd0ba0e63d3",
          • "token": "0x3f1c547b21f65e10480de3ad8e19faac46c95034",
          • "shares": "1951305012863276"
          }
        ],
      • "block_number": 1260939,
      • "timestamp": 1711990356,
      • "tx_hash": "0xb4677739bc1fb3402c63111be2b593aa9b8e1db6b99f68114f8b177c082bb151",
      • "claimable": true,
      • "claimable_at_block": 1260949,
      • "claimed": true,
      • "claimed_tx_hash": "0x7702378acb84937775e575a91b679bf911beb1202a7105cbfdf1c4071ab70f98"
      }
    ]
}

EigenLayer Generate Claim Rewards Transaction

Craft a processClaim transaction to retrieve AVS rewards

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

Address that earned the rewards

receiver_address
string

Address that will receive the rewards, if not provided, the earner_address will be used.

token_addresses
Array of strings

Array of ERC20 token addresses for which you have unclaimed rewards. If not provided, we will automatically process all tokens with rewards available to you.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "earner_address": "0x11ed089a9715aDB1e294A73f4e8C40A7a455b6d3",
  • "receiver_address": "0x11ed089a9715aDB1e294A73f4e8C40A7a455b6d3",
  • "token_addresses": [
    • "0x0E859E11bD289e8983f4E78f3503b26F192A7a95",
    • "0x3B78576F7D6837500bA3De27A60c7f594934027E"
    ]
}

Response samples

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

EigenLayer Generate Checkpoint Proofs Transaction

Craft a verifyCheckpointProofs transaction to verify the given validators

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

Address of the EigenPod owner

validator_indexes
Array of integers

Array of validator indexes to process, they must have their withdrawal_credentials pointed to the EigenPod of the given wallet. If not provided, all validators with withdrawal_credentials pointed to the EigenPod of the provided wallet will be processed

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0x7fF0B7D8b99E4cD685355A786B6ad5287B6552C1",
  • "validator_indexes": [
    • 1659766,
    • 1659767
    ]
}

Response samples

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

EigenLayer Restake Transaction

Craft a verifyWithdrawalCredentials transaction to restake the given validators

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

Address of the EigenPod owner

validator_indexes
Array of integers

Array of validator indexes to restake, they must have their withdrawal_credentials pointed to the EigenPod of the given wallet. If not provided, all validators with withdrawal_credentials pointed to the provided EigenPod will be processed

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0x7fF0B7D8b99E4cD685355A786B6ad5287B6552C1",
  • "validator_indexes": [
    • 1
    ]
}

Response samples

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

Ethereum (ETH)

Staking facilities for the Ethereum protocol

Stakes

Get the status of Ethereum stakes.

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

Comma-separated list of validators addresses. Recommended limit is 200.

scope
string
Enum: "kiln" "network"
Example: scope=network

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

wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

proxies
Array of strings
Example: proxies=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of proxy-contract addresses. The definition of a proxy is a smart contract that was involved in the deposit transaction and emitted a log.

withdrawal_credentials
Array of strings
Example: withdrawal_credentials=00f50428677c60f997aadeab24aabf7fceaef491c96a52b463ae91f95611cf71

Comma-separated list of withdrawal credentials.

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

include_eigenlayer
boolean
Example: include_eigenlayer=true

Include EigenLayer reporting data

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

Comma-separated list of Kiln accounts identifiers

current_page
integer >= 1
Example: current_page=1

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

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

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

filter_states
Array of strings
Items Enum: "unknown" "unstaked" "deposit_in_progress" "pending_initialized" "pending_queued" "active_ongoing" "active_exiting" "active_slashed" "exited_unslashed" "exited_slashed" "withdrawal_possible" "withdrawal_done"
Example: filter_states=deposit_in_progress,pending_initialized

Comma-separated list of states to filter on (unknown, unstaked, deposit_in_progress, pending_initialized, pending_queued, active_ongoing, active_exiting, active_slashed, exited_unslashed, exited_slashed, withdrawal_possible, withdrawal_done). Not available with the scope parameter

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412",
      • "validator_index": "1",
      • "state": "active_ongoing",
      • "activated_at": "2023-01-14T01:13:59Z",
      • "activated_epoch": 174049,
      • "delegated_at": "2023-01-14T01:13:59Z",
      • "delegated_block": 16397387,
      • "exited_at": "2023-01-14T01:13:59Z",
      • "exited_epoch": 174049,
      • "deposit_tx_sender": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "execution_fee_recipient": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "effective_balance": "32000000000000000000",
      • "balance": "32076187808000000000",
      • "consensus_rewards": "76187808000000000",
      • "execution_rewards": "0",
      • "rewards": "76187808000000000",
      • "claimable_execution_rewards": "76187808000000000",
      • "claimable_consensus_rewards": "76187808000000000",
      • "gross_apy": 3.407,
      • "is_kiln": true,
      • "updated_at": "2023-01-14T01:13:59Z",
      • "eigenlayer": {
        • "is_restaked": true,
        • "is_restakable": true,
        • "is_pending": true,
        • "is_withdrawn": true,
        • "last_checkpointed_at": 16397387,
        • "points": 16287.724444444444
        },
      • "estimated_next_skimming_slot": 16397387,
      • "estimated_next_skimming_at": "2023-01-14T01:13:59Z",
      • "exit_requested": true
      }
    ],
  • "pagination": {
    • "current_page": 2,
    • "next_page": 3,
    • "previous_page": 1,
    • "page_size": 25,
    • "total_pages": 17,
    • "total_entries": 423
    }
}

Create stakes Deprecated

Link ETH stakes to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "0x95373bcf8e2c64e1c373a6e534c002f210adbcc84c5abda3b6306677e171430ae50781a51c9f579a47622e334dba2412",
      • "validator_index": "1",
      • "state": "active_ongoing",
      • "activated_at": "2023-01-14T01:13:59Z",
      • "activated_epoch": 174049,
      • "delegated_at": "2023-01-14T01:13:59Z",
      • "delegated_block": 16397387,
      • "exited_at": "2023-01-14T01:13:59Z",
      • "exited_epoch": 174049,
      • "deposit_tx_sender": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "execution_fee_recipient": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "effective_balance": "32000000000000000000",
      • "balance": "32076187808000000000",
      • "consensus_rewards": "76187808000000000",
      • "execution_rewards": "0",
      • "rewards": "76187808000000000",
      • "claimable_execution_rewards": "76187808000000000",
      • "claimable_consensus_rewards": "76187808000000000",
      • "gross_apy": 3.407,
      • "is_kiln": true,
      • "updated_at": "2023-01-14T01:13:59Z",
      • "eigenlayer": {
        • "is_restaked": true,
        • "is_restakable": true,
        • "is_pending": true,
        • "is_withdrawn": true,
        • "last_checkpointed_at": 16397387,
        • "points": 16287.724444444444
        },
      • "estimated_next_skimming_slot": 16397387,
      • "estimated_next_skimming_at": "2023-01-14T01:13:59Z",
      • "exit_requested": true
      }
    ],
  • "pagination": {
    • "current_page": 2,
    • "next_page": 3,
    • "previous_page": 1,
    • "page_size": 25,
    • "total_pages": 17,
    • "total_entries": 423
    }
}

Rewards

Get historical rewards by day of Ethereum stakes

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

Comma-separated list of validators addresses. Recommended limit is 200.

scope
string
Enum: "kiln" "network"
Example: scope=network

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

wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

proxies
Array of strings
Example: proxies=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of proxy-contract addresses. The definition of a proxy is a smart contract that was involved in the deposit transaction and emitted a log.

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15,",
      • "consensus_rewards": "2988504000000000,",
      • "execution_rewards": "0,",
      • "mev_execution_rewards": "0,",
      • "non_mev_execution_rewards": "0,",
      • "median_execution_reward": "0,",
      • "rewards": "2988504000000000,",
      • "stake_balance": "64000000000000000000,",
      • "gross_apy": "3.407,",
      • "cl_apy": "3.407,",
      • "el_apy": "0,",
      • "active_validator_count": "152636.33,",
      • "rewards_usd": "0,",
      • "stake_balance_usd": 0
      },
    • {
      • "date": "2023-01-16,",
      • "consensus_rewards": "2954604000000000,",
      • "execution_rewards": "0,",
      • "mev_execution_rewards": "0,",
      • "non_mev_execution_rewards": "0,",
      • "median_execution_reward": "0,",
      • "rewards": "2954604000000000,",
      • "stake_balance": "64000000000000000000,",
      • "gross_apy": "3.407,",
      • "cl_apy": "3.407,",
      • "el_apy": "0,",
      • "active_validator_count": "152636.33,",
      • "rewards_usd": "0,",
      • "stake_balance_usd": 0
      }
    ]
}

Operations

Get the operations of Ethereum stakes

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

Comma-separated list of validators addresses. Recommended limit is 200.

wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

proxies
Array of strings
Example: proxies=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of proxy-contract addresses. The definition of a proxy is a smart contract that was involved in the deposit transaction and emitted a log.

validator_indexes
Array of integers
Example: validator_indexes=1

Comma-separated list of validators' consensus layer indexes

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

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

Network Stats

Get some network statistics on Ethereum staking.

Authorizations:
bearerAuth

Responses

Response samples

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

Kiln Stats

Get some Kiln statistics on Ethereum staking

Authorizations:
bearerAuth

Responses

Response samples

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

Validation Keys

Create Ethereum native validation keys on Kiln's infrastructure.

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

Ethereum keys to generate

account_id
required
string <uuid>

Kiln Account ID to stake into.

withdrawal_address
required
string

Ethereum withdrawal address used for the withdrawals credentials of the validators. This is the address that will receive consensus rewards. BLS format is not supported. This address is used as the execution-layer fee-recipient unless fee_recipient_address is specified.

fee_recipient_address
string

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

number
required
number [ 1 .. 150 ]

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

format
string
Default: "batch_deposit"
Enum: "cli_deposit" "batch_deposit"

Response format. Use "cli_deposit" for more information about each key.

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "format": "cli_deposit",
      • "pubkey": "8f36e2f4e921b1ed5ce9c94f21e1f26a748ac4e0c57f0d8973e7d576a2f8953b87dd86300de718238de23b1fecb19db5",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "amount": 32000000000,
      • "signature": "b7947eabf631d4772c4014a9fec2ecac2c15fc5175ad83023bbdfc9e6618cb8e78829231477c060bc9339482058ff195141f2aeb801c0329a1a4afebd7e76ce0ba1d9d88f8820d052836a79d59aea673db9eb5009db4a4f6e04fb7ffbdbdd604",
      • "deposit_message_root": "65db6ae73c6465311a7acf2cd8a2863eececf09901872550639f0d8f6c1876f5",
      • "deposit_data_root": "9b74cccf3a3c501374179be4bb6f505c4b40da41c205a101db3342a8df0af2dd",
      • "fork_version": "00000000",
      • "network_name": "mainnet",
      • "deposit_cli_version": "2.2.0"
      }
    ]
}

Stake Transaction

Generates an Ethereum EIP 1559 stake transaction

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

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

amount_wei
required
string

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

Responses

Request samples

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

Response samples

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

Prepare Transaction

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

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

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

r
required
string

r part of the ECDSA signature in hex

s
required
string

s part of the ECDSA signature in hex

v
required
number

v part of the ECDSA signature (0 or 1)

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcasts a signed Ethereum transaction

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

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

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

Response samples

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

Transaction Status

Get the status of an Ethereum transaction

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

Hash of the transaction

Responses

Response samples

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

Request Exit

Generates an Ethereum EIP 1559 request-exit transaction

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

Transaction to craft

wallet
required
string

Wallet to request-exit from, it must be the owner of the stake OR of the EigenPod which owns this stake.

validators
required
Array of strings

Public keys of the validators to exit

Responses

Request samples

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

Response samples

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Excel Reports

Generates an Excel report sheet for your stakes and rewards

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

Comma-separated list of validators addresses. Recommended limit is 200.

wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Exit Messages

Get encrypted exit message for a validator

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

Comma-separated list of validators addresses. Recommended limit is 200.

Responses

Response samples

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

Ethereum (OnChain)

Staking facilities for OnChain v1 & v2

Validation On-Chain V1 Keys

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

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

Ethereum keys to generate

account_id
required
string <uuid>

Kiln Account ID to stake into.

number
required
number [ 1 .. 150 ]

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

fee_recipient_contract_address
required
string

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

staking_contract_address
required
string

Kiln V1 Smart-contract used to stake generated keys.

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "format": "cli_deposit",
      • "pubkey": "8f36e2f4e921b1ed5ce9c94f21e1f26a748ac4e0c57f0d8973e7d576a2f8953b87dd86300de718238de23b1fecb19db5",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "amount": 32000000000,
      • "signature": "b7947eabf631d4772c4014a9fec2ecac2c15fc5175ad83023bbdfc9e6618cb8e78829231477c060bc9339482058ff195141f2aeb801c0329a1a4afebd7e76ce0ba1d9d88f8820d052836a79d59aea673db9eb5009db4a4f6e04fb7ffbdbdd604",
      • "deposit_message_root": "65db6ae73c6465311a7acf2cd8a2863eececf09901872550639f0d8f6c1876f5",
      • "deposit_data_root": "9b74cccf3a3c501374179be4bb6f505c4b40da41c205a101db3342a8df0af2dd",
      • "fork_version": "00000000",
      • "network_name": "mainnet",
      • "deposit_cli_version": "2.2.0"
      }
    ]
}

Validation On-Chain V2 Keys

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

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

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

account_id
required
string <uuid>

Kiln Account ID to stake into.

number
required
number [ 1 .. 150 ]

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

factory_contract_address
string

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

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "format": "cli_deposit",
      • "pubkey": "8f36e2f4e921b1ed5ce9c94f21e1f26a748ac4e0c57f0d8973e7d576a2f8953b87dd86300de718238de23b1fecb19db5",
      • "withdrawal_credentials": "010000000000000000000000e1f4acc0affb36a805474e3b6ab786738c6900a2",
      • "amount": 32000000000,
      • "signature": "b7947eabf631d4772c4014a9fec2ecac2c15fc5175ad83023bbdfc9e6618cb8e78829231477c060bc9339482058ff195141f2aeb801c0329a1a4afebd7e76ce0ba1d9d88f8820d052836a79d59aea673db9eb5009db4a4f6e04fb7ffbdbdd604",
      • "deposit_message_root": "65db6ae73c6465311a7acf2cd8a2863eececf09901872550639f0d8f6c1876f5",
      • "deposit_data_root": "9b74cccf3a3c501374179be4bb6f505c4b40da41c205a101db3342a8df0af2dd",
      • "fork_version": "00000000",
      • "network_name": "mainnet",
      • "deposit_cli_version": "2.2.0"
      }
    ]
}

On-Chain V2 Stakes

Get the status of Ethereum OnChain V2 (vSuite) stakes

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

Comma-separated list of wallets addresses

Responses

Response samples

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

On-Chain V2 Operations

Get the operations of Ethereum OnChain V2 (vSuite) operations

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

Comma-separated list of wallets addresses

ids
Array of strings
Example: ids=15458, 15459

Comma-separated list of operation IDs

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

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

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

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

Responses

Response samples

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

On-Chain V2 Rewards

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

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

Comma-separated list of wallets addresses

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

integration
string
Example: integration=0x65da6aecfa84b77a25a7e83e65cd3c6bda12186c

The address of the pooling integration

Responses

Response samples

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

On-Chain V2 Network Stats

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

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

The address of the pooling integration

Responses

Response samples

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

On-Chain V2 Exit Tickets

Get the exit tickets of Ethereum OnChain V2 (vSuite) integration

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

Comma-separated list of wallets addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "owner": "0x991c468abce2b4dd627a6210c145373ebabdd186",
      • "state": "fulfillable",
      • "retrievable_amount": "9999999999999998",
      • "exiting_amount": "0",
      • "exit_queue_address": "0x8979117a69dfa7f4d4e3c7b59197ff03f4a2ceaf",
      • "integration_address": "0xf448e20f8a69aeb88a7dfb837e6afab5e7bcf80e",
      • "ticket_id": "63632802614215492667651061498899397423000",
      • "cask_id": "89",
      • "estimated_claimable_at": 1725530777795
      }
    ]
}

Fetch.ai (FET)

Staking facilities for the Fetch.IA protocol

Stakes

Get the status of FET stakes. Units are in uFET (10⁻⁶ FET).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "delegator_address": "fetch1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "fetchvaloper1xyz",
            • "fetchvaloper1abc"
            ],
          • "deny_list": [
            • "fetchvaloper1xyz",
            • "fetchvaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link a FETCH 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": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu_fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6}"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of FETCH stakes. Units are in uFET (10⁻⁶ FET).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2024-04-02",
      • "balance": "1241363393778",
      • "rewards": "304836574",
      • "net_apy": 8.96,
      • "balance_usd": 3594430.8409594875,
      • "rewards_usd": 882.6698036449283
      },
    • {
      • "date": "2024-04-03",
      • "balance": "1241726584155",
      • "rewards": "303185463",
      • "net_apy": 8.91,
      • "balance_usd": 3271315.486798869,
      • "rewards_usd": 798.7388795087446
      }
    ]
}

Operations

Get the operations of FET stakes. Units are in uFET (10⁻⁶ FET).

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

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

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

Network Stats

Get some network statistics on Fetch

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Cosmos staking

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

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

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

Get balance

Get balance of a Fet account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
  • "denom": "afet"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "afet"
    }
}

Stake Transaction

Generates a delegate transaction on Fetch

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_afet
required
string

Amount to stake in afet

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

grantee_address
string

Responses

Request samples

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

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": "afet",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
          • "validatorAddress": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
          • "amount": {
            • "denom": "afet",
            • "amount": "1000000"
            }
          }
        },
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.StakeAuthorization",
        • "allowList": {
          • "address": [
            • "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu"
            ]
          },
        • "AuthorizationType": 1
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Fetch

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

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": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "afet",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "afet",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Restake Rewards Transaction

Generates a restake rewards transaction on Fetch

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

grantee_address
required
string

Responses

Request samples

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

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": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "afet",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "afet",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Fetch

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_afet
string

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

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "amount_afet": "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": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "afet",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "afet",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Send Transaction

Generates a send transaction on Fetch

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

to
required
string

Recipient address

amount_afet
required
string

Amount to send in afet

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "to": "fetch1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
  • "amount_afet": "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": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "afet",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "afet",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Redelegate Transaction

Generates a redelegate transaction on Fetch 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_afet
string

Amount to redelegate in uFET

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator_source": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "validator_destination": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "amount_afet": "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": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "fetchvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "afet",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "afet",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "afet",
            • "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
        }
      ]
    }
}

Injective (INJ)

Staking facilities for the Injective protocol

Stakes

Get the status of INJ stakes. Units are in uINJ (10⁻⁶ INJ).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
      • "delegator_address": "inj1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "injvaloper1xyz",
            • "injvaloper1abc"
            ],
          • "deny_list": [
            • "injvaloper1xyz",
            • "injvaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link a Inj 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": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu_inj1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6}"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of Inj stakes. Units are in uINJ (10⁻⁶ INJ).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2024-04-02",
      • "balance": "1241363393778",
      • "rewards": "304836574",
      • "net_apy": 8.96,
      • "balance_usd": 3594430.8409594875,
      • "rewards_usd": 882.6698036449283
      },
    • {
      • "date": "2024-04-03",
      • "balance": "1241726584155",
      • "rewards": "303185463",
      • "net_apy": 8.91,
      • "balance_usd": 3271315.486798869,
      • "rewards_usd": 798.7388795087446
      }
    ]
}

Operations

Get the operations of INJ stakes. Units are in uINJ (10⁻⁶ INJ).

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

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

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

Network Stats

Get some network statistics on Inj

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Cosmos staking

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

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

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 Inj

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_inj
required
string

Amount to stake in inj

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "amount_inj": "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",
    • "fee": {
      • "amount": [
        • {
          • "denom": "inj",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "inj1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
          • "validatorAddress": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
          • "amount": {
            • "denom": "inj",
            • "amount": "1000000"
            }
          }
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Inj

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

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": "inj1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "inj",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "inj",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Inj

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_inj
string

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

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "amount_inj": "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": "inj1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "inj",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "inj",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Redelegate Transaction

Generates a redelegate transaction on Inj 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_inj
string

Amount to redelegate in uINJ

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator_source": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "validator_destination": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
  • "amount_inj": "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": "inj1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "injvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "inj",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "inj",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "inj",
            • "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
        }
      ]
    }
}

Kava (KAVA)

Staking facilities for the Kava protocol

Stakes

Get the status of KAVA stakes. Units are in uKAVA (10⁻⁶ KAVA).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
      • "delegator_address": "kava1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "kavavaloper1xyz",
            • "kavavaloper1abc"
            ],
          • "deny_list": [
            • "kavavaloper1xyz",
            • "kavavaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link a Kava 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": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe_kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460}"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of KAVA stakes. Units are in uKAVA (10⁻⁶ KAVA).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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 Kava stakes. Units are in uKAVA (10⁻⁶ KAVA).

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

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

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

Network Stats

Get some network statistics on Kava

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Kava staking

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

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

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

Get balance

Get balance of a Kava account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "fetch1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
  • "denom": "ukava"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "ukava"
    }
}

Stake Transaction

Generates a delegate transaction on Kava

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_ukava
required
string

Amount to stake in ukava

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "amount_ukava": "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",
    • "fee": {
      • "amount": [
        • {
          • "denom": "ukava",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
          • "validatorAddress": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
          • "amount": {
            • "denom": "ukava",
            • "amount": "1000000"
            }
          }
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Kava

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

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": "kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "ukava",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "ukava",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Kava

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_ukava
string

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

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "amount_ukava": "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": "kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "ukava",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "ukava",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Restake Rewards Transaction

Generates a restake rewards transaction on Kava

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

grantee_address
required
string

Responses

Request samples

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

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": "kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "ukava",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "ukava",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Redelegate Transaction

Generates a redelegate transaction on Kava 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_ukava
string

Amount to redelegate in uKAVA

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator_source": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "validator_destination": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "amount_ukava": "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": "kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "ukava",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "ukava",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Send Transaction

Generates a send transaction on Kava

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

to
required
string

Recipient address

amount_ukava
required
string

Amount to send in ukava

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "to": "kava1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
  • "amount_ukava": "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": "kava1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "kavavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "ukava",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "ukava",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "ukava",
            • "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
        }
      ]
    }
}

Kiln

Get data on Kiln's validators

Get Kiln validator details for a given network

Get Kiln validators

Authorizations:
bearerAuth
query Parameters
network
string
Enum: "mainnet" "testnet"
Example: network=mainnet

Network to get validators for (mainnet, testnet)

protocols
Array of strings
Example: protocols=ETH,SOL

Comma-separated list of protocol token symbol to filter by

Responses

Response samples

Content type
application/json
{
  • "data": {
    • "validators": [ ]
    }
}

Kusama (KSM)

Staking facilities for the Kusama protocol

Stakes

Get the status of Kusama stakes. Data since block #1496832 (2020-03-18 04:27:54 (+UTC) is available.

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "address": "1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J",
      • "pool_id": 118,
      • "active_balance": "30004690613",
      • "unbonding_balance": "30004690613",
      • "withdrawable_balance": "30004690613",
      • "net_rewards": "37201548",
      • "gross_rewards": "37201548",
      • "withdrawable_rewards": "37201548",
      • "state": "active",
      • "net_apy": 0.188014,
      • "delegated_at": "2023-01-06T22:00:00Z",
      • "updated_at": "2023-01-14T01:13:59Z",
      • "undelegated_at": "2023-01-06T22:00:00Z"
      }
    ]
}

Rewards

Get historical rewards by day or era of KSM stakes. Data since block #1496832 (2020-03-18 04:27:54 (+UTC) is available.

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

validators
string
Example: validators=1497QNdycmxqMi3VJDxZDhaJh4s9tytr5RFWyrLcNse2xqPD

Comma separated list of validators addresses

pool_ids
integer
Example: pool_ids=118

Comma separated list of pool ids. If used with 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

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)

format
string
Enum: "daily" "era"

The format of the response. Defaults to daily

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "net_rewards": "27098488",
      • "gross_rewards": "27098488",
      • "active_balance": "420000000000",
      • "net_apy": 3.42,
      • "gross_apy": 3.42
      },
    • {
      • "date": "2023-01-16",
      • "net_rewards": "27099488",
      • "gross_rewards": "0",
      • "active_balance": "420027098488",
      • "net_apy": 3.4,
      • "gross_apy": 0
      }
    ]
}

Operations

Get the operations of Kusama stakes

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "staking.bonded",
      • "block_number": 15828207,
      • "block_time": "2023-06-22T15:35:01.892644Z",
      • "tx_hash": "0xf476bc1b633528a2cfbb1c959755318bed1c6825d7bb6b89d7ffc1026066f17c",
      • "extrinsic_seq_id": 4,
      • "event_seq_id": 42,
      • "amount": "3000000",
      • "address": "F3opxRbN5ZavB4LTn2PZNFRrF6pirwvYPbXnJKYNAmutiPY",
      • "validator": "FV3za2fceAXtw4KwVnPJK4c4Y2ph8VNMEA26MkgjTaEA76u",
      • "pool_id": "131",
      • "earned_era": "1403",
      • "era": "1404"
      }
    ]
}

Reports

Get reports on Kusama staking

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Network Stats

Get stats on Kusama network

Authorizations:
bearerAuth

Responses

Response samples

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

Bond Transaction

Generates a bond transaction on Kusama

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 Kusama

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 Kusama (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 Kusama

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 Kusama

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 Kusama

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 Kusama

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 Kusama

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 Kusama

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

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 Kusama

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 Kusama

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 Kusama

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 Kusama

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 Kusama

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

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

Mantra (OM)

Staking facilities for the Mantra protocol

Stakes

Get the status of OM stakes. Units are in uOM (10⁻⁶ OM).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
      • "delegator_address": "mantra1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "mantravaloper1xyz",
            • "mantravaloper1abc"
            ],
          • "deny_list": [
            • "mantravaloper1xyz",
            • "mantravaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link a Mantra 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": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g_mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a}"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of Mantra stakes. Units are in uOM (10⁻⁶ OM).

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

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

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2024-04-02",
      • "balance": "1241363393778",
      • "rewards": "304836574",
      • "net_apy": 8.96,
      • "balance_usd": 3594430.8409594875,
      • "rewards_usd": 882.6698036449283
      },
    • {
      • "date": "2024-04-03",
      • "balance": "1241726584155",
      • "rewards": "303185463",
      • "net_apy": 8.91,
      • "balance_usd": 3271315.486798869,
      • "rewards_usd": 798.7388795087446
      }
    ]
}

Operations

Get the operations of Mantra stakes. Units are in uOM (10⁻⁶ OM).

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

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

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

Network Stats

Get some network statistics on Mantra

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Mantra staking

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

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

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

Get balance

Get balance of a Mantra account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "mantra1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
  • "denom": "uOM"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "uOM"
    }
}

Stake Transaction

Generates a delegate transaction on Mantra

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_uom
required
string

Amount to stake in uom

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

grantee_address
string

Responses

Request samples

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

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": "uom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a",
          • "validatorAddress": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
          • "amount": {
            • "denom": "uom",
            • "amount": "1000000"
            }
          }
        },
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.StakeAuthorization",
        • "allowList": {
          • "address": [
            • "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g"
            ]
          },
        • "AuthorizationType": 1
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Mantra

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

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": "mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a",
        • "validatorAddress": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
        • "amount": {
          • "denom": "uom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Restake Rewards Transaction

Generates a restake rewards transaction on Mantra

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

grantee_address
required
string

Responses

Request samples

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

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": "mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a",
        • "validatorAddress": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
        • "amount": {
          • "denom": "uom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Mantra

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_uom
string

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

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
  • "amount_uom": "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": "mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a",
        • "validatorAddress": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
        • "amount": {
          • "denom": "uom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Redelegate Transaction

Generates a redelegate transaction on Mantra 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_uom
string

Amount to redelegate in uOM

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator_source": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
  • "validator_destination": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
  • "amount_uom": "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": "mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a",
        • "validatorAddress": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
        • "amount": {
          • "denom": "uom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Send Transaction

Generates a send transaction on Mantra

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

to
required
string

Recipient address

amount_uom
required
string

Amount to send in uom

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "to": "mantra1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
  • "amount_uom": "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": "mantra156h4wqz5p0xuj48cn0cv2sg8q9p2y3nycg3h3a",
        • "validatorAddress": "mantravaloper1qum83utf8833n4f857w98dxc5w8qlnq9eeew4g",
        • "amount": {
          • "denom": "uom",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uom",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "uom",
            • "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
        }
      ]
    }
}

MultiversX (EGLD)

Staking facilities for the MultiversX protocol

Stakes

Get the status of MultiversX stakes

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrhlllls062tu4

Comma-separated list of validator contract addresses

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "wallet": "erd12mu6jt25v8cqvknug5yxqul8cgmnxf9t3kh7sa2ycphm29kqrlts552srv",
      • "validator": "erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrhlllls062tu4",
      • "state": "ACTIVE",
      • "delegated_at": "2023-01-14T01:13:59Z",
      • "delegated_epoch": 1105,
      • "undelegated_at": "2023-01-14T01:13:59Z",
      • "undelegated_epoch": 1105,
      • "balance": "32076187808000000000",
      • "rewards": "76187808000000000",
      • "grr": 0.03407,
      • "updated_at": "2023-01-14T01:13:59Z"
      }
    ]
}

Rewards

Get historical rewards of MultiversX stakes

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrhlllls062tu4

Comma-separated list of validator contract addresses

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

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

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "27098488",
      • "active_balance": "420000000000",
      • "grr": 0.0342
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "27099488",
      • "active_balance": "420027098488",
      • "grr": 0.034
      }
    ]
}

Network Stats

Get stats on MutiversX network

Authorizations:
bearerAuth

Responses

Response samples

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

Operations

Get historical operations of MultiversX stakes

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrhlllls062tu4

Comma-separated list of validator contract addresses

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

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

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "sender": "erd1exqua32r233fwsxv074dhmp5yw4nz3xnn2kkdayp2wg566janpeqhdayjd",
      • "receiver": "erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqz8llllsh6u4jp",
      • "tx_hash"": "c03a95f5d9d3c8d6a99c0a22faf78f246b3da6a1d564e52c184b38e735de95a1",
      • "tx_timestamp": "2024-03-29T11:55:18Z",
      • "amount": "1120594360000000001",
      • "gas_used": "6062000",
      • "type": "delegate"
      }
    ]
}

Reports

Get reports on MultiversX staking

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrhlllls062tu4

Comma-separated list of validator contract addresses

Responses

Near (NEAR)

Staking facilities for the Near protocol

Stakes

Get the status of NEAR stakes

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

Comma-separated list of Kiln internal stake account ID

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

Comma-separated list of NEAR validator ID

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

Comma-separated list of NEAR account ID

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

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

Create stakes Deprecated

Create NEAR stakes and linked them to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards of NEAR stakes

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

Comma-separated list of Kiln internal stake account ID

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

Comma-separated list of NEAR validator ID

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

Comma-separated list of NEAR account ID

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

Comma-separated list of Kiln accounts identifiers

format
string
Enum: "daily" "epoch"

The format of the response. Defaults to daily

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

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

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

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

start_epoch
number
Example: start_epoch=542

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

end_epoch
number
Example: end_epoch=542

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

include_usd
boolean
Example: include_usd=1

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "1000",
      • "active_balance": "100000",
      • "net_apy": 3.42,
      • "rewards_usd": "12",
      • "stake_balance_usd": "25400"
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "1000",
      • "active_balance": "100000",
      • "net_apy": 3.4,
      • "rewards_usd": "13",
      • "stake_balance_usd": "25412"
      }
    ]
}

Operations

Get the operations of NEAR stakes

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

Comma-separated list of Kiln internal stake account ID

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

Comma-separated list of NEAR account ID

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

Comma-separated list of Kiln accounts identifiers

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)

tx_hash
string

Hash of the transaction

Responses

Response samples

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

Reports

Get reports on NEAR staking

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

Comma-separated list of Kiln internal stake account ID

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

Comma-separated list of NEAR account ID

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

Comma-separated list of Kiln accounts identifiers

format
string
Enum: "daily" "epoch"

The format of the response. Defaults to daily

Responses

Get epoch infos

Get current and next epochs info

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "current_epoch": 3043,
    • "current_epoch_start_ts": "2025-03-07T02:31:59.394Z",
    • "current_epoch_start_height": 141277911,
    • "next_epoch": 3044,
    • "next_epoch_estimated_start_ts": "2025-03-07T16:10:26.255Z",
    • "next_epoch_estimated_start_height": 141321111
    }
}

Network Stats

Get stats on NEAR network

Authorizations:
bearerAuth

Responses

Response samples

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

Stake transaction

Craft a stake transaction

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

Transaction to craft

account_id
required
string

Kiln Account ID

wallet
required
string

NEAR wallet address

pool_id
required
string

NEAR pool ID

amount_yocto
required
string

Amount to stake in Yocto (1 NEAR = 10^24 Yocto)

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
  • "wallet": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
  • "pool_id": "kiln.pool.f863973.m0",
  • "amount_yocto": "1000000000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "400000006333366231613564613265363064316664356433613662343666373339396562323635373134353766333237326633633937386263393532376164323333356600c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f0cc2dad0ea920000140000006b696c6e2e706f6f6c2e663836333937332e6d3037ce9c68061b12cc551a33496f858157ec5fb1e509179e69acfce58d7245aa6801000000020c00000077697468647261775f616c6c020000007b7d00c06e31d910010000000000000000000000000000000000",
    • "unsigned_tx_hash": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
    • "tx": {
      • "signerId": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
      • "publicKey": {
        • "ed25519Key": {
          • "keyType": 0,
          • "data": [
            • 195,
            • 107,
            • 26,
            • 93,
            • 162,
            • 230,
            • 13,
            • 31,
            • 213,
            • 211,
            • 166,
            • 180,
            • 111,
            • 115,
            • 153,
            • 235,
            • 38,
            • 87,
            • 20,
            • 87,
            • 243,
            • 39,
            • 47,
            • 60,
            • 151,
            • 139,
            • 201,
            • 82,
            • 122,
            • 210,
            • 51,
            • 95
            ]
          },
        • "enum": "ed25519Key"
        },
      • "nonce": "161537224000012",
      • "receiverId": "kiln.pool.f863973.m0",
      • "actions": [
        • {
          • "functionCall": {
            • "methodName": "withdraw_all",
            • "args": {
              • "type": "Buffer",
              • "data": [
                • 123,
                • 125
                ]
              },
            • "gas": "300000000000000",
            • "deposit": "0"
            },
          • "enum": "functionCall"
          }
        ],
      • "blockHash": [
        • 92,
        • 235,
        • 96,
        • 73,
        • 5,
        • 142,
        • 190,
        • 166,
        • 118,
        • 248,
        • 71,
        • 141,
        • 118,
        • 93,
        • 206,
        • 84,
        • 209,
        • 33,
        • 196,
        • 62,
        • 180,
        • 199,
        • 65,
        • 131,
        • 28,
        • 161,
        • 140,
        • 43,
        • 144,
        • 134,
        • 244,
        • 245
        ]
      }
    }
}

Unstake transaction

Craft an unstake transaction

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

Transaction to craft

wallet
required
string

NEAR wallet address

pool_id
required
string

NEAR pool ID

amount_yocto
string

Amount to unstake in Yocto (1 NEAR = 10^24 Yocto). If not specified, all the stake will be unstaked.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
  • "pool_id": "kiln.pool.f863973.m0",
  • "amount_yocto": "1000000000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "400000006333366231613564613265363064316664356433613662343666373339396562323635373134353766333237326633633937386263393532376164323333356600c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f0cc2dad0ea920000140000006b696c6e2e706f6f6c2e663836333937332e6d3037ce9c68061b12cc551a33496f858157ec5fb1e509179e69acfce58d7245aa6801000000020c00000077697468647261775f616c6c020000007b7d00c06e31d910010000000000000000000000000000000000",
    • "unsigned_tx_hash": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
    • "tx": {
      • "signerId": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
      • "publicKey": {
        • "ed25519Key": {
          • "keyType": 0,
          • "data": [
            • 195,
            • 107,
            • 26,
            • 93,
            • 162,
            • 230,
            • 13,
            • 31,
            • 213,
            • 211,
            • 166,
            • 180,
            • 111,
            • 115,
            • 153,
            • 235,
            • 38,
            • 87,
            • 20,
            • 87,
            • 243,
            • 39,
            • 47,
            • 60,
            • 151,
            • 139,
            • 201,
            • 82,
            • 122,
            • 210,
            • 51,
            • 95
            ]
          },
        • "enum": "ed25519Key"
        },
      • "nonce": "161537224000012",
      • "receiverId": "kiln.pool.f863973.m0",
      • "actions": [
        • {
          • "functionCall": {
            • "methodName": "withdraw_all",
            • "args": {
              • "type": "Buffer",
              • "data": [
                • 123,
                • 125
                ]
              },
            • "gas": "300000000000000",
            • "deposit": "0"
            },
          • "enum": "functionCall"
          }
        ],
      • "blockHash": [
        • 92,
        • 235,
        • 96,
        • 73,
        • 5,
        • 142,
        • 190,
        • 166,
        • 118,
        • 248,
        • 71,
        • 141,
        • 118,
        • 93,
        • 206,
        • 84,
        • 209,
        • 33,
        • 196,
        • 62,
        • 180,
        • 199,
        • 65,
        • 131,
        • 28,
        • 161,
        • 140,
        • 43,
        • 144,
        • 134,
        • 244,
        • 245
        ]
      }
    }
}

Withdraw transaction

Craft a withdraw transaction

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

Transaction to craft

wallet
required
string

NEAR wallet address

pool_id
required
string

NEAR pool ID

amount_yocto
string

Amount to withdraw in Yocto (1 NEAR = 10^24 Yocto). If not specified, all the stake will be withdrawn.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
  • "pool_id": "kiln.pool.f863973.m0",
  • "amount_yocto": "1000000000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_serialized": "400000006333366231613564613265363064316664356433613662343666373339396562323635373134353766333237326633633937386263393532376164323333356600c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f0cc2dad0ea920000140000006b696c6e2e706f6f6c2e663836333937332e6d3037ce9c68061b12cc551a33496f858157ec5fb1e509179e69acfce58d7245aa6801000000020c00000077697468647261775f616c6c020000007b7d00c06e31d910010000000000000000000000000000000000",
    • "unsigned_tx_hash": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
    • "tx": {
      • "signerId": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f",
      • "publicKey": {
        • "ed25519Key": {
          • "keyType": 0,
          • "data": [
            • 195,
            • 107,
            • 26,
            • 93,
            • 162,
            • 230,
            • 13,
            • 31,
            • 213,
            • 211,
            • 166,
            • 180,
            • 111,
            • 115,
            • 153,
            • 235,
            • 38,
            • 87,
            • 20,
            • 87,
            • 243,
            • 39,
            • 47,
            • 60,
            • 151,
            • 139,
            • 201,
            • 82,
            • 122,
            • 210,
            • 51,
            • 95
            ]
          },
        • "enum": "ed25519Key"
        },
      • "nonce": "161537224000012",
      • "receiverId": "kiln.pool.f863973.m0",
      • "actions": [
        • {
          • "functionCall": {
            • "methodName": "withdraw_all",
            • "args": {
              • "type": "Buffer",
              • "data": [
                • 123,
                • 125
                ]
              },
            • "gas": "300000000000000",
            • "deposit": "0"
            },
          • "enum": "functionCall"
          }
        ],
      • "blockHash": [
        • 92,
        • 235,
        • 96,
        • 73,
        • 5,
        • 142,
        • 190,
        • 166,
        • 118,
        • 248,
        • 71,
        • 141,
        • 118,
        • 93,
        • 206,
        • 84,
        • 209,
        • 33,
        • 196,
        • 62,
        • 180,
        • 199,
        • 65,
        • 131,
        • 28,
        • 161,
        • 140,
        • 43,
        • 144,
        • 134,
        • 244,
        • 245
        ]
      }
    }
}

Prepare transaction

Prepare a transaction for broadcasting by adding a signature to it

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

Transaction to craft

unsigned_tx_serialized
required
string

Unsigned transaction serialized

signature
required
string

Signature of the transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "400000006333366231613564613265363064316664356433613662343666373339396562323635373134353766333237326633633937386263393532376164323333356600c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f0cc2dad0ea920000140000006b696c6e2e706f6f6c2e663836333937332e6d3037ce9c68061b12cc551a33496f858157ec5fb1e509179e69acfce58d7245aa6801000000020c00000077697468647261775f616c6c020000007b7d00c06e31d910010000000000000000000000000000000000",
  • "signature": "c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f"
}

Response samples

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

Broadcast transaction

Broadcast a transaction to the NEAR network

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

Transaction to craft

signed_tx_serialized
required
string

Signed transaction serialized

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "signed_tx_serialized": "400000006333366231613564613265363064316664356433613662343666373339396562323635373134353766333237326633633937386263393532376164323333356600c36b1a5da2e60d1fd5d3a6b46f7399eb26571457f3272f3c978bc9527ad2335f0cc2dad0ea920000140000006b696c6e2e706f6f6c2e663836333937332e6d3037ce9c68061b12cc551a33496f858157ec5fb1e509179e69acfce58d7245aa6801000000020c00000077697468647261775f616c6c020000007b7d00c06e31d910010"
}

Response samples

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

Transaction Status

Get the status of a transaction

Authorizations:
bearerAuth
query Parameters
tx_hash
required
string
Example: tx_hash=3SjLFkpdcamiF4asqkBaRStoJCVxc72ovZkEzFHMCGY5

Hash of the transaction

wallet
required
string
Example: wallet=account.testnet

NEAR account ID

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "status": "success",
    • "receipt": {
      • "final_execution_status": "FINAL",
      • "receipts_outcome": [
        • {
          • "block_hash": "GWvGFZW6yFk2wbcm1nks4BDisSANiRkD1yVQN1FQvwgo",
          • "id": "EP52R2jvvqz131WZeSjkDL2562eHHaeRABBTKunqAHbx",
          • "outcome": {
            • "executor_id": "ognuf.testnet",
            • "gas_burnt": 1047451194208,
            • "logs": [ ],
            • "metadata": {
              • "gas_profile": [
                • {
                  • "cost": "BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "2647681110"
                  },
                • {
                  • "cost": "CONTRACT_LOADING_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "35445963"
                  },
                • {
                  • "cost": "CONTRACT_LOADING_BYTES",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "9139185050"
                  },
                • {
                  • "cost": "READ_MEMORY_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "5219726400"
                  },
                • {
                  • "cost": "READ_MEMORY_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "7602666"
                  },
                • {
                  • "cost": "READ_REGISTER_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "7551495558"
                  },
                • {
                  • "cost": "READ_REGISTER_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "48689628"
                  },
                • {
                  • "cost": "STORAGE_HAS_KEY_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "54039896625"
                  },
                • {
                  • "cost": "STORAGE_HAS_KEY_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "30790845"
                  },
                • {
                  • "cost": "STORAGE_READ_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "56356845749"
                  },
                • {
                  • "cost": "STORAGE_READ_KEY_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "30952533"
                  },
                • {
                  • "cost": "STORAGE_READ_VALUE_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "72943052"
                  },
                • {
                  • "cost": "WASM_INSTRUCTION",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "2919138288"
                  },
                • {
                  • "cost": "WRITE_MEMORY_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "8411384583"
                  },
                • {
                  • "cost": "WRITE_MEMORY_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "1345543368"
                  },
                • {
                  • "cost": "WRITE_REGISTER_BASE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "8596567458"
                  },
                • {
                  • "cost": "WRITE_REGISTER_BYTE",
                  • "cost_category": "WASM_HOST_COST",
                  • "gas_used": "1877972616"
                  }
                ],
              • "version": 3
              },
            • "receipt_ids": [
              • "8RzWUcubqXZYvVTjJUTJptx7ggh5DXEMA86J6B3P5odQ"
              ],
            • "status": {
              • "SuccessValue": ""
              },
            • "tokens_burnt": "104745119420800000000"
            },
          • "proof": [
            • {
              • "direction": "Left",
              • "hash": "2jzRXjWTCVR3ZBhMg4Lg3NzG2BUXxVd5PmazKPxGi5Ri"
              },
            • {
              • "direction": "Right",
              • "hash": "8n5m2mMZso44PV696BVFyKSkC8RKqQSuF2QdjQBwKSP1"
              }
            ]
          },
        • {
          • "block_hash": "Dp3Ra6eEbWwaVueDUDxGsvU6os2RtKTmMPxbQUF1jccm",
          • "id": "8RzWUcubqXZYvVTjJUTJptx7ggh5DXEMA86J6B3P5odQ",
          • "outcome": {
            • "executor_id": "ognuf.testnet",
            • "gas_burnt": 223182562500,
            • "logs": [ ],
            • "metadata": {
              • "gas_profile": [ ],
              • "version": 3
              },
            • "receipt_ids": [ ],
            • "status": {
              • "SuccessValue": ""
              },
            • "tokens_burnt": "0"
            },
          • "proof": [
            • {
              • "direction": "Right",
              • "hash": "F6EbMPDCmbCQcETysyY64SP6wWn9PeiVXd7UvYgL41Ws"
              }
            ]
          }
        ],
      • "status": {
        • "SuccessValue": ""
        },
      • "transaction": {
        • "actions": [
          • {
            • "FunctionCall": {
              • "args": "AQEBAAAAygEAAArFAwqCAgoCCAsQ4qcDGLPbz7C3u76AGCIg7c4UiAafMSjANXcZnXF+qiYsZ8T13WsVlZb4zljSyTQqIPBf\\/7yKE9GX9+RWD9lgD58gGs1I\\/Lks9hDpOFlbflBHMiBuNAuc\\/7N6mJylROa7eAoseJAdP7M3OHaFEaMGF6+gHTogAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABCIN6zZHR5a8o1BmGlOOQHhQwNmSuCwwBl\\/Nf861pRpRwZUhSrbPuuNT\\/OdRZRpiGGh1dGWu5LelogmaPcCwS114x7FyVESiXxEtoO6Nv1n4YkGXn8bV44jJ5iDG1pbml0aWEtdGVzdBJAPp\\/i5lZVxvHHoT5uLn3J+0qYJIhP9Wvf+PnO09c8GetU1ipLI1MrDFVHkcPDQmywTTb7e+hOCBeiKlaEB5nrBxp8CjwKFKts+641P851FlGmIYaHV0Za7kt6EiIKIAQUikAhf8C3GBlyykKRuZGB8EkIICrh77u8L7e1IZfCGAESPAoUq2z7rjU\\/znUWUaYhhodXRlruS3oSIgogBBSKQCF\\/wLcYGXLKQpG5kYHwSQggKuHvu7wvt7Uhl8IYARIA",
              • "deposit": "0",
              • "gas": 20000000000000,
              • "method_name": "submit"
              }
            }
          ],
        • "hash": "3SjLFkpdymyyF4asqkBaRStoJCVxc72ovZkEzFHMCGY5",
        • "nonce": 175227951646938,
        • "priority_fee": 0,
        • "public_key": "ed25519:4m7opXRc5hEpQvUFtseFedtvN6uVKfJtzht428xxtZq1",
        • "receiver_id": "ognuf.testnet",
        • "signature": "ed25519:3TpmHAoLNMGXo69XhoP2UtZkWcet9VxKyYJ8iCyY2RdxngcimUfrgSDPrCvakLMTUdChdxwBLJv7RPV5yT9vqt3U",
        • "signer_id": "ognuf.testnet"
        },
      • "transaction_outcome": {
        • "block_hash": "GWvGFZW6yFk2wbcm1nks4BDisSANiRkD1yVQN1FQvwgo",
        • "id": "3SjLFkpdymyyF4asqkBaRStoJCVxc72ovZkEzFHMCGY5",
        • "outcome": {
          • "executor_id": "ognuf.testnet",
          • "gas_burnt": 309119332716,
          • "logs": [ ],
          • "metadata": {
            • "gas_profile": null,
            • "version": 1
            },
          • "receipt_ids": [
            • "EP52R2jvvqz131WZeSjkDL2562eHHaeRABBTKunqAHbx"
            ],
          • "status": {
            • "SuccessReceiptId": "EP52R2jvvqz131WZeSjkDL2562eHHaeRABBTKunqAHbx"
            },
          • "tokens_burnt": "30911933271600000000"
          },
        • "proof": [
          • {
            • "direction": "Right",
            • "hash": "7y9tJ8nbh3QWT2ASECNtJFx8C1M8ao2bC5JqYv5DK7fm"
            },
          • {
            • "direction": "Right",
            • "hash": "8n5m2mMZso44PV696BVFyKSkC8RKqQSuF2QdjQBwKSP1"
            }
          ]
        }
      }
    }
}

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Noble (NOBLE)

Staking facilities for the Noble protocol

Get balance

Get balance of a Noble account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "noble1p59lpw8cdu948kn3kxjwely7gm9kgxuzschy48",
  • "denom": "uusdc"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "uusdc"
    }
}

Burn USDC transaction

Generates a burn USDC transaction on Noble in order to mint the USDC on Ethereum

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

Transaction payload

pubkey
required
string

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

recipient
required
string

Wallet address on Ethereum to receive the USDC

amount_uusdc
required
string

The amount of USDC to burn

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "036d22419964c19ec91afa0e3a9c58dbb1aa1a4a30e5ad06cd47cd4e67f0671180",
  • "recipient": "0xBC86717BaD3F8CcF86d2882a6bC351C94580A994",
  • "amount_uusdc": "1000000"
}

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": "dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "adydx",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "adydx",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

OSMO IBC transfer transaction

Generates an IBC transfer transaction to transfer USDC from Noble to Osmosis

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

Transaction payload

pubkey
required
string

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

recipient
required
string

Osmosis address to receive the USDC

amount_uusdc
required
string

The amount of USDC to send

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "036d22419964c19ec91afa0e3a9c58dbb1aa1a4a30e5ad06cd47cd4e67f0671180",
  • "recipient": "osmo1p59lpw8cdu948kn3kxjwely7gm9kgxuzschy48",
  • "amount_uusdc": "1000000"
}

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": "dydx1djqecw6nn5tydxq0shan7srv8j65clsf7vypl6",
        • "validatorAddress": "dydxvaloper1djqecw6nn5tydxq0shan7srv8j65clsfmnxcfu",
        • "amount": {
          • "denom": "adydx",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "adydx",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Osmosis (OSMO)

Staking facilities for the OSMO protocol

Stakes

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

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

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

delegators
Array of strings
Example: delegators=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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

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

Comma-separated list of Kiln accounts identifiers

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
      • "delegator_address": "osmo1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "osmovaloper1xyz",
            • "osmovaloper1abc"
            ],
          • "deny_list": [
            • "osmovaloper1xyz",
            • "osmovaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link an OSMO stake to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of OSMO stakes. Units are in uOSMO (10⁻⁶ OSMO).

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

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

delegators
Array of strings
Example: delegators=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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 OSMO stakes. Units are in uOSMO (10⁻⁶ OSMO).

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

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

delegators
Array of strings
Example: delegators=osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

Responses

Response samples

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

Network Stats

Get some network statistics on Cosmos

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Cosmos staking

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

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

validators
Array of strings
Example: validators=osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy

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

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

Comma-separated list of Kiln accounts identifiers

Responses

Stake Transaction

Generates a delegate transaction on Osmosis

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

pubkey
required
string

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

validator
required
string

Validator address

amount_uosmo
required
string

Amount to stake in uosmo

restake_rewards
boolean
Default: false

If enabled, the rewards will be automatically restaked

grantee_address
string

Responses

Request samples

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

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": "osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3",
        • "validatorAddress": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
        • "amount": {
          • "denom": "uosmo",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uosmo",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on Osmosis

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

Responses

Request samples

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

Response samples

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

Restake Rewards Transaction

Generates a restake rewards transaction on Osmosis

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

Transaction to craft

pubkey
required
string

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

validator_address
required
string

Validator address

grantee_address
required
string

Responses

Request samples

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

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": "osmo1lnc548nmxqukrvd9czw4tq5vn6kapndg2hzhr3",
        • "validatorAddress": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
        • "amount": {
          • "denom": "uosmo",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "uosmo",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on Osmosis

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

Transaction to craft

pubkey
required
string

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

validator
required
string

Validator address

amount_uosmo
string

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

Responses

Request samples

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

Response samples

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

Redelegate Transaction

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

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to which the new stake will be linked

pubkey
required
string

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

validator_source
required
string

Validator source address of current stake

validator_destination
required
string

Validator destination address to which redelegate the stake

amount_uosmo
string

Amount to redelegate in uOSMO

Responses

Request samples

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

Response samples

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

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Polkadot (DOT)

Staking facilities for the Polkadot protocol

Stakes

Get the status of Polkadot stakes

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "address": "1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J",
      • "pool_id": 118,
      • "active_balance": "30004690613",
      • "unbonding_balance": "30004690613",
      • "withdrawable_balance": "30004690613",
      • "net_rewards": "37201548",
      • "gross_rewards": "37201548",
      • "withdrawable_rewards": "37201548",
      • "state": "active",
      • "net_apy": 0.188014,
      • "delegated_at": "2023-01-06T22:00:00Z",
      • "updated_at": "2023-01-14T01:13:59Z",
      • "undelegated_at": "2023-01-06T22:00:00Z"
      }
    ]
}

Rewards

Get historical rewards by day or era of DOT stakes

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

validators
string
Example: validators=1497QNdycmxqMi3VJDxZDhaJh4s9tytr5RFWyrLcNse2xqPD

Comma separated list of validators addresses

pool_ids
integer
Example: pool_ids=118

Comma separated list of pool ids. If used with 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

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)

format
string
Enum: "daily" "era"

The format of the response. Defaults to daily

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "net_rewards": "27098488",
      • "gross_rewards": "27098488",
      • "active_balance": "420000000000",
      • "net_apy": 3.42,
      • "gross_apy": 3.42
      },
    • {
      • "date": "2023-01-16",
      • "net_rewards": "27099488",
      • "gross_rewards": "0",
      • "active_balance": "420027098488",
      • "net_apy": 3.4,
      • "gross_apy": 0
      }
    ]
}

Operations

Get the operations of Polkadot stakes

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "staking.bonded",
      • "block_number": 15828207,
      • "block_time": "2023-06-22T15:35:01.892644Z",
      • "tx_hash": "0xf476bc1b633528a2cfbb1c959755318bed1c6825d7bb6b89d7ffc1026066f17c",
      • "extrinsic_seq_id": 4,
      • "event_seq_id": 42,
      • "amount": "3000000",
      • "address": "13UVJyLnbVp8c4FQeiGL1CZxAHdBYCemjgkAyN8AcRcDJtNr",
      • "validator": "1497QNdycmxqMi3VJDxZDhaJh4s9tytr5RFWyrLcNse2xqPD",
      • "pool_id": "118",
      • "earned_era": "1403",
      • "era": "1404"
      }
    ]
}

Reports

Get reports on Polkadot staking

Authorizations:
bearerAuth
query Parameters
addresses
string
Example: addresses=1nXBtBPt3PV35m7Dfgp32xXgrC9tm1Pw7Hk7MDuGAejvB7J

Comma separated list of stake addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

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,
    • "nb_validators": 100,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 12.4,
    • "inflation_rate": 3.5,
    • "updated_at": "2023-01-14T01:13:59Z"
    }
}

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

Polygon (MATIC)

Deprecated endpoints that will be removed in a future version. Please use POL endpoints instead. Staking facilities for the Polygon protocol.

Stakes Deprecated

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

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

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "delegator_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "validator_index": "1",
      • "state": "active",
      • "delegated_block": 6307582,
      • "delegated_at": "2022-02-02T08:31:07Z",
      • "balance": "11364372934211323407387",
      • "shares": "126664878892234995894",
      • "unbounded_balance": "11364372934211323407387",
      • "unbounded_epoch": 8,
      • "is_unbounding_complete": true,
      • "rewards": "689020902235393456944",
      • "net_apy": 4.066307880973232,
      • "available_rewards": "659936623311645699",
      • "updated_at": "2023-07-31T13:56:58Z",
      • "unbounds_with_id": [
        • {
          • "nonce": 1,
          • "balance": "11364372934211323407387",
          • "epoch": 8,
          • "is_complete": true
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link MATIC stakes to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards Deprecated

Get historical rewards by day of Polygon stakes. All stakes made prior to the Ethereum block n°16430248 (18/01/2023) aren't fully sync-ed and will have lower than expected rewards.

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

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

Responses

Response samples

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

Operations Deprecated

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

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

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

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

Network Stats Deprecated

Get some network statistics on Polygon staking

Authorizations:
bearerAuth

Responses

Response samples

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

Reports Deprecated

Get reports on Polygon staking

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

Comma-separated list of validators' indexes

wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Approve Transaction Deprecated

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

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

Transaction to craft

wallet
required
string

Wallet address to approve

contract
required
string

Contract address that needs approval

amount_wei
string

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

Responses

Request samples

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

Response samples

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

Buy Voucher Transaction Deprecated

Generates a buy voucher transaction to buy shares from a validator. Please note that you can only buy shares from a validator if you don't have some unstaked POL that are pending for withdrawal.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet address

amount_wei
required
string

Amount of MATIC to stake in WEI

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Sell Voucher Transaction Deprecated

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

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

Transaction to craft

wallet
required
string

Wallet address

amount_wei
required
string

Amount of MATIC to sell in WEI

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Unstake Claim Tokens Transaction Deprecated

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

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

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Withdraw Rewards Transaction Deprecated

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

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

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Restake Rewards Transaction Deprecated

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

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

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Prepare Transaction Deprecated

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

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

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

r
required
string

r part of the ECDSA signature in hex

s
required
string

s part of the ECDSA signature in hex

v
required
number

v part of the ECDSA signature (0 or 1)

Responses

Request samples

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

Response samples

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

Broadcast Transaction Deprecated

Broadcasts a signed transaction to the Ethereum network

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

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

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

Response samples

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

Transaction Status Deprecated

Get the status of a transaction on the Ethereum network

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

Hash of the transaction

Responses

Response samples

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

Transaction Decoding Deprecated

Decode a transaction of the Ethereum network

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

Raw transaction to decode

Responses

Response samples

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

Polygon (POL)

Staking facilities for the Polygon protocol

Stakes

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

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

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "delegator_address": "0xe1f4acc0affB36a805474e3b6ab786738C6900A2",
      • "validator_index": "1",
      • "state": "active",
      • "delegated_block": 6307582,
      • "delegated_at": "2022-02-02T08:31:07Z",
      • "balance": "11364372934211323407387",
      • "shares": "126664878892234995894",
      • "unbounded_balance": "11364372934211323407387",
      • "unbounded_epoch": 8,
      • "is_unbounding_complete": true,
      • "rewards": "689020902235393456944",
      • "net_apy": 4.066307880973232,
      • "available_rewards": "659936623311645699",
      • "updated_at": "2023-07-31T13:56:58Z",
      • "unbounds_with_id": [
        • {
          • "nonce": 1,
          • "balance": "11364372934211323407387",
          • "epoch": 8,
          • "is_complete": true
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link POL stakes to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of Polygon stakes. All stakes made prior to the Ethereum block n°16430248 (18/01/2023) aren't fully sync-ed and will have lower than expected rewards.

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

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

Responses

Response samples

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

Operations

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

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

Comma-separated list of wallets addresses

validator_indexes
Array of integers[ items >= 1 ]

Comma-separated list of validators' indexes

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

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

Network Stats

Get some network statistics on Polygon staking

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Polygon staking

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

Comma-separated list of validators' indexes

wallets
Array of strings
Example: wallets=0xe1f4acc0affB36a805474e3b6ab786738C6900A2

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Approve Transaction

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

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

Transaction to craft

wallet
required
string

Wallet address to approve

contract
required
string

Contract address that needs approval

amount_wei
string

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

Responses

Request samples

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

Response samples

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

Buy Voucher Transaction

Generates a buy voucher transaction to buy shares from a validator. Please note that you can only buy shares from a validator if you don't have some unstaked POL that are pending for withdrawal.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet address

amount_wei
required
string

Amount of POL to stake in WEI

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Sell Voucher Transaction

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

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

Transaction to craft

wallet
required
string

Wallet address

amount_wei
required
string

Amount of POL to sell in WEI

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Unstake Claim Tokens Transaction

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

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

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Withdraw Rewards Transaction

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

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

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Restake Rewards Transaction

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

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

Transaction to craft

wallet
required
string

Wallet address

validator_share_proxy_address
required
string

Contract address of the validator share proxy contract

Responses

Request samples

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

Response samples

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

Prepare Transaction

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

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

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

r
required
string

r part of the ECDSA signature in hex

s
required
string

s part of the ECDSA signature in hex

v
required
number

v part of the ECDSA signature (0 or 1)

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcasts a signed transaction to the Ethereum network

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

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

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

Response samples

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

Transaction Status

Get the status of a transaction on the Ethereum network

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

Hash of the transaction

Responses

Response samples

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

Transaction Decoding

Decode a transaction of the Ethereum network

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

Raw transaction to decode

Responses

Response samples

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

Solana (SOL)

Staking facilities for the Solana protocol

Stakes

Get the status of Solana stakes

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

Comma-separated list of stake addresses

validators
Array of strings
Example: validators=6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78

Comma-separated list of validator addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

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

Create stakes Deprecated

Create Solana stakes and linked them to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards of Solana stakes

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

Comma-separated list of stake addresses

validators
Array of strings
Example: validators=6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78

Comma-separated list of validator addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

format
string
Enum: "daily" "epoch"

The format of the response. Defaults to daily

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

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

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

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

start_epoch
number
Example: start_epoch=542

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

end_epoch
number
Example: end_epoch=542

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

include_usd
boolean
Example: include_usd=1

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "3575891083876864200000",
      • "active_balance": "6300000000000000000000000",
      • "gross_mev_rewards": "11542454895",
      • "mev_commission": "869533",
      • "net_apy": 3.42,
      • "mev_gross_apy": 1.22
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "3575891083876864200000",
      • "gross_mev_rewards": "11642454895",
      • "mev_commission": "869533",
      • "active_balance": "6300000000000000000000000",
      • "net_apy": 3.4,
      • "mev_gross_apy": 2.6
      }
    ]
}

Operations

Get the operations of Solana stakes

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

Comma-separated list of stake addresses

validators
Array of strings
Example: validators=6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78

Comma-separated list of validator addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

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

Network Stats

Get some network statistics on Solana staking

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Solana staking

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

Comma-separated list of stake addresses

wallets
Array of strings
Example: wallets=EHrKMrVsNNqBjYuKbuzf5rJZcu89dg5cwdRduMdSE557

Comma-separated list of wallets addresses

validators
Array of strings
Example: validators=6hNweZvzTudTuprZrAXb1A9grKvVG6xgjyvdJUqAMk78

Comma-separated list of validator addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Nonce Account

Get Kiln nonce account details. This can be used to partially sign transactions with a durable nonce.

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "nonce_account": "3M7sFDMdUxfNNSmKk2ZmDKgKJFzuLvxpuXKDTLRGXpcK",
    • "nonce_account_authority": "6WwYZH8zdqF7kELtRfo1yAnvD1wvXwTg4m1jBhUCqC68"
    }
}

Stake Transaction

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

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

Stake transaction to create

account_id
required
string

Kiln Account ID

wallet
required
string

Wallet address

amount_lamports
required
string

Amount in lamports (minimum value must be 10000001)

vote_account_address
required
string

Vote account address

memo
string

Custom message to send as a memo in the transaction

Responses

Request samples

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

Response samples

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

Deactivate Stake Transaction

Craft a deactivate stake account transaction.

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

Stake to deactivate

stake_account
required
string

Stake account address

wallet
required
string

Wallet address

Responses

Request samples

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

Response samples

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

Withdraw Stake Transaction

Craft a withdraw stake transaction.

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

Stake to withdraw

stake_account
required
string

Stake account address

wallet
required
string

Wallet address

amount_lamports
string

Amount in lamports

Responses

Request samples

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

Response samples

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

Merge Stakes Transaction

Craft a merge stakes transaction.

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

Stakes to merge

stake_account_source
required
string

Stake account address

stake_account_destination
required
string

Stake account address

wallet
required
string

Wallet address

Responses

Request samples

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

Response samples

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

Split Stake Transaction

Craft a solana split stake transaction

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

Stake to split

account_id
required
string

Kiln Account ID

stake_account
required
string

Stake account address

wallet
required
string

Wallet address

amount_lamports
required
string

Amount in lamports

Responses

Request samples

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

Response samples

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

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

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

Transaction to sign

unsigned_tx_serialized
required
string

Hex encoded unsigned transaction

signatures
required
Array of strings

Hex encoded signatures

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcast a serialized signed transaction to the blockchain

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

Signed transaction to broadcast

tx_serialized
required
string

Hex encoded signed transaction

Responses

Request samples

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

Response samples

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

Transaction Status

Get the status of a transaction

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

Hash of the transaction

Responses

Response samples

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

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

Tezos (XTZ)

Staking facilities for the Tezos protocol

Stakes

Get the status of Tezos stakes

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez

Comma-separated list of baker addresses

Responses

Response samples

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

Rewards

Get historical rewards of Tezos stakes

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez

Comma-separated list of baker addresses

format
string
Enum: "daily" "cycle"

The format of the response. Defaults to daily

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

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

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

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

start_cycle
number
Example: start_cycle=542

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

end_cycle
number
Example: end_cycle=542

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

include_usd
boolean
Example: include_usd=1

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "date": "2023-01-15",
      • "rewards": "27098488",
      • "active_balance": "420000000000",
      • "staked_rewards": "1278500",
      • "staked_balance": "1500000000",
      • "net_apy": 3.42,
      • "rewards_usd": "12",
      • "stake_balance_usd": "25400"
      },
    • {
      • "date": "2023-01-16",
      • "rewards": "27098498",
      • "active_balance": "420000000000",
      • "staked_rewards": "1347910",
      • "staked_balance": "1501278500",
      • "net_apy": 3.4,
      • "rewards_usd": "13",
      • "stake_balance_usd": "25412"
      }
    ]
}

Operations

Get historical operations of Tezos stakes

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

validators
Array of strings
Example: validators=tz3btDQsDkqq2G7eBdrrLqetaAfLVw6BnPez

Comma-separated list of baker addresses

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

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

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

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

Responses

Response samples

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

Network Stats

Get some network statistics on Tezos staking

Authorizations:
bearerAuth

Responses

Response samples

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

Excel Reports

Generates an Excel report sheet for your stakes and rewards

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

Comma-separated list of wallets addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Delegate Transaction

Generates a delegate transaction on Tezos

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID to stake into

wallet
required
string

Wallet signing the transaction

baker_address
required
string

Baker address to delegate to

Responses

Request samples

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

Response samples

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

Undelegate Transaction

Generates an undelegate transaction on Tezos

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

Transaction to craft

wallet
required
string

Wallet signing the transaction

Responses

Request samples

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

Response samples

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

Stake Transaction

Generates a stake transaction on Tezos. You must delegate to a baker accepting external stakes prior to use this endpoint. Staked tezos remain in your wallet but are frozen for staking purposes and subject to slashing.

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 signing the transaction

amount_mutez
required
string

Amount to stake in mutez (1 XTZ = 1000000 mutez)

Responses

Request samples

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

Response samples

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

Unstake Transaction

Generates an unstake transaction on Tezos. Your unstaked balance remains locked for 4 cycles. After this period, you can unlock your funds by calling /v1/xtz/transaction/finalize-unstake.

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

Transaction to craft

wallet
required
string

Wallet signing the transaction

amount_mutez
required
string

Amount to stake in mutez (1 XTZ = 1000000 mutez)

Responses

Request samples

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

Response samples

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

Finalize Unstake Transaction

Generates a finalize unstake transaction on Tezos. This transaction unlocks your unstaked tezos after the 4 cycles lock period.

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

Transaction to craft

wallet
required
string

Wallet signing the transaction

Responses

Request samples

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

Response samples

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

Prepare Transaction

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

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

Transaction to prepare

unsigned_tx_serialized
required
string

Unsigned serialized transaction

signature
required
string

Transaction signature in hex

Responses

Request samples

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

Response samples

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

Broadcast Transaction

Broadcasts a signed Tezos transaction

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

Transaction to broadcast

tx_serialized
required
string

Signed serialized transaction

Responses

Request samples

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

Response samples

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

Transaction Status

Get the status of a Tezos transaction

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

Hash of the transaction

block_number
required
string
Example: block_number=2344324

Block number in which the transaction was included

Responses

Response samples

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

Transaction Decoding

Decode a Tezos transaction

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

Raw transaction to decode

Responses

Response samples

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

The Open Network (TON)

Staking facilities for the The Open Network protocol

Stakes

Get the status of TON stakes

Authorizations:
bearerAuth
query Parameters
nominators
Array of strings
Example: nominators=UQB0DfNVIGQTu0Ir2BevL81KyNTh0wKJTXQzciumAwzhDoOq

Comma-separated list of nominator addresses

pools
Array of strings
Example: pools=Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa

Comma-separated list of pool addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "id": "Ef-2Cee_wxtgo9OKdbjXjauQJ15yxuyMTNpQxJbJ2FTZ2RJY|Uf_Jm1_syLkND8FqagYAtYljbWzutxz2u9AxZS9x59OxHKkF",
      • "pool": "Ef-2Cee_wxtgo9OKdbjXjauQJ15yxuyMTNpQxJbJ2FTZ2RJY",
      • "nominator": "Uf_Jm1_syLkND8FqagYAtYljbWzutxz2u9AxZS9x59OxHKkF",
      • "balance": "92908788559",
      • "elector_balance": "1221263396940000",
      • "total_balance": "1221356305728559",
      • "withdraw_requested": false,
      • "pending_deposit_amount": "0",
      • "pool_type": "single_nominator_pool_v1",
      • "rewards": "9020446847418",
      • "net_apy": 6.02,
      • "kiln_requested_withdraw": {
        • "amount": "1002001960122254",
        • "is_withdrawable": true
        },
      • "withdraw_balance": "100012345678",
      • "withdraw_pending_balance": "100087654321"
      }
    ]
}

Create stakes Deprecated

Link an TON 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": "kf_bOKif9YRKIGTRZw_6ZTZsObUug4J3EZ68BQ7t7E7zAORr|EQBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYQlR"
      }
    ],
  • "account_id": "92f5bfd4-ea38-4824-84f7-686eddff5539"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of TON stakes. Units are in nanoton (10⁻⁹ TON).

Authorizations:
bearerAuth
query Parameters
nominators
Array of strings
Example: nominators=UQB0DfNVIGQTu0Ir2BevL81KyNTh0wKJTXQzciumAwzhDoOq

Comma-separated list of nominator addresses

pools
Array of strings
Example: pools=Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa

Comma-separated list of pool addresses

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

Comma-separated list of Kiln accounts identifiers

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

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

format
string
Enum: "daily" "epoch"

The format of the response. Defaults to daily

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": "2024-05-17",
      • "effective_balance": "10001198470000",
      • "rewards": "28936464584",
      • "net_apy": 6.02,
      • "rewards_usd": 2344.36,
      • "effective_balance_usd": 4407596.22
      }
    ]
}

Operations

Get the operations of TON stakes

Authorizations:
bearerAuth
query Parameters
nominators
Array of strings
Example: nominators=UQB0DfNVIGQTu0Ir2BevL81KyNTh0wKJTXQzciumAwzhDoOq

Comma-separated list of nominator addresses

pools
Array of strings
Example: pools=Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa

Comma-separated list of pool addresses

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "type": "stake",
      • "data": {
        • "Text": "d"
        },
      • "value": "1000000000000000",
      • "source": "UQAfjn5-4M5H7q_2z4rCjAIGDslZoT0VsZNWaQ9BIaR4w0V9",
      • "destination": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
      • "pool": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
      • "direction": "out",
      • "fwd_fees": "1000000000000000",
      • "ihr_fees": "1000000000000000",
      • "hash": "1000000000000000",
      • "tx_hash": "1000000000000000",
      • "tx_status": "success",
      • "tx_timestamp": "2023-01-15T01:13:59Z",
      • "tx_block": "1000000000000000",
      • "tx_total_fees": "1000000000000000",
      • "tx_storage_fees": "100000000",
      • "tx_gas_fees": "1000000000000000",
      • "tx_fwd_fees": "1000000000000000"
      }
    ]
}

Network Stats

Get some network statistics on The Open Network

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on The Open Network

Authorizations:
bearerAuth
query Parameters
nominators
Array of strings
Example: nominators=UQB0DfNVIGQTu0Ir2BevL81KyNTh0wKJTXQzciumAwzhDoOq

Comma-separated list of nominator addresses

pools
Array of strings
Example: pools=Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa

Comma-separated list of pool addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Wallet info

Get the status of a TON wallet

Authorizations:
bearerAuth
query Parameters
wallet
required
string
Example: wallet=UQAfjn5-4M5H7q_2z4rCjAIGDslZoT0VsZNWaQ9BIaR4w0V9

Wallet address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "wallet": true,
    • "balance": "1000000",
    • "account_state": "active",
    • "last_transaction_id": {
      • "@type": "internal.transactionId",
      • "lt": "54784142000001",
      • "hash": "LO4ZcnQf4CGvlI9f9pqR9sAhf5fXGbJbTHXvpxBnArY="
      },
    • "wallet_type": "wallet v4 r2",
    • "seqno": 82,
    • "wallet_id": 698983191
    }
}

Vesting contract owner

Get the owner address of a TON vesting contract

Authorizations:
bearerAuth
query Parameters
vesting_contract_address
required
string
Example: vesting_contract_address=UQAls41jj74A0zhWmWBxmffrbrsOsjhS4TARUQ5DqoZ1uV8y

Vesting contract address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "address": "EQAfjn5-4M5H7q_2z4rCjAIGDslZoT0VsZNWaQ9BIaR4wxi4"
    }
}

Single nominator contract owner

Get the owner address of a TON single nominator contract

Authorizations:
bearerAuth
query Parameters
single_nominator_contract_address
required
string
Example: single_nominator_contract_address=Ef8Fl22VmKm2kDqIWnPf3iNhCUz0cZkedMkZBNZ2D0jDxH9p

Single nominator contract address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "address": "EQAfjn5-4M5H7q_2z4rCjAIGDslZoT0VsZNWaQ9BIaR4wxi4"
    }
}

Get balance

Get balance of a TON account

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

Account to query

address
required
string

Wallet address

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "UQAfjn5-4M5H7q_2z4rCjAIGDslZoT0VsZNWaQ9BIaR4w0V9"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "nanoton"
    }
}

Withdraw request

Get withdraw request for a pool

Authorizations:
bearerAuth
query Parameters
pool
required
string
Example: pool=Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa

Pool address

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "pool": "Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa",
    • "amount": "1002001960122254",
    • "created_at": "2023-01-15T01:13:59Z",
    • "withdrawable_at": "2023-01-15T01:13:59Z",
    • "tx_hash": "XGU4jMF6JGhcqvpdXJ+w7XhnFM6fhrRpidnLp7CuGV0=",
    • "status": "requested"
    }
}

Withdraw request

Create withdraw request for a pool

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

Withdraw request to create

pool
required
string

Pool address where this withdraw request is for

amount_nanoton
required
string

The amount of TON to withdraw in nanoton

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pool": "kf_bOKif9YRKIGTRZw_6ZTZsObUug4J3EZ68BQ7t7E7zAORr",
  • "amount_nanoton": "1000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "pool": "Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa",
    • "amount": "1002001960122254",
    • "created_at": "2023-01-15T01:13:59Z",
    • "withdrawable_at": "2023-01-15T01:13:59Z",
    • "tx_hash": "XGU4jMF6JGhcqvpdXJ+w7XhnFM6fhrRpidnLp7CuGV0=",
    • "status": "requested"
    }
}

Withdraw request

Delete withdraw request for a pool

Authorizations:
bearerAuth
query Parameters
pool
required
string
Example: pool=Ef_zhiLfydITUXevx3NOkBKyjczc565UvqwkWp07os7EwZMa

Pool address

tx_hash
string
Example: tx_hash=SQ5y4jeRZzU4h/lbyWiLhTrR9A3smK5Vmm/1p9ylDFo=

Transaction hash

Responses

Prepare Transaction

Prepare an unsigned transaction for broadcast by adding signatures to it

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

Transaction to sign

unsigned_tx_serialized
required
string

Hex encoded unsigned transaction

signature
string

Hex encoded signature

from
string

Address of the signer

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "unsigned_tx_serialized": "b5ee9c72c1010201004a000011011c29a9a317667c507500000000000301006e627fbdbe5ba683f903a336f8b6ae670f51439b4507823c21a90c447e332094964ff8b838d7ea4c68000000000000000000000000000000586c223e",
  • "signature": "58375aa7640d8f1f9023e30c156d58b1e07e76832814549b6067c03139f057c4b31ee4356fd5785693bbd163004a92fccf53c80c4f720e1cfcce05ba64603709",
  • "from": "UQBzQbAszir_fMErkktI7_8Xl2FkhlDUKE4iUGc9V66OMpp1"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "signed_tx_serialized": "te6cckEBAgEArQAB4YgA5oNgWZxV/vmCVySWkd/+Ly7CyQyhqFCcRKDOeq9dHGQCwbrVOyBsePyBHxhgq2rFjwPztBlAoqTbAz4Bic+CviWY9yGrfqvCtJ3eixgCVJfmep5AYnuQcOfmcC3TIwG4SU1NGLsz4oOoAAAAAAAcAQBuYn+9vlumg/kDozb4tq5nD1FDm0UHgjwhqQxEfjMglJZP+Lg41+pMaAAAAAAAAAAAAAAAAAAAAKKEVgs="
    }
}

Broadcast Transaction

Broadcast a serialized signed transaction to the blockchain

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

Signed transaction to broadcast

tx_serialized
required
string

Hex encoded signed transaction

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "tx_serialized": "te6cckEBAgEArQAB4YgA5oNgWZxV/vmCVySWkd/+Ly7CyQyhqFCcRKDOeq9dHGQCwbrVOyBsePyBHxhgq2rFjwPztBlAoqTbAz4Bic+CviWY9yGrfqvCtJ3eixgCVJfmep5AYnuQcOfmcC3TIwG4SU1NGLsz4oOoAAAAAAAcAQBuYn+9vlumg/kDozb4tq5nD1FDm0UHgjwhqQxEfjMglJZP+Lg41+pMaAAAAAAAAAAAAAAAAAAAAKKEVgs="
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "tx_hash": "SQ5y4jeRZzU4h/lbyWiLhTrR9A3smK5Vmm/1p9ylDFo="
    }
}

Transaction Status

Get the status of a transaction by message hash

Authorizations:
bearerAuth
query Parameters
msg_hash
required
string
Example: msg_hash=SQ5y4jeRZzU4h/lbyWiLhTrR9A3smK5Vmm/1p9ylDFo=

Hash of the message

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "transactions": [
      • {
        • "account": "0:50251F4800B322F242D628AA28DB4035FA2F6D2C1D45D994C8232A691C63C561",
        • "hash": "B2FiWHWiKXq3wFeyrz3heGnk6paG37zc4eHymCzHVv0=",
        • "lt": "23434414000001",
        • "now": 1720454314,
        • "orig_status": "active",
        • "end_status": "active",
        • "total_fees": "5553039",
        • "prev_trans_hash": "0YwyJ6rnmD6GSHjCwbSqYRRRZR4Je3ajRSVOmQKTBDM=",
        • "prev_trans_lt": "22972195000001",
        • "description": {
          • "type": "ord",
          • "action": {
            • "valid": true,
            • "success": true,
            • "no_funds": false,
            • "result_code": 0,
            • "tot_actions": 1,
            • "msgs_created": 1,
            • "spec_actions": 0,
            • "tot_msg_size": {
              • "bits": "705",
              • "cells": "1"
              },
            • "status_change": "unchanged",
            • "total_fwd_fees": "10000000",
            • "skipped_actions": 0,
            • "action_list_hash": "+TCFxMn1MktBa4iGZ8y01pEMygRnmYGEMofeFHiIuxY=",
            • "total_action_fees": "3333282"
            },
          • "aborted": false,
          • "credit_ph": {
            • "credit": "140268068471039"
            },
          • "destroyed": false,
          • "compute_ph": {
            • "mode": 0,
            • "type": "vm",
            • "success": true,
            • "gas_fees": "1323200",
            • "gas_used": "3308",
            • "vm_steps": 68,
            • "exit_code": 0,
            • "gas_limit": "0",
            • "gas_credit": "10000",
            • "msg_state_used": false,
            • "account_activated": false,
            • "vm_init_state_hash": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
            • "vm_final_state_hash": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
            },
          • "storage_ph": {
            • "status_change": "unchanged",
            • "storage_fees_collected": "290157"
            },
          • "credit_first": true
          },
        • "block_ref": {
          • "workchain": 0,
          • "shard": "6000000000000000",
          • "seqno": 22378256
          },
        • "in_msg": {
          • "hash": "kndVN02mdubtxmhkkjz60OwyD6g0aUwThWSjqeqxC3Y=",
          • "source": null,
          • "destination": "0:50251F4800B322F242D628AA28DB4035FA2F6D2C1D45D994C8232A691C63C561",
          • "value": null,
          • "fwd_fee": null,
          • "ihr_fee": null,
          • "created_lt": null,
          • "created_at": null,
          • "opcode": "0x4b958d56",
          • "ihr_disabled": null,
          • "bounce": null,
          • "bounced": null,
          • "import_fee": "0",
          • "message_content": {
            • "hash": "xvKE5GreYe2GUpcVdyGql8Zl04TGBSH1v5CmSJXneI4=",
            • "body": "te6cckEBAgEAhwABnEuVjVbI54rXHHGaszAM0rq344hhUNJLET1sYmiqiKqFtDbL1WzGLMTzRRha4nVO5alpP1cX3E5P4Dls3fIO8gMpqaMXZowasQAAAD0AAwEAaGJ/7ZxUT/rCJRAyaLOH/TKbNhzal0HBO4jPXgKHdvYneYAh3NZQAAAAAAAAAAAAAAAAAADeRiM9",
            • "decoded": null
            },
          • "init_state": null
          },
        • "out_msgs": [
          • {
            • "hash": "1U8v7l9QJDW/CMNa05LL6UzdBrSBRNLm7LmkvRnTyzQ=",
            • "source": "0:50251F4800B322F242D628AA28DB4035FA2F6D2C1D45D994C8232A691C63C561",
            • "destination": "-1:DB38A89FF5844A2064D1670FFA65366C39B52E838277119EBC050EEDEC4EF300",
            • "value": "1000000000",
            • "fwd_fee": "6666718",
            • "ihr_fee": "0",
            • "created_lt": "23434414000002",
            • "created_at": "1720454314",
            • "opcode": null,
            • "ihr_disabled": true,
            • "bounce": true,
            • "bounced": false,
            • "import_fee": null,
            • "message_content": {
              • "hash": "lqKW0iTyhcZ77pPDD4owkVfw2qNdxbh+QQt4YwoJz8c=",
              • "body": "te6cckEBAQEAAgAAAEysuc0=",
              • "decoded": null
              },
            • "init_state": null
            }
          ],
        • "account_state_before": {
          • "hash": "Kcz+vnm2nmbO4pb0wSyo264F8/3WnFdVYaWNhNR5Cus=",
          • "balance": "164023287343",
          • "account_status": "active",
          • "frozen_hash": null,
          • "code_hash": "/rX/aCDi/w2Ug+fg1iyBfYRniftK5YDIeIZtlZ2r1cA=",
          • "data_hash": "9R2bD8OcpgFI8z7PHJaN5vXUJr7HQ06nKX3pTN9Bg6o="
          },
        • "account_state_after": {
          • "hash": "IsFANgt7iHcwOtk3TPC67SOV+MNCq0w4f6oLpuk9Im8=",
          • "balance": "163011067586",
          • "account_status": "active",
          • "frozen_hash": null,
          • "code_hash": "/rX/aCDi/w2Ug+fg1iyBfYRniftK5YDIeIZtlZ2r1cA=",
          • "data_hash": "LL9jzy6YehhW15AcV9JHjL4+VE0pnr/eN+WSqjoF4dA="
          },
        • "mc_block_seqno": 20853046
        }
      ],
    • "address_book": {
      • "0:50251F4800B322F242D628AA28DB4035FA2F6D2C1D45D994C8232A691C63C561": {
        • "user_friendly": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e"
        },
      • "-1:DB38A89FF5844A2064D1670FFA65366C39B52E838277119EBC050EEDEC4EF300": {
        • "user_friendly": "kf_bOKif9YRKIGTRZw_6ZTZsObUug4J3EZ68BQ7t7E7zAORr"
        }
      }
    }
}

Transaction Decoding

Decode a serialized transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
[
  • {
    • "body": {
      • "wallet_id": "698983191",
      • "expiration_timestamp": "1742240830",
      • "seqno": "17",
      • "op": "0",
      • "store_mode": "3"
      },
    • "message": {
      • "header": {
        • "ihrDisabled": true,
        • "bounce": true,
        • "bounced": false,
        • "src": null,
        • "dest": {
          • "hex": "0:bf2ddbf694680487e7a1eac99ce049d13efe731e0e2e988eac2430c2d7d68558",
          • "bouncable": "kQC_Ldv2lGgEh-eh6smc4EnRPv5zHg4umI6sJDDC19aFWLBi",
          • "nonBouncable": "0QC_Ldv2lGgEh-eh6smc4EnRPv5zHg4umI6sJDDC19aFWO2n"
          },
        • "grams": "200000000",
        • "currencyCollection": false,
        • "ihrFees": "0",
        • "fwdFees": "0",
        • "createdLt": "0",
        • "createdAt": "0"
        },
      • "stateInit": null,
      • "body": {
        • "op_code_name": "vesting_contract_send",
        • "op_code": 2809346765,
        • "params": {
          • "query_id": "0",
          • "send_mode": "3",
          • "out_msg": {
            • "header": {
              • "ihrDisabled": true,
              • "bounce": true,
              • "bounced": false,
              • "src": null,
              • "dest": {
                • "hex": "0:06b1c65f70e64ec0d5ee0b6719b3866a892e46c9f9b17b9ada6b0064edfc1cda",
                • "bouncable": "kQAGscZfcOZOwNXuC2cZs4ZqiS5Gyfmxe5raawBk7fwc2lhh",
                • "nonBouncable": "0QAGscZfcOZOwNXuC2cZs4ZqiS5Gyfmxe5raawBk7fwc2gWk"
                },
              • "grams": "200000000",
              • "currencyCollection": false,
              • "ihrFees": "0",
              • "fwdFees": "0",
              • "createdLt": "0",
              • "createdAt": "0"
              },
            • "stateInit": null,
            • "body": {
              • "op_code_name": "Withdraw"
              }
            }
          }
        }
      }
    }
]

Stake single nomination pool transaction

Craft a stake transaction to a single nomination pool.

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

Stake transaction to create

account_id
required
string

Kiln Account ID

wallet
required
string

Wallet address

amount_nanoton
required
string

Amount in nanoton. Minimum is 12000000000 nanoton (1.2 TON)

pool_address
required
string

Pool address

vesting_contract_address
string

Vesting contract address (optional), to be used when staking from a vesting contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "d3f1b917-72b1-4982-a4dd-93fce579a708",
  • "wallet": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
  • "amount_nanoton": "1000000000000000",
  • "pool_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
  • "vesting_contract_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "5b451f530950de0cb371a91edf16f36a5180e31162faccc7f10db8ccf027023a",
    • "unsigned_tx_serialized": "b5ee9c72c10102010046000011011c29a9a317668d4f0a0000003e0003010066627fed9c544ffac225103268b387fd329b361cda9741c13b88cf5e028776f6277980187a1200000000000000000000000000002537dddb",
    • "from": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
    • "to": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
    • "amount": "1000000000000000",
    • "payload": "te6ccsEBAQEADAAMABQAAAAASGVsbG8hCaTc/g==",
    • "valid_until": 1738689966
    }
}

Stake TON whales pool transaction

Craft a stake transaction to TON whales pool.

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

Stake transaction to create

account_id
required
string

Kiln Account ID

wallet
required
string

Wallet address

amount_nanoton
required
string

Amount in nanoton. Minimum is 12000000000 nanoton (1.2 TON)

pool_address
string

Pool destination address (optional). If not specified, the Kiln TON whales pool with the lowest balance will be used as destination.

vesting_contract_address
string

Vesting contract address (optional), to be used when staking from a vesting contract

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "d3f1b917-72b1-4982-a4dd-93fce579a708",
  • "wallet": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
  • "amount_nanoton": "1000000000000000",
  • "pool_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
  • "vesting_contract_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "5b451f530950de0cb371a91edf16f36a5180e31162faccc7f10db8ccf027023a",
    • "unsigned_tx_serialized": "b5ee9c72c10102010046000011011c29a9a317668d4f0a0000003e0003010066627fed9c544ffac225103268b387fd329b361cda9741c13b88cf5e028776f6277980187a1200000000000000000000000000002537dddb",
    • "from": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
    • "to": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
    • "amount": "1000000000000000",
    • "payload": "te6ccsEBAQEADAAMABQAAAAASGVsbG8hCaTc/g==",
    • "valid_until": 1738689966
    }
}

Unstake single nomination pool transaction

Craft an unstake transaction from a single nomination pool.

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

Unstake transaction to create

wallet
required
string

Wallet address

pool_address
required
string

Pool address

amount_nanoton
string

Amount in nanoton (optional). If not provided, the full stake will be unstaked

vesting_contract_address
string

Vesting contract address (optional), to be used when unstaking from a vesting contract.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
  • "pool_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
  • "amount_nanoton": "1000000000000000",
  • "vesting_contract_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "5b451f530950de0cb371a91edf16f36a5180e31162faccc7f10db8ccf027023a",
    • "unsigned_tx_serialized": "b5ee9c72c10102010046000011011c29a9a317668d4f0a0000003e0003010066627fed9c544ffac225103268b387fd329b361cda9741c13b88cf5e028776f6277980187a1200000000000000000000000000002537dddb",
    • "from": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
    • "to": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
    • "amount": "1000000000000000",
    • "payload": "te6ccsEBAQEADAAMABQAAAAASGVsbG8hCaTc/g==",
    • "valid_until": 1738689966
    }
}

Unstake TON whales pool transaction

Craft an unstake transaction from a TON whales pool.

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

Unstake transaction to create

wallet
required
string

Wallet address

pool_address
required
string

Pool address

amount_nanoton
string

Amount in nanoton (optional). If not provided, the full stake will be unstaked

vesting_contract_address
string

Vesting contract address (optional), to be used when unstaking from a vesting contract.

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
  • "pool_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
  • "amount_nanoton": "1000000000000000",
  • "vesting_contract_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "5b451f530950de0cb371a91edf16f36a5180e31162faccc7f10db8ccf027023a",
    • "unsigned_tx_serialized": "b5ee9c72c10102010046000011011c29a9a317668d4f0a0000003e0003010066627fed9c544ffac225103268b387fd329b361cda9741c13b88cf5e028776f6277980187a1200000000000000000000000000002537dddb",
    • "from": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
    • "to": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
    • "amount": "1000000000000000",
    • "payload": "te6ccsEBAQEADAAMABQAAAAASGVsbG8hCaTc/g==",
    • "valid_until": 1738689966
    }
}

Whitelist address on vesting contract transaction

Craft whitelist address on vesting contract transaction.

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

Whitelist transaction to create

wallet
required
string

Wallet address

vesting_contract_address
required
string

Vesting contract address

addresses
required
Array of strings

List of addresses to whitelist

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "wallet": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
  • "vesting_contract_address": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
  • "addresses": [
    • "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e"
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_hash": "5b451f530950de0cb371a91edf16f36a5180e31162faccc7f10db8ccf027023a",
    • "unsigned_tx_serialized": "b5ee9c72c10102010046000011011c29a9a317668d4f0a0000003e0003010066627fed9c544ffac225103268b387fd329b361cda9741c13b88cf5e028776f6277980187a1200000000000000000000000000002537dddb",
    • "from": "0QBQJR9IALMi8kLWKKoo20A1-i9tLB1F2ZTIIyppHGPFYe8e",
    • "to": "Ef8xihYQ_8JBVBmystDCnNcAsy5yH_NzpFi2eYcXNaSzIdgw",
    • "amount": "1000000000000000",
    • "payload": "te6ccsEBAQEADAAMABQAAAAASGVsbG8hCaTc/g==",
    • "valid_until": 1738689966
    }
}

Tron (TRX)

Staking facilities for the Tron protocol

Network Stats

Get some network statistics on Tron staking

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "trx_price_usd": 0.27,
    • "nb_validators": 423,
    • "network_gross_apy": 4.5,
    • "supply_staked_percent": 47.39,
    • "inflation_rate": 5.5,
    • "updated_at": "2023-01-14T01:13:59Z"
    }
}

Stakes

Get TRX stakes

Authorizations:
bearerAuth
query Parameters
wallets
string
Example: wallets=TAERHY5gyzDRmAaeqqa6C4Fuyc9HLnnHx7

Comma separated list of TRX wallet addresses

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

Comma-separated list of Kiln accounts identifiers

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "wallet": "TAERHY5gyzDRmAaeqqa6C4Fuyc9HLnnHx7",
      • "available_balance": "32647466",
      • "claimable_rewards": "13749",
      • "frozen_bandwidth": "1000000",
      • "frozen_energy": "1000000",
      • "last_withdraw_at": "2021-01-01T00:00:00Z",
      • "unstaking": [
        • {
          • "resource": "BANDWIDTH",
          • "amount": "1000000",
          • "expire": "2021-01-01T00:00:00Z"
          }
        ],
      • "votes": [
        • {
          • "address": "TQzd66b9EFVHJfZK5AmiVhBjtJvXGeSPPZ",
          • "count": "4"
          }
        ],
      • "withdrawable_balance": "2000000",
      • "updated_at": "2021-01-01T00:00:00Z"
      }
    ]
}

Rewards

Get historical rewards of TRX stakes

Authorizations:
bearerAuth
query Parameters
wallets
string
Example: wallets=TAERHY5gyzDRmAaeqqa6C4Fuyc9HLnnHx7

Comma separated list of TRX wallet addresses

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

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": "2025-03-21",
      • "rewards": "1000000",
      • "net_apy": 4.5,
      • "effective_balance": 4,
      • "validator_votes": "validator_votes",
      • "effective_balance_usd": 4407596.22,
      • "rewards_usd": 0.22
      }
    ]
}

Stake transaction

Craft a stake transaction to obtain bandwidth or energy, and obtain TRON Power.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID

owner_address
required
string

Wallet address of the owner

amount_sun
required
string

Amount of TRX to stake in sun

resource
required
string
Enum: "BANDWIDTH" "ENERGY"

Resource to obtain

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "owner_address": "TAERHY5gyzDRmAaeqqa6C4Fuyc9HLnnHx7",
  • "amount_sun": "1000000",
  • "resource": "BANDWIDTH"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_id": "a610890432d168c44f902ab8d984685aa732aeb6b5c9b5d55afaec1c658ec495",
    • "unsigned_tx_serialized": "0a02237722087aa78d8d8af3f1cd40c8a6949cbf325a57083612530a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121b0a154102e07e61860efd34e1bdedcb5b485da75407d8f110c0843d70e8f4b49abf32"
    }
}

Unstake transaction

Craft an unstake transaction to unstake TRX, releases bandwidth or energy, and voting rights.

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

Transaction to craft

owner_address
required
string

Wallet address of the owner

amount_sun
required
string

Amount of TRX to unstake in sun

resource
required
string
Enum: "BANDWIDTH" "ENERGY"

Resource to release

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "owner_address": "TAERHY5gyzDRmAaeqqa6C4Fuyc9HLnnHx7",
  • "amount_sun": "1000000",
  • "resource": "BANDWIDTH"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_id": "a610890432d168c44f902ab8d984685aa732aeb6b5c9b5d55afaec1c658ec495",
    • "unsigned_tx_serialized": "0a02237722087aa78d8d8af3f1cd40c8a6949cbf325a57083612530a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121b0a154102e07e61860efd34e1bdedcb5b485da75407d8f110c0843d70e8f4b49abf32"
    }
}

Cancel unstake transaction

Craft an cancel unstake transaction to Cancel unstakings, all unstaked funds still in the waiting period will be re-staked, or withdrawn if the passed the lockup period.

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

Transaction to craft

owner_address
required
string

Wallet address of the owner

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_id": "a610890432d168c44f902ab8d984685aa732aeb6b5c9b5d55afaec1c658ec495",
    • "unsigned_tx_serialized": "0a02237722087aa78d8d8af3f1cd40c8a6949cbf325a57083612530a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121b0a154102e07e61860efd34e1bdedcb5b485da75407d8f110c0843d70e8f4b49abf32"
    }
}

Withdraw unstaked transaction

Craft a withdraw unstaked transaction.

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

Transaction to craft

owner_address
required
string

Wallet address of the owner

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_id": "a610890432d168c44f902ab8d984685aa732aeb6b5c9b5d55afaec1c658ec495",
    • "unsigned_tx_serialized": "0a02237722087aa78d8d8af3f1cd40c8a6949cbf325a57083612530a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121b0a154102e07e61860efd34e1bdedcb5b485da75407d8f110c0843d70e8f4b49abf32"
    }
}

Vote transaction

Craft a vote transaction.

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

Transaction to craft

account_id
required
string <uuid>

Kiln Account ID

owner_address
required
string

Wallet address of the owner

required
object

Number of votes to cast

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "owner_address": "TAERHY5gyzDRmAaeqqa6C4Fuyc9HLnnHx7",
  • "votes": {
    • "TQzd66b9EFVHJfZK5AmiVhBjtJvXGeSPPZ": 1
    }
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_id": "a610890432d168c44f902ab8d984685aa732aeb6b5c9b5d55afaec1c658ec495",
    • "unsigned_tx_serialized": "0a02237722087aa78d8d8af3f1cd40c8a6949cbf325a57083612530a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121b0a154102e07e61860efd34e1bdedcb5b485da75407d8f110c0843d70e8f4b49abf32"
    }
}

Withdraw rewards transaction

Craft a withdraw rewards transaction.

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

Transaction to craft

owner_address
required
string

Wallet address of the owner

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "unsigned_tx_id": "a610890432d168c44f902ab8d984685aa732aeb6b5c9b5d55afaec1c658ec495",
    • "unsigned_tx_serialized": "0a02237722087aa78d8d8af3f1cd40c8a6949cbf325a57083612530a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121b0a154102e07e61860efd34e1bdedcb5b485da75407d8f110c0843d70e8f4b49abf32"
    }
}

Prepare transaction

Prepare a transaction for broadcast 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": "0a026554220847c22aa98d1f46a94090ee9ba0be325a6a080412660a30747970652e676f6f676c65617069732e636f6d2f70726f6f746f636f6c2e566f74655769746e657373436f6e747261637412320a154102e07e61860efd34e1bdedcb5b485da75407d8f112190a1541a4ce68cfcdd27884bde52cec653354048e0aa989100170b0e1fef6bd32",
  • "signature": "47b1f77b3e30cfbbfa41d795dd34475865240617dd1c5a7bad526f5fd89e52cd057c80b665cc2431efab53520e2b1b92a0425033baee915df858ca1c588b0a1800"
}

Response samples

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

Broadcast transaction

Broadcast a signed transaction to the blockchain.

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

Response samples

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

ZetaChain (ZETA)

Staking facilities for the ZetaChain protocol

Stakes

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

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

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

delegators
Array of strings
Example: delegators=zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460

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

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

Comma-separated list of Kiln accounts identifiers

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    • {
      • "validator_address": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
      • "delegator_address": "zeta1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
      • "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": [
            • "zetavaloper1xyz",
            • "zetavaloper1abc"
            ],
          • "deny_list": [
            • "zetavaloper1xyz",
            • "zetavaloper1abc"
            ]
          }
        ],
      • "unbondings": [
        • {
          • "creation_height": 15000000,
          • "completion_time": "2023-01-10T01:12:34Z",
          • "balance": "129300",
          • "initial_balance": "150300"
          }
        ]
      }
    ]
}

Create stakes Deprecated

Link a ZetaChain stake to a Kiln account

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

Stakes to create

required
Array of objects
account_id
required
string

Kiln Account ID

Responses

Request samples

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

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "id": "92f5bfd4-ea38-4824-84f7-686eddff5539",
    • "stake_id": "0x8b3c9a781dbfa14879c9dacbb54c3401710fc5b0b8191b9ed33ecfb86c91b08bb878b79c27596f3d665046666d27c09e",
    • "protocol": "ethereum",
    • "deleted_at": null,
    • "created_at": "2023-02-06T21:48:11.038Z",
    • "updated_at": "2023-02-06T21:48:11.038Z"
    }
}

Rewards

Get historical rewards by day of ZETA stakes. Units are in uZETA (10⁻⁶ ZETA).

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

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

delegators
Array of strings
Example: delegators=zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460

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

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

Comma-separated list of Kiln accounts identifiers

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

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

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

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

include_usd
boolean
Example: include_usd=1

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

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

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 ZETACHAIN stakes. Units are in uZETA (10⁻⁶ ZETA).

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

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

delegators
Array of strings
Example: delegators=zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460

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

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)

precision
string
Enum: "chain" "micro" "atto"

Precision to use when formatting amounts

wasm
boolean
Default: false

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

Responses

Response samples

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

Network Stats

Get some network statistics on Zetachain

Authorizations:
bearerAuth

Responses

Response samples

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

Reports

Get reports on Cosmos staking

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

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

validators
Array of strings
Example: validators=zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe

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

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

Comma-separated list of Kiln accounts identifiers

Responses

Get balance

Get balance of a Zeta account

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

Account to query

address
required
string

Wallet address

denom
required
string

The denomination of the balance to query

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "address": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
  • "denom": "azeta"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "amount": "1000000",
    • "denom": "azeta"
    }
}

Stake Transaction

Generates a delegate transaction on ZetaChain

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_azeta
required
string

Amount to stake in azeta

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "amount_azeta": "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",
    • "fee": {
      • "amount": [
        • {
          • "denom": "azeta",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "messages": [
      • {
        • "typeUrl": "/cosmos.staking.v1beta1.MsgDelegate",
        • "value": {
          • "delegatorAddress": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
          • "validatorAddress": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
          • "amount": {
            • "denom": "azeta",
            • "amount": "1000000"
            }
          }
        }
      ],
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Send Transaction

Generates a send transaction on ZetaChain

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

to
required
string

Recipient address

amount_azeta
required
string

Amount to send in azeta

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "to": "zeta1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
  • "amount_azeta": "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": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "azeta",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "azeta",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Withdraw Rewards Transaction

Generates a withdraw rewards transaction on ZetaChain

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

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": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "azeta",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "azeta",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Unstake Transaction

Generates an undelegate transaction on ZetaChain

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_azeta
string

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

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "amount_azeta": "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": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "azeta",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "azeta",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

Redelegate Transaction

Generates a redelegate transaction on ZetaChain 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_azeta
string

Amount to redelegate in uZETA

Responses

Request samples

Content type
application/json; charset=utf-8
{
  • "account_id": "b7177fd2-fbb3-479f-aa92-db9fb16e229f",
  • "pubkey": "039ce47b2a813d13876131a9c3be77e8c4afa49e948744abbee11f939e2a420f46",
  • "validator_source": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "validator_destination": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
  • "amount_azeta": "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": "zeta1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3e93u460",
        • "validatorAddress": "zetavaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3ep3yfhe",
        • "amount": {
          • "denom": "azeta",
          • "amount": "1000000"
          }
        }
      },
    • "fee": {
      • "amount": [
        • {
          • "denom": "azeta",
          • "amount": "5000"
          }
        ],
      • "gas": "200000"
      },
    • "chain_id": "cosmoshub-4",
    • "account_number": 1234
    }
}

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

Transaction Decoding

Decode a transaction

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

Raw transaction to decode

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    • "authInfo": {
      • "signerInfos": [
        • {
          • "publicKey": {
            • "typeUrl": "/cosmos.crypto.secp256k1.PubKey",
            • "value": {
              • "0": 10,
              • "1": 33,
              • "2": 3,
              • "3": 156,
              • "4": 228,
              • "5": 123,
              • "6": 42,
              • "7": 129,
              • "8": 61,
              • "9": 19,
              • "10": 135,
              • "11": 97,
              • "12": 49,
              • "13": 169,
              • "14": 195,
              • "15": 190,
              • "16": 119,
              • "17": 232,
              • "18": 196,
              • "19": 175,
              • "20": 164,
              • "21": 158,
              • "22": 148,
              • "23": 135,
              • "24": 68,
              • "25": 171,
              • "26": 190,
              • "27": 225,
              • "28": 31,
              • "29": 147,
              • "30": 158,
              • "31": 42,
              • "32": 66,
              • "33": 15,
              • "34": 70
              }
            },
          • "modeInfo": {
            • "single": {
              • "mode": 1
              }
            },
          • "sequence": {
            • "low": 102,
            • "high": 0,
            • "unsigned": true
            }
          }
        ],
      • "fee": {
        • "amount": [
          • {
            • "denom": "azeta",
            • "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
        }
      ]
    }
}