HBTCChain API

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

A REST interface for state queries, transaction generation and broadcasting.

Transactions

Search, encode, or broadcast transactions.

get__txs_{hash}

GET /txs/{hash}

Get a Tx by hash

Retrieve a transaction using its hash.

Parameters

Name In Type Required Description
hash path string true Tx hash

Example responses

200 Response

{
  "hash": "D085138D913993919295FF4B0A9107F1F2CDE0D37A87CE0644E217CBF3B49656",
  "height": 368,
  "tx": {
    "msg": [
      "string"
    ],
    "fee": {
      "gas": "string",
      "amount": [
        {
          "denom": "stake",
          "amount": "50"
        }
      ]
    },
    "memo": "string",
    "signature": {
      "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
      "pub_key": {
        "type": "tendermint/PubKeySecp256k1",
        "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
      },
      "account_number": "0",
      "sequence": "0"
    }
  },
  "result": {
    "log": "string",
    "gas_wanted": "200000",
    "gas_used": "26354",
    "tags": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  }
}

Responses

Status Meaning Description Schema
200 OK Tx with the provided hash TxQuery
500 Internal Server Error Internal Server Error None

post__txs

POST /txs

Broadcast a signed tx

Broadcast a signed tx to a full node

Body parameter

{
  "tx": {
    "msg": [
      "string"
    ],
    "fee": {
      "gas": "string",
      "amount": [
        {
          "denom": "stake",
          "amount": "50"
        }
      ]
    },
    "memo": "string",
    "signature": {
      "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
      "pub_key": {
        "type": "tendermint/PubKeySecp256k1",
        "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
      },
      "account_number": "0",
      "sequence": "0"
    }
  },
  "mode": "block"
}

Parameters

Name In Type Required Description
body body object true none
» tx body StdTx false none
»» msg body [Msg] false none
»» fee body object false none
»»» gas body string false none
»»» amount body [Coin] false none
»»»» denom body string false none
»»»» amount body string false none
»»» memo body string false none
»»» signature body object false none
»»»» signature body string false none
»»»» pub_key body object false none
»»»»» type body string false none
»»»»» value body string false none
»»»» account_number body string false none
»»»» sequence body string false none
»»» mode body string false none

Example responses

200 Response

{
  "check_tx": {
    "code": 0,
    "data": "data",
    "log": "log",
    "gas_used": 5000,
    "gas_wanted": 10000,
    "info": "info",
    "tags": [
      "",
      ""
    ]
  },
  "deliver_tx": {
    "code": 5,
    "data": "data",
    "log": "log",
    "gas_used": 5000,
    "gas_wanted": 10000,
    "info": "info",
    "tags": [
      "",
      ""
    ]
  },
  "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "height": 0
}

Responses

Status Meaning Description Schema
200 OK Tx broadcasting result BroadcastTxCommitResult
500 Internal Server Error Internal Server Error None

post__txs_encode

POST /txs/encode

Encode a transaction to the Amino wire format

Encode a transaction (signed or not) from JSON to base64-encoded Amino serialized bytes

Body parameter

{
  "tx": {
    "msg": [
      "string"
    ],
    "fee": {
      "gas": "string",
      "amount": [
        {
          "denom": "stake",
          "amount": "50"
        }
      ]
    },
    "memo": "string",
    "signature": {
      "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
      "pub_key": {
        "type": "tendermint/PubKeySecp256k1",
        "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
      },
      "account_number": "0",
      "sequence": "0"
    }
  }
}

Parameters

Name In Type Required Description
body body object true none
» tx body StdTx false none
»» msg body [Msg] false none
»» fee body object false none
»»» gas body string false none
»»» amount body [Coin] false none
»»»» denom body string false none
»»»» amount body string false none
»»» memo body string false none
»»» signature body object false none
»»»» signature body string false none
»»»» pub_key body object false none
»»»»» type body string false none
»»»»» value body string false none
»»»» account_number body string false none
»»»» sequence body string false none

Example responses

200 Response

{
  "tx": "The base64-encoded Amino-serialized bytes for the tx"
}

Responses

Status Meaning Description Schema
200 OK The tx was successfully decoded and re-encoded Inline
400 Bad Request The tx was malformated None
500 Internal Server Error Server internal error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» tx string false none none

Tendermint RPC

Tendermint APIs, such as query blocks, transactions and validatorset

get__node_info

GET /node_info

The properties of the connected node

Information about the connected node

Example responses

200 Response

{
  "application_version": {
    "build_tags": "string",
    "client_name": "string",
    "commit": "string",
    "go": "string",
    "name": "string",
    "server_name": "string",
    "version": "string"
  },
  "node_info": {
    "id": "string",
    "moniker": "validator-name",
    "protocol_version": {
      "p2p": 7,
      "block": 10,
      "app": 0
    },
    "network": "gaia-2",
    "channels": "string",
    "listen_addr": "192.168.56.1:26656",
    "version": "0.15.0",
    "other": {
      "tx_index": "on",
      "rpc_address": "tcp://0.0.0.0:26657"
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Node status Inline
500 Internal Server Error Failed to query node status None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» application_version object false none none
»» build_tags string false none none
»» client_name string false none none
»» commit string false none none
»» go string false none none
»» name string false none none
»» server_name string false none none
»» version string false none none
» node_info object false none none
»» id string false none none
»» moniker string false none none
»» protocol_version object false none none
»»» p2p string false none none
»»» block string false none none
»»» app string false none none
»» network string false none none
»» channels string false none none
»» listen_addr string false none none
»» version string false none Tendermint version
»» other object false none more information on versions
»»» tx_index string false none none
»»» rpc_address string false none none

get__syncing

GET /syncing

Syncing state of node

Get if the node is currently syning with other nodes

Example responses

200 Response

{
  "syncing": true
}

Responses

Status Meaning Description Schema
200 OK Node syncing status Inline
500 Internal Server Error Server internal error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» syncing boolean false none none

get__blocks_latest

GET /blocks/latest

Get the latest block

Example responses

200 Response

{
  "block_meta": {
    "header": {
      "chain_id": "hbtc-testnet",
      "height": 1,
      "time": "2017-12-30T05:53:09.287+01:00",
      "num_txs": 0,
      "last_block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "total_txs": 35,
      "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
      "version": {
        "block": 10,
        "app": 0
      }
    },
    "block_id": {
      "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "parts": {
        "total": 0,
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
      }
    }
  },
  "block": {
    "header": {
      "chain_id": "hbtc-testnet",
      "height": 1,
      "time": "2017-12-30T05:53:09.287+01:00",
      "num_txs": 0,
      "last_block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "total_txs": 35,
      "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
      "version": {
        "block": 10,
        "app": 0
      }
    },
    "txs": [
      "string"
    ],
    "evidence": [
      "string"
    ],
    "last_commit": {
      "block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "precommits": [
        {
          "validator_address": "string",
          "validator_index": "0",
          "height": "0",
          "round": "0",
          "timestamp": "2017-12-30T05:53:09.287+01:00",
          "type": 2,
          "block_id": {
            "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
            "parts": {
              "total": 0,
              "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
            }
          },
          "signature": "7uTC74QlknqYWEwg7Vn6M8Om7FuZ0EO4bjvuj6rwH1mTUJrRuMMZvAAqT9VjNgP0RA/TDp6u/92AqrZfXJSpBQ=="
        }
      ]
    }
  }
}

Responses

Status Meaning Description Schema
200 OK The latest block BlockQuery
500 Internal Server Error Server internal error None

get__blocks_{height}

GET /blocks/{height}

Get a block at a certain height

Parameters

Name In Type Required Description
height path number true Block height

Example responses

200 Response

{
  "block_meta": {
    "header": {
      "chain_id": "hbtc-testnet",
      "height": 1,
      "time": "2017-12-30T05:53:09.287+01:00",
      "num_txs": 0,
      "last_block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "total_txs": 35,
      "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
      "version": {
        "block": 10,
        "app": 0
      }
    },
    "block_id": {
      "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "parts": {
        "total": 0,
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
      }
    }
  },
  "block": {
    "header": {
      "chain_id": "hbtc-testnet",
      "height": 1,
      "time": "2017-12-30T05:53:09.287+01:00",
      "num_txs": 0,
      "last_block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "total_txs": 35,
      "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
      "version": {
        "block": 10,
        "app": 0
      }
    },
    "txs": [
      "string"
    ],
    "evidence": [
      "string"
    ],
    "last_commit": {
      "block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "precommits": [
        {
          "validator_address": "string",
          "validator_index": "0",
          "height": "0",
          "round": "0",
          "timestamp": "2017-12-30T05:53:09.287+01:00",
          "type": 2,
          "block_id": {
            "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
            "parts": {
              "total": 0,
              "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
            }
          },
          "signature": "7uTC74QlknqYWEwg7Vn6M8Om7FuZ0EO4bjvuj6rwH1mTUJrRuMMZvAAqT9VjNgP0RA/TDp6u/92AqrZfXJSpBQ=="
        }
      ]
    }
  }
}

Responses

Status Meaning Description Schema
200 OK The block at a specific height BlockQuery
400 Bad Request Invalid height None
404 Not Found Request block height doesn't None
500 Internal Server Error Server internal error None

get__validatorsets_latest

GET /validatorsets/latest

Get the latest validator set

Example responses

200 Response

{
  "block_height": "string",
  "validators": [
    {
      "address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
      "pub_key": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
      "voting_power": "1000",
      "proposer_priority": "1000"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK The validator set at the latest block height Inline
500 Internal Server Error Server internal error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» block_height string false none none
» validators [TendermintValidator] false none none
»» address ValidatorAddress false none bech32 encoded address
»» pub_key string false none none
»» voting_power string false none none
»» proposer_priority string false none none

get__validatorsets_{height}

GET /validatorsets/{height}

Get a validator set a certain height

Parameters

Name In Type Required Description
height path number true Block height

Example responses

200 Response

{
  "block_height": "string",
  "validators": [
    {
      "address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
      "pub_key": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
      "voting_power": "1000",
      "proposer_priority": "1000"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK The validator set at a specific block height Inline
400 Bad Request Invalid height None
404 Not Found Block at height not available None
500 Internal Server Error Server internal error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» block_height string false none none
» validators [TendermintValidator] false none none
»» address ValidatorAddress false none bech32 encoded address
»» pub_key string false none none
»» voting_power string false none none
»» proposer_priority string false none none

Cu

Custodian unit module APIs

get__cu_cus_{address}

GET /cu/cus/{address}

Get the custodian unit information on blockchain

Parameters

Name In Type Required Description
address path string true Account address

Example responses

200 Response

{
  "type": "string",
  "value": {
    "account_number": "string",
    "address": "string",
    "coins": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "public_key": {
      "type": "string",
      "value": "string"
    },
    "sequence": "string"
  }
}

Responses

Status Meaning Description Schema
200 OK Account information on the blockchain Inline
500 Internal Server Error Server internel error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» type string false none none
» value object false none none
»» account_number string false none none
»» address string false none none
»» coins [Coin] false none none
»»» denom string false none none
»»» amount string false none none
»» public_key PublicKey false none none
»»» type string false none none
»»» value string false none none
»» sequence string false none none

Staking

Stake module APIs

get__staking_delegators_{delegatorAddr}_delegations

GET /staking/delegators/{delegatorAddr}/delegations

Get all delegations from a delegator

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator

Example responses

200 Response

[
  {
    "delegator_address": "string",
    "validator_address": "string",
    "shares": "string",
    "height": 0
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid delegator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Delegation] false none none
» delegator_address string false none none
» validator_address string false none none
» shares string false none none
» height integer false none none

get__staking_delegators_{delegatorAddr}delegations{validatorAddr}

GET /staking/delegators/{delegatorAddr}/delegations/{validatorAddr}

Query the current delegation between a delegator and a validator

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

{
  "delegator_address": "string",
  "validator_address": "string",
  "shares": "string",
  "height": 0
}

Responses

Status Meaning Description Schema
200 OK OK Delegation
400 Bad Request Invalid delegator address or validator address None
500 Internal Server Error Internal Server Error None

get__staking_delegators_{delegatorAddr}_unbonding_delegations

GET /staking/delegators/{delegatorAddr}/unbonding_delegations

Get all unbonding delegations from a delegator

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator

Example responses

200 Response

[
  {
    "delegator_address": "string",
    "validator_address": "string",
    "initial_balance": "string",
    "balance": "string",
    "creation_height": 0,
    "min_time": 0
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid delegator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [UnbondingDelegation] false none none
» delegator_address string false none none
» validator_address string false none none
» initial_balance string false none none
» balance string false none none
» creation_height integer false none none
» min_time integer false none none

get__staking_delegators_{delegatorAddr}unbonding_delegations{validatorAddr}

GET /staking/delegators/{delegatorAddr}/unbonding_delegations/{validatorAddr}

Query all unbonding delegations between a delegator and a validator

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

{
  "delegator_address": "string",
  "validator_address": "string",
  "entries": [
    {
      "initial_balance": "string",
      "balance": "string",
      "creation_height": "string",
      "min_time": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK UnbondingDelegationPair
400 Bad Request Invalid delegator address or validator address None
500 Internal Server Error Internal Server Error None

get__staking_redelegations

GET /staking/redelegations

Get all redelegations (filter by query params)

Parameters

Name In Type Required Description
delegator query string false Bech32 AccAddress of Delegator
validator_from query string false Bech32 ValAddress of SrcValidator
validator_to query string false Bech32 ValAddress of DstValidator

Example responses

200 Response

[
  {
    "delegator_address": "string",
    "validator_src_address": "string",
    "validator_dst_address": "string",
    "entries": [
      null
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Redelegation] false none none
» delegator_address string false none none
» validator_src_address string false none none
» validator_dst_address string false none none
» entries [Redelegation] false none none

get__staking_delegators_{delegatorAddr}_validators

GET /staking/delegators/{delegatorAddr}/validators

Query all validators that a delegator is bonded to

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator

Example responses

200 Response

[
  {
    "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
    "consensus_pubkey": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
    "jailed": true,
    "status": 0,
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "details": "string"
    },
    "bond_height": "0",
    "bond_intra_tx_counter": 0,
    "unbonding_height": "0",
    "unbonding_time": "1970-01-01T00:00:00Z",
    "commission": {
      "rate": "0",
      "max_rate": "0",
      "max_change_rate": "0",
      "update_time": "1970-01-01T00:00:00Z"
    }
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid delegator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Validator] false none none
» operator_address ValidatorAddress false none bech32 encoded address
» consensus_pubkey string false none none
» jailed boolean false none none
» status integer false none none
» tokens string false none none
» delegator_shares string false none none
» description object false none none
»» moniker string false none none
»» identity string false none none
»» website string false none none
»» details string false none none
» bond_height string false none none
» bond_intra_tx_counter integer false none none
» unbonding_height string false none none
» unbonding_time string false none none
» commission object false none none
»» rate string false none none
»» max_rate string false none none
»» max_change_rate string false none none
»» update_time string false none none

get__staking_delegators_{delegatorAddr}validators{validatorAddr}

GET /staking/delegators/{delegatorAddr}/validators/{validatorAddr}

Query a validator that a delegator is bonded to

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator
validatorAddr path string true Bech32 ValAddress of Delegator

Example responses

200 Response

{
  "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "consensus_pubkey": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
  "jailed": true,
  "status": 0,
  "tokens": "string",
  "delegator_shares": "string",
  "description": {
    "moniker": "string",
    "identity": "string",
    "website": "string",
    "details": "string"
  },
  "bond_height": "0",
  "bond_intra_tx_counter": 0,
  "unbonding_height": "0",
  "unbonding_time": "1970-01-01T00:00:00Z",
  "commission": {
    "rate": "0",
    "max_rate": "0",
    "max_change_rate": "0",
    "update_time": "1970-01-01T00:00:00Z"
  }
}

Responses

Status Meaning Description Schema
200 OK OK Validator
400 Bad Request Invalid delegator address or validator address None
500 Internal Server Error Internal Server Error None

get__staking_validators

GET /staking/validators

Get all validator candidates. By default it returns only the bonded validators.

Parameters

Name In Type Required Description
status query string false The validator bond status. Must be either 'bonded', 'unbonded', or 'unbonding'.
page query integer false The page number.
limit query integer false The maximum number of items per page.

Example responses

200 Response

[
  {
    "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
    "consensus_pubkey": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
    "jailed": true,
    "status": 0,
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "details": "string"
    },
    "bond_height": "0",
    "bond_intra_tx_counter": 0,
    "unbonding_height": "0",
    "unbonding_time": "1970-01-01T00:00:00Z",
    "commission": {
      "rate": "0",
      "max_rate": "0",
      "max_change_rate": "0",
      "update_time": "1970-01-01T00:00:00Z"
    }
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Validator] false none none
» operator_address ValidatorAddress false none bech32 encoded address
» consensus_pubkey string false none none
» jailed boolean false none none
» status integer false none none
» tokens string false none none
» delegator_shares string false none none
» description object false none none
»» moniker string false none none
»» identity string false none none
»» website string false none none
»» details string false none none
» bond_height string false none none
» bond_intra_tx_counter integer false none none
» unbonding_height string false none none
» unbonding_time string false none none
» commission object false none none
»» rate string false none none
»» max_rate string false none none
»» max_change_rate string false none none
»» update_time string false none none

get__staking_validators_{validatorAddr}

GET /staking/validators/{validatorAddr}

Query the information from a single validator

Parameters

Name In Type Required Description
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

{
  "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "consensus_pubkey": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
  "jailed": true,
  "status": 0,
  "tokens": "string",
  "delegator_shares": "string",
  "description": {
    "moniker": "string",
    "identity": "string",
    "website": "string",
    "details": "string"
  },
  "bond_height": "0",
  "bond_intra_tx_counter": 0,
  "unbonding_height": "0",
  "unbonding_time": "1970-01-01T00:00:00Z",
  "commission": {
    "rate": "0",
    "max_rate": "0",
    "max_change_rate": "0",
    "update_time": "1970-01-01T00:00:00Z"
  }
}

Responses

Status Meaning Description Schema
200 OK OK Validator
400 Bad Request Invalid validator address None
500 Internal Server Error Internal Server Error None

get__staking_validators_{validatorAddr}_delegations

GET /staking/validators/{validatorAddr}/delegations

Get all delegations from a validator

Parameters

Name In Type Required Description
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

[
  {
    "delegator_address": "string",
    "validator_address": "string",
    "shares": "string",
    "height": 0
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid validator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Delegation] false none none
» delegator_address string false none none
» validator_address string false none none
» shares string false none none
» height integer false none none

get__staking_validators_{validatorAddr}_unbonding_delegations

GET /staking/validators/{validatorAddr}/unbonding_delegations

Get all unbonding delegations from a validator

Parameters

Name In Type Required Description
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

[
  {
    "delegator_address": "string",
    "validator_address": "string",
    "initial_balance": "string",
    "balance": "string",
    "creation_height": 0,
    "min_time": 0
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid validator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [UnbondingDelegation] false none none
» delegator_address string false none none
» validator_address string false none none
» initial_balance string false none none
» balance string false none none
» creation_height integer false none none
» min_time integer false none none

get__staking_pool

GET /staking/pool

Get the current state of the staking pool

Example responses

200 Response

{
  "loose_tokens": "string",
  "bonded_tokens": "string",
  "inflation_last_time": "string",
  "inflation": "string",
  "date_last_commission_reset": "string",
  "prev_bonded_shares": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» loose_tokens string false none none
» bonded_tokens string false none none
» inflation_last_time string false none none
» inflation string false none none
» date_last_commission_reset string false none none
» prev_bonded_shares string false none none

get__staking_parameters

GET /staking/parameters

Get the current staking parameter values

Example responses

200 Response

{
  "inflation_rate_change": "string",
  "inflation_max": "string",
  "inflation_min": "string",
  "goal_bonded": "string",
  "unbonding_time": "string",
  "max_validators": 0,
  "bond_denom": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» inflation_rate_change string false none none
» inflation_max string false none none
» inflation_min string false none none
» goal_bonded string false none none
» unbonding_time string false none none
» max_validators integer false none none
» bond_denom string false none none

Governance

Governance module APIs

get__gov_proposals

GET /gov/proposals

Query proposals

Query proposals information with parameters

Parameters

Name In Type Required Description
voter query string false voter address
depositor query string false depositor address
status query string false proposal status, valid values can be "deposit_period", "voting_period", "passed", "rejected"

Example responses

200 Response

[
  {
    "proposal_id": 0,
    "title": "string",
    "description": "string",
    "proposal_type": "string",
    "proposal_status": "string",
    "final_tally_result": {
      "yes": "0.0000000000",
      "abstain": "0.0000000000",
      "no": "0.0000000000",
      "no_with_veto": "0.0000000000"
    },
    "submit_time": "string",
    "total_deposit": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "voting_start_time": "string"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid query parameters None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [TextProposal] false none none
» proposal_id integer false none none
» title string false none none
» description string false none none
» proposal_type string false none none
» proposal_status string false none none
» final_tally_result TallyResult false none none
»» yes string false none none
»» abstain string false none none
»» no string false none none
»» no_with_veto string false none none
» submit_time string false none none
» total_deposit [Coin] false none none
»» denom string false none none
»» amount string false none none
» voting_start_time string false none none

post__gov_proposals_param_change

POST /gov/proposals/param_change

Generate a parameter change proposal transaction

Generate a parameter change proposal transaction

Body parameter

{
  "base_req": {
    "from": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
    "memo": "Sent via hbtcchain 🚀",
    "chain_id": "hbtc-testnet",
    "account_number": "0",
    "sequence": "1",
    "gas": "200000",
    "gas_adjustment": "1.2",
    "fees": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "simulate": false
  },
  "title": "Param Change",
  "description": "Update max validators",
  "proposer": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
  "deposit": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "changes": [
    {
      "subspace": "staking",
      "key": "MaxValidators",
      "subkey": "",
      "value": {}
    }
  ]
}

Parameters

Name In Type Required Description
body body object true none
» base_req body BaseReq false none
»» from body string false Sender address or Keybase name to generate a transaction
»» memo body string false none
»» chain_id body string false none
»» account_number body string false none
»» sequence body string false none
»» gas body string false none
»» gas_adjustment body string false none
»» fees body [Coin] false none
»»» denom body string false none
»»» amount body string false none
»» simulate body boolean false Estimate gas for a transaction (cannot be used in conjunction with generate_only)
» title body string false none
» description body string false none
» proposer body Address false base58 encoded address
» deposit body [Coin] false none
» changes body [ParamChange] false none
»» subspace body string false none
»» key body string false none
»» subkey body string false none
»» value body object false none

Example responses

200 Response

{
  "msg": [
    "string"
  ],
  "fee": {
    "gas": "string",
    "amount": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ]
  },
  "memo": "string",
  "signature": {
    "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
    "pub_key": {
      "type": "tendermint/PubKeySecp256k1",
      "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
    },
    "account_number": "0",
    "sequence": "0"
  }
}

Responses

Status Meaning Description Schema
200 OK The transaction was succesfully generated StdTx
400 Bad Request Invalid proposal body None
500 Internal Server Error Internal Server Error None

get__gov_proposals_{proposalId}

GET /gov/proposals/{proposalId}

Query a proposal

Query a proposal by id

Parameters

Name In Type Required Description
proposalId path string true none

Example responses

200 Response

{
  "proposal_id": 0,
  "title": "string",
  "description": "string",
  "proposal_type": "string",
  "proposal_status": "string",
  "final_tally_result": {
    "yes": "0.0000000000",
    "abstain": "0.0000000000",
    "no": "0.0000000000",
    "no_with_veto": "0.0000000000"
  },
  "submit_time": "string",
  "total_deposit": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "voting_start_time": "string"
}

Responses

Status Meaning Description Schema
200 OK OK TextProposal
400 Bad Request Invalid proposal id None
500 Internal Server Error Internal Server Error None

get__gov_proposals_{proposalId}_proposer

GET /gov/proposals/{proposalId}/proposer

Query proposer

Query for the proposer for a proposal

Parameters

Name In Type Required Description
proposalId path string true none

Example responses

200 Response

{
  "proposal_id": "string",
  "proposer": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Proposer
400 Bad Request Invalid proposal ID None
500 Internal Server Error Internal Server Error None

get__gov_proposals_{proposalId}_deposits

GET /gov/proposals/{proposalId}/deposits

Query deposits

Query deposits by proposalId

Parameters

Name In Type Required Description
proposalId path string true none

Example responses

200 Response

[
  {
    "amount": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "proposal_id": "string",
    "depositor": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid proposal id None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Deposit] false none none
» amount [Coin] false none none
»» denom string false none none
»» amount string false none none
» proposal_id string false none none
» depositor Address false none base58 encoded address

get__gov_proposals_{proposalId}deposits{depositor}

GET /gov/proposals/{proposalId}/deposits/{depositor}

Query deposit

Query deposit by proposalId and depositor address

Parameters

Name In Type Required Description
proposalId path string true proposal id
depositor path string true depositor account address

Example responses

200 Response

{
  "amount": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "proposal_id": "string",
  "depositor": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa"
}

Responses

Status Meaning Description Schema
200 OK OK Deposit
400 Bad Request Invalid proposal id or depositor address None
404 Not Found Found no deposit None
500 Internal Server Error Internal Server Error None

get__gov_proposals_{proposalId}_votes

GET /gov/proposals/{proposalId}/votes

Query voters

Query voters information by proposalId

Parameters

Name In Type Required Description
proposalId path string true proposal id

Example responses

200 Response

[
  {
    "voter": "string",
    "proposal_id": "string",
    "option": "string"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid proposal id None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Vote] false none none
» voter string false none none
» proposal_id string false none none
» option string false none none

get__gov_proposals_{proposalId}votes{voter}

GET /gov/proposals/{proposalId}/votes/{voter}

Query vote

Query vote information by proposal Id and voter address

Parameters

Name In Type Required Description
proposalId path string true proposal id
voter path string true voter account address

Example responses

200 Response

{
  "voter": "string",
  "proposal_id": "string",
  "option": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Vote
400 Bad Request Invalid proposal id or voter address None
404 Not Found Found no vote None
500 Internal Server Error Internal Server Error None

get__gov_proposals_{proposalId}_tally

GET /gov/proposals/{proposalId}/tally

Get a proposal’s tally result at the current time

Gets a proposal’s tally result at the current time. If the proposal is pending deposits (i.e status ‘DepositPeriod’) it returns an empty tally result.

Parameters

Name In Type Required Description
proposalId path string true proposal id

Example responses

200 Response

{
  "yes": "0.0000000000",
  "abstain": "0.0000000000",
  "no": "0.0000000000",
  "no_with_veto": "0.0000000000"
}

Responses

Status Meaning Description Schema
200 OK OK TallyResult
400 Bad Request Invalid proposal id None
500 Internal Server Error Internal Server Error None

get__gov_parameters_deposit

GET /gov/parameters/deposit

Query governance deposit parameters

Query governance deposit parameters. The max_deposit_period units are in nanoseconds.

Example responses

200 Response

{
  "min_deposit": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "max_deposit_period": "86400000000000"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request is not a valid query request path None
404 Not Found Found no deposit parameters None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» min_deposit [Coin] false none none
»» denom string false none none
»» amount string false none none
» max_deposit_period string false none none

get__gov_parameters_tallying

GET /gov/parameters/tallying

Query governance tally parameters

Query governance tally parameters

Example responses

200 Response

{
  "threshold": "0.5000000000",
  "veto": "0.3340000000",
  "governance_penalty": "0.0100000000"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request is not a valid query request path None
404 Not Found Found no tally parameters None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» threshold string false none none
» veto string false none none
» governance_penalty string false none none

get__gov_parameters_voting

GET /gov/parameters/voting

Query governance voting parameters

Query governance voting parameters. The voting_period units are in nanoseconds.

Example responses

200 Response

{
  "voting_period": "86400000000000"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request is not a valid query request path None
404 Not Found Found no voting parameters None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» voting_period string false none none

Distribution

Fee distribution module APIs

get__distribution_delegators_{delegatorAddr}_rewards

GET /distribution/delegators/{delegatorAddr}/rewards

Get the total rewards balance from all delegations

Get the sum of all the rewards earned by delegations by a single delegator

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator

Example responses

200 Response

{
  "rewards": [
    {
      "validator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
      "reward": [
        {
          "denom": "stake",
          "amount": "50"
        }
      ]
    }
  ],
  "total": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK DelegatorTotalRewards
400 Bad Request Invalid delegator address None
500 Internal Server Error Internal Server Error None

get__distribution_delegators_{delegatorAddr}rewards{validatorAddr}

GET /distribution/delegators/{delegatorAddr}/rewards/{validatorAddr}

Query a delegation reward

Query a single delegation reward by a delegator

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

[
  {
    "denom": "stake",
    "amount": "50"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid delegator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Coin] false none none
» denom string false none none
» amount string false none none

get__distribution_delegators_{delegatorAddr}_withdraw_address

GET /distribution/delegators/{delegatorAddr}/withdraw_address

Get the rewards withdrawal address

Get the delegations’ rewards withdrawal address. This is the address in which the user will receive the reward funds

Parameters

Name In Type Required Description
delegatorAddr path string true Account Address of Delegator

Example responses

200 Response

"HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa"

Responses

Status Meaning Description Schema
200 OK OK Address
400 Bad Request Invalid delegator address None
500 Internal Server Error Internal Server Error None

get__distribution_validators_{validatorAddr}

GET /distribution/validators/{validatorAddr}

Validator distribution information

Query the distribution information of a single validator

Parameters

Name In Type Required Description
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

{
  "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "self_bond_rewards": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "val_commission": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK ValidatorDistInfo
400 Bad Request Invalid validator address None
500 Internal Server Error Internal Server Error None

get__distribution_validators_{validatorAddr}_outstanding_rewards

GET /distribution/validators/{validatorAddr}/outstanding_rewards

Fee distribution outstanding rewards of a single validator

Parameters

Name In Type Required Description
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

[
  {
    "denom": "stake",
    "amount": "50"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Coin] false none none
» denom string false none none
» amount string false none none

get__distribution_validators_{validatorAddr}_rewards

GET /distribution/validators/{validatorAddr}/rewards

Commission and self-delegation rewards of a single validator

Query the commission and self-delegation rewards of validator.

Parameters

Name In Type Required Description
validatorAddr path string true Bech32 OperatorAddress of validator

Example responses

200 Response

[
  {
    "denom": "stake",
    "amount": "50"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid validator address None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Coin] false none none
» denom string false none none
» amount string false none none

get__distribution_community_pool

GET /distribution/community_pool

Community pool parameters

Example responses

200 Response

[
  {
    "denom": "stake",
    "amount": "50"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Coin] false none none
» denom string false none none
» amount string false none none

get__distribution_parameters

GET /distribution/parameters

Fee distribution parameters

Example responses

200 Response

{
  "base_proposer_reward": "string",
  "bonus_proposer_reward": "string",
  "community_tax": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» base_proposer_reward string false none none
» bonus_proposer_reward string false none none
» community_tax string false none none

Supply

Supply module APIs

get__supply_total

GET /supply/total

Total supply of coins in the chain

Example responses

200 Response

{
  "total": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK Supply
500 Internal Server Error Internal Server Error None

get__supply_total_{denomination}

GET /supply/total/{denomination}

Total supply of a single coin denomination

Parameters

Name In Type Required Description
denomination path string true Coin denomination

Example responses

200 Response

"string"

Responses

Status Meaning Description Schema
200 OK OK string
400 Bad Request Invalid coin denomination None
500 Internal Server Error Internal Server Error None

Slashing

Slashing module APIs

get__slashing_signing_infos

GET /slashing/signing_infos

Get sign info of given all validators

Get sign info of all validators

Parameters

Name In Type Required Description
page query integer true Page number
limit query integer true Maximum number of items per page

Example responses

200 Response

[
  {
    "start_height": "string",
    "index_offset": "string",
    "jailed_until": "string",
    "missed_blocks_counter": "string"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid validator public key for one of the validators None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [SigningInfo] false none none
» start_height string false none none
» index_offset string false none none
» jailed_until string false none none
» missed_blocks_counter string false none none

get__slashing_parameters

GET /slashing/parameters

Get the current slashing parameters

Example responses

200 Response

{
  "max_evidence_age": "string",
  "signed_blocks_window": "string",
  "min_signed_per_window": "string",
  "double_sign_unbond_duration": "string",
  "downtime_unbond_duration": "string",
  "slash_fraction_double_sign": "string",
  "slash_fraction_downtime": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» max_evidence_age string false none none
» signed_blocks_window string false none none
» min_signed_per_window string false none none
» double_sign_unbond_duration string false none none
» downtime_unbond_duration string false none none
» slash_fraction_double_sign string false none none
» slash_fraction_downtime string false none none

Mint

Minting module APIs

get__minting_parameters

GET /minting/parameters

Minting module parameters

Example responses

200 Response

{
  "mint_denom": "string",
  "inflation_rate_change": "string",
  "inflation_max": "string",
  "inflation_min": "string",
  "goal_bonded": "string",
  "blocks_per_year": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» mint_denom string false none none
» inflation_rate_change string false none none
» inflation_max string false none none
» inflation_min string false none none
» goal_bonded string false none none
» blocks_per_year string false none none

get__minting_inflation

GET /minting/inflation

Current minting inflation value

Example responses

200 Response

"string"

Responses

Status Meaning Description Schema
200 OK OK string
500 Internal Server Error Internal Server Error None

get__minting_annual-provisions

GET /minting/annual-provisions

Current minting annual provisions value

Example responses

200 Response

"string"

Responses

Status Meaning Description Schema
200 OK OK string
500 Internal Server Error Internal Server Error None

Token

Token module APIs

get__token_info_{denom}

GET /token/info/{denom}

Information about a token denomination

Parameters

Name In Type Required Description
denom path string true Token denomination

Example responses

200 Response

{
  "block_height": "string",
  "result": {
    "symbol": "hbc",
    "issuer": "",
    "chain": "hbc",
    "type": "2",
    "is_send_enabled": true,
    "is_deposit_enabled": false,
    "is_withdrawal_enabled": false,
    "decimals": "18",
    "total_supply": "0",
    "collect_threshold": "0",
    "deposit_threshold": "0",
    "open_fee": "1000000000000000000",
    "sys_open_fee": "1000000000000000000",
    "withdrawal_fee": "0",
    "max_op_cu_number": "3",
    "systransfer_amount": "0",
    "op_cu_systransfer_amount": "0",
    "gas_limit": "1000000",
    "gas_price": "1"
  }
}

Responses

Status Meaning Description Schema
200 OK OK Inline
400 Bad Request Invalid token denomination None
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
» block_height string false none none
» result Token false none none
»» symbol string false none none
»» issuer string false none none
»» chain string false none none
»» type string false none none
»» is_send_enabled boolean false none none
»» is_deposit_enabled boolean false none none
»» is_withdrawal_enabled boolean false none none
»» decimals string false none none
»» total_supply string false none none
»» collect_threshold string false none none
»» deposit_threshold string false none none
»» open_fee string false none none
»» sys_open_fee string false none none
»» withdrawal_fee string false none none
»» max_op_cu_number string false none none
»» systransfer_amount string false none none
»» op_cu_systransfer_amount string false none none
»» gas_limit string false none none
»» gas_price string false none none

get__token_tokens

GET /token/tokens

Query all tokens.

Example responses

200 Response

[
  {
    "symbol": "hbc",
    "issuer": "",
    "chain": "hbc",
    "type": "2",
    "is_send_enabled": true,
    "is_deposit_enabled": false,
    "is_withdrawal_enabled": false,
    "decimals": "18",
    "total_supply": "0",
    "collect_threshold": "0",
    "deposit_threshold": "0",
    "open_fee": "1000000000000000000",
    "sys_open_fee": "1000000000000000000",
    "withdrawal_fee": "0",
    "max_op_cu_number": "3",
    "systransfer_amount": "0",
    "op_cu_systransfer_amount": "0",
    "gas_limit": "1000000",
    "gas_price": "1"
  }
]

Responses

Status Meaning Description Schema
200 OK OK Inline
500 Internal Server Error Internal Server Error None

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Token] false none none
» symbol string false none none
» issuer string false none none
» chain string false none none
» type string false none none
» is_send_enabled boolean false none none
» is_deposit_enabled boolean false none none
» is_withdrawal_enabled boolean false none none
» decimals string false none none
» total_supply string false none none
» collect_threshold string false none none
» deposit_threshold string false none none
» open_fee string false none none
» sys_open_fee string false none none
» withdrawal_fee string false none none
» max_op_cu_number string false none none
» systransfer_amount string false none none
» op_cu_systransfer_amount string false none none
» gas_limit string false none none
» gas_price string false none none

Order

Order module APIs

get__order_info_{orderId}

GET /order/info/{orderId}

Information of an order

Parameters

Name In Type Required Description
orderId path string true order ID

Example responses

200 Response

{
  "cu_address": "string",
  "id": "string",
  "order_type": 0,
  "symbol": "string",
  "status": 0,
  "key_nodes": [
    "string"
  ],
  "sign_threshold": 0,
  "to": "string",
  "open_fee": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "multi_sign_address": "string"
}

Responses

Status Meaning Description Schema
200 OK OK Order
400 Bad Request Invalid order ID None
500 Internal Server Error Internal Server Error None

DataStructure

CheckTxResult

{
  "code": 0,
  "data": "data",
  "log": "log",
  "gas_used": 5000,
  "gas_wanted": 10000,
  "info": "info",
  "tags": [
    "",
    ""
  ]
}

Properties

Name Type Required Restrictions Description
code integer false none none
data string false none none
gas_used integer false none none
gas_wanted integer false none none
info string false none none
log string false none none
tags [KVPair] false none none

DeliverTxResult

{
  "code": 5,
  "data": "data",
  "log": "log",
  "gas_used": 5000,
  "gas_wanted": 10000,
  "info": "info",
  "tags": [
    "",
    ""
  ]
}

Properties

Name Type Required Restrictions Description
code integer false none none
data string false none none
gas_used integer false none none
gas_wanted integer false none none
info string false none none
log string false none none
tags [KVPair] false none none

BroadcastTxCommitResult

{
  "check_tx": {
    "code": 0,
    "data": "data",
    "log": "log",
    "gas_used": 5000,
    "gas_wanted": 10000,
    "info": "info",
    "tags": [
      "",
      ""
    ]
  },
  "deliver_tx": {
    "code": 5,
    "data": "data",
    "log": "log",
    "gas_used": 5000,
    "gas_wanted": 10000,
    "info": "info",
    "tags": [
      "",
      ""
    ]
  },
  "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "height": 0
}

Properties

Name Type Required Restrictions Description
check_tx CheckTxResult false none none
deliver_tx DeliverTxResult false none none
hash Hash false none none
height integer false none none

KVPair

{
  "key": "string",
  "value": "string"
}

Properties

Name Type Required Restrictions Description
key string false none none
value string false none none

Msg

"string"

Properties

Name Type Required Restrictions Description
anonymous string false none none

Address

"HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa"

base58 encoded address

Properties

Name Type Required Restrictions Description
anonymous string false none base58 encoded address

ValidatorAddress

"hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx"

bech32 encoded address

Properties

Name Type Required Restrictions Description
anonymous string false none bech32 encoded address

Coin

{
  "denom": "stake",
  "amount": "50"
}

Properties

Name Type Required Restrictions Description
denom string false none none
amount string false none none

Hash

"EE5F3404034C524501629B56E0DDC38FAD651F04"

Properties

Name Type Required Restrictions Description
anonymous string false none none

TxQuery

{
  "hash": "D085138D913993919295FF4B0A9107F1F2CDE0D37A87CE0644E217CBF3B49656",
  "height": 368,
  "tx": {
    "msg": [
      "string"
    ],
    "fee": {
      "gas": "string",
      "amount": [
        {
          "denom": "stake",
          "amount": "50"
        }
      ]
    },
    "memo": "string",
    "signature": {
      "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
      "pub_key": {
        "type": "tendermint/PubKeySecp256k1",
        "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
      },
      "account_number": "0",
      "sequence": "0"
    }
  },
  "result": {
    "log": "string",
    "gas_wanted": "200000",
    "gas_used": "26354",
    "tags": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  }
}

Properties

Name Type Required Restrictions Description
hash string false none none
height number false none none
tx StdTx false none none
result object false none none
» log string false none none
» gas_wanted string false none none
» gas_used string false none none
» tags [KVPair] false none none

StdTx

{
  "msg": [
    "string"
  ],
  "fee": {
    "gas": "string",
    "amount": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ]
  },
  "memo": "string",
  "signature": {
    "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
    "pub_key": {
      "type": "tendermint/PubKeySecp256k1",
      "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
    },
    "account_number": "0",
    "sequence": "0"
  }
}

Properties

Name Type Required Restrictions Description
msg [Msg] false none none
fee object false none none
» gas string false none none
» amount [Coin] false none none
memo string false none none
signature object false none none
» signature string false none none
» pub_key object false none none
»» type string false none none
»» value string false none none
» account_number string false none none
» sequence string false none none

BlockID

{
  "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "parts": {
    "total": 0,
    "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
  }
}

Properties

Name Type Required Restrictions Description
hash Hash false none none
parts object false none none
» total number false none none
» hash Hash false none none

BlockHeader

{
  "chain_id": "hbtc-testnet",
  "height": 1,
  "time": "2017-12-30T05:53:09.287+01:00",
  "num_txs": 0,
  "last_block_id": {
    "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "parts": {
      "total": 0,
      "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
    }
  },
  "total_txs": 35,
  "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
  "version": {
    "block": 10,
    "app": 0
  }
}

Properties

Name Type Required Restrictions Description
chain_id string false none none
height number false none none
time string false none none
num_txs number false none none
last_block_id BlockID false none none
total_txs number false none none
last_commit_hash Hash false none none
data_hash Hash false none none
validators_hash Hash false none none
next_validators_hash Hash false none none
consensus_hash Hash false none none
app_hash Hash false none none
last_results_hash Hash false none none
evidence_hash Hash false none none
proposer_address Address false none base58 encoded address
version object false none none
» block string false none none
» app string false none none

Block

{
  "header": {
    "chain_id": "hbtc-testnet",
    "height": 1,
    "time": "2017-12-30T05:53:09.287+01:00",
    "num_txs": 0,
    "last_block_id": {
      "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "parts": {
        "total": 0,
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
      }
    },
    "total_txs": 35,
    "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
    "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
    "version": {
      "block": 10,
      "app": 0
    }
  },
  "txs": [
    "string"
  ],
  "evidence": [
    "string"
  ],
  "last_commit": {
    "block_id": {
      "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "parts": {
        "total": 0,
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
      }
    },
    "precommits": [
      {
        "validator_address": "string",
        "validator_index": "0",
        "height": "0",
        "round": "0",
        "timestamp": "2017-12-30T05:53:09.287+01:00",
        "type": 2,
        "block_id": {
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
          "parts": {
            "total": 0,
            "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
          }
        },
        "signature": "7uTC74QlknqYWEwg7Vn6M8Om7FuZ0EO4bjvuj6rwH1mTUJrRuMMZvAAqT9VjNgP0RA/TDp6u/92AqrZfXJSpBQ=="
      }
    ]
  }
}

Properties

Name Type Required Restrictions Description
header BlockHeader false none none
txs [string] false none none
evidence [string] false none none
last_commit object false none none
» block_id BlockID false none none
» precommits [object] false none none
»» validator_address string false none none
»» validator_index string false none none
»» height string false none none
»» round string false none none
»» timestamp string false none none
»» type number false none none
»» block_id BlockID false none none
»» signature string false none none

BlockQuery

{
  "block_meta": {
    "header": {
      "chain_id": "hbtc-testnet",
      "height": 1,
      "time": "2017-12-30T05:53:09.287+01:00",
      "num_txs": 0,
      "last_block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "total_txs": 35,
      "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
      "version": {
        "block": 10,
        "app": 0
      }
    },
    "block_id": {
      "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "parts": {
        "total": 0,
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
      }
    }
  },
  "block": {
    "header": {
      "chain_id": "hbtc-testnet",
      "height": 1,
      "time": "2017-12-30T05:53:09.287+01:00",
      "num_txs": 0,
      "last_block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "total_txs": 35,
      "last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
      "proposer_address": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
      "version": {
        "block": 10,
        "app": 0
      }
    },
    "txs": [
      "string"
    ],
    "evidence": [
      "string"
    ],
    "last_commit": {
      "block_id": {
        "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
        "parts": {
          "total": 0,
          "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
        }
      },
      "precommits": [
        {
          "validator_address": "string",
          "validator_index": "0",
          "height": "0",
          "round": "0",
          "timestamp": "2017-12-30T05:53:09.287+01:00",
          "type": 2,
          "block_id": {
            "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
            "parts": {
              "total": 0,
              "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
            }
          },
          "signature": "7uTC74QlknqYWEwg7Vn6M8Om7FuZ0EO4bjvuj6rwH1mTUJrRuMMZvAAqT9VjNgP0RA/TDp6u/92AqrZfXJSpBQ=="
        }
      ]
    }
  }
}

Properties

Name Type Required Restrictions Description
block_meta object false none none
» header BlockHeader false none none
» block_id BlockID false none none
block Block false none none

DelegationDelegatorReward

{
  "validator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "reward": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Properties

Name Type Required Restrictions Description
validator_address ValidatorAddress false none bech32 encoded address
reward [Coin] false none none

DelegatorTotalRewards

{
  "rewards": [
    {
      "validator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
      "reward": [
        {
          "denom": "stake",
          "amount": "50"
        }
      ]
    }
  ],
  "total": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Properties

Name Type Required Restrictions Description
rewards [DelegationDelegatorReward] false none none
total [Coin] false none none

BaseReq

{
  "from": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa",
  "memo": "Sent via hbtcchain 🚀",
  "chain_id": "hbtc-testnet",
  "account_number": "0",
  "sequence": "1",
  "gas": "200000",
  "gas_adjustment": "1.2",
  "fees": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "simulate": false
}

Properties

Name Type Required Restrictions Description
from string false none Sender address or Keybase name to generate a transaction
memo string false none none
chain_id string false none none
account_number string false none none
sequence string false none none
gas string false none none
gas_adjustment string false none none
fees [Coin] false none none
simulate boolean false none Estimate gas for a transaction (cannot be used in conjunction with generate_only)

TendermintValidator

{
  "address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "pub_key": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
  "voting_power": "1000",
  "proposer_priority": "1000"
}

Properties

Name Type Required Restrictions Description
address ValidatorAddress false none bech32 encoded address
pub_key string false none none
voting_power string false none none
proposer_priority string false none none

TextProposal

{
  "proposal_id": 0,
  "title": "string",
  "description": "string",
  "proposal_type": "string",
  "proposal_status": "string",
  "final_tally_result": {
    "yes": "0.0000000000",
    "abstain": "0.0000000000",
    "no": "0.0000000000",
    "no_with_veto": "0.0000000000"
  },
  "submit_time": "string",
  "total_deposit": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "voting_start_time": "string"
}

Properties

Name Type Required Restrictions Description
proposal_id integer false none none
title string false none none
description string false none none
proposal_type string false none none
proposal_status string false none none
final_tally_result TallyResult false none none
submit_time string false none none
total_deposit [Coin] false none none
voting_start_time string false none none

Proposer

{
  "proposal_id": "string",
  "proposer": "string"
}

Properties

Name Type Required Restrictions Description
proposal_id string false none none
proposer string false none none

Deposit

{
  "amount": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "proposal_id": "string",
  "depositor": "HBCTxmVA5pjFxUgU2UEzWipuDw1K2XaEzuKa"
}

Properties

Name Type Required Restrictions Description
amount [Coin] false none none
proposal_id string false none none
depositor Address false none base58 encoded address

TallyResult

{
  "yes": "0.0000000000",
  "abstain": "0.0000000000",
  "no": "0.0000000000",
  "no_with_veto": "0.0000000000"
}

Properties

Name Type Required Restrictions Description
yes string false none none
abstain string false none none
no string false none none
no_with_veto string false none none

CUKeyGen

{
  "FromCU": "string",
  "ToCU": "string",
  "OrderID": "string",
  "Symobl": "string"
}

Properties

Name Type Required Restrictions Description
FromCU string false none none
ToCU string false none none
OrderID string false none none
Symobl string false none none

CUDeposit

{
  "FromCU": "string",
  "ToCU": "string",
  "ToAddr": "string",
  "Symobl": "string",
  "Amount": 0,
  "TxHash": "string",
  "Index": 0,
  "Height": 0,
  "OrderID": "string",
  "Memo": "string"
}

Properties

Name Type Required Restrictions Description
FromCU string false none none
ToCU string false none none
ToAddr string false none none
Symobl string false none none
Amount number false none none
TxHash string false none none
Index number false none none
Height number false none none
OrderID string false none none
Memo string false none none

CUWithdrawal

{
  "FromCU": "string",
  "ToAddr": "string",
  "Symobl": "string",
  "Amount": 0,
  "GasFee": 0,
  "OrderID": "string"
}

Properties

Name Type Required Restrictions Description
FromCU string false none none
ToAddr string false none none
Symobl string false none none
Amount number false none none
GasFee number false none none
OrderID string false none none

Vote

{
  "voter": "string",
  "proposal_id": "string",
  "option": "string"
}

Properties

Name Type Required Restrictions Description
voter string false none none
proposal_id string false none none
option string false none none

Validator

{
  "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "consensus_pubkey": "hbcvalconspub1zcjduepq6f9zhhlwne7gkx0yrpg3ff3xe4yl6eu977mjjexlf5jjspjq26zqmyekwd",
  "jailed": true,
  "status": 0,
  "tokens": "string",
  "delegator_shares": "string",
  "description": {
    "moniker": "string",
    "identity": "string",
    "website": "string",
    "details": "string"
  },
  "bond_height": "0",
  "bond_intra_tx_counter": 0,
  "unbonding_height": "0",
  "unbonding_time": "1970-01-01T00:00:00Z",
  "commission": {
    "rate": "0",
    "max_rate": "0",
    "max_change_rate": "0",
    "update_time": "1970-01-01T00:00:00Z"
  }
}

Properties

Name Type Required Restrictions Description
operator_address ValidatorAddress false none bech32 encoded address
consensus_pubkey string false none none
jailed boolean false none none
status integer false none none
tokens string false none none
delegator_shares string false none none
description object false none none
» moniker string false none none
» identity string false none none
» website string false none none
» details string false none none
bond_height string false none none
bond_intra_tx_counter integer false none none
unbonding_height string false none none
unbonding_time string false none none
commission object false none none
» rate string false none none
» max_rate string false none none
» max_change_rate string false none none
» update_time string false none none

Delegation

{
  "delegator_address": "string",
  "validator_address": "string",
  "shares": "string",
  "height": 0
}

Properties

Name Type Required Restrictions Description
delegator_address string false none none
validator_address string false none none
shares string false none none
height integer false none none

UnbondingDelegationPair

{
  "delegator_address": "string",
  "validator_address": "string",
  "entries": [
    {
      "initial_balance": "string",
      "balance": "string",
      "creation_height": "string",
      "min_time": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
delegator_address string false none none
validator_address string false none none
entries [UnbondingEntries] false none none

UnbondingEntries

{
  "initial_balance": "string",
  "balance": "string",
  "creation_height": "string",
  "min_time": "string"
}

Properties

Name Type Required Restrictions Description
initial_balance string false none none
balance string false none none
creation_height string false none none
min_time string false none none

UnbondingDelegation

{
  "delegator_address": "string",
  "validator_address": "string",
  "initial_balance": "string",
  "balance": "string",
  "creation_height": 0,
  "min_time": 0
}

Properties

Name Type Required Restrictions Description
delegator_address string false none none
validator_address string false none none
initial_balance string false none none
balance string false none none
creation_height integer false none none
min_time integer false none none

Redelegation

{
  "delegator_address": "string",
  "validator_src_address": "string",
  "validator_dst_address": "string",
  "entries": [
    null
  ]
}

Properties

Name Type Required Restrictions Description
delegator_address string false none none
validator_src_address string false none none
validator_dst_address string false none none
entries [Redelegation] false none none

RedelegationEntry

{
  "creation_height": 0,
  "completion_time": 0,
  "initial_balance": "string",
  "balance": "string",
  "shares_dst": "string"
}

Properties

Name Type Required Restrictions Description
creation_height integer false none none
completion_time integer false none none
initial_balance string false none none
balance string false none none
shares_dst string false none none

ValidatorDistInfo

{
  "operator_address": "hbcvaloper1we2ufxj2wpanrhzd2h7upw07hffudxfw472txx",
  "self_bond_rewards": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "val_commission": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Properties

Name Type Required Restrictions Description
operator_address ValidatorAddress false none bech32 encoded address
self_bond_rewards [Coin] false none none
val_commission [Coin] false none none

PublicKey

{
  "type": "string",
  "value": "string"
}

Properties

Name Type Required Restrictions Description
type string false none none
value string false none none

SigningInfo

{
  "start_height": "string",
  "index_offset": "string",
  "jailed_until": "string",
  "missed_blocks_counter": "string"
}

Properties

Name Type Required Restrictions Description
start_height string false none none
index_offset string false none none
jailed_until string false none none
missed_blocks_counter string false none none

ParamChange

{
  "subspace": "staking",
  "key": "MaxValidators",
  "subkey": "",
  "value": {}
}

Properties

Name Type Required Restrictions Description
subspace string false none none
key string false none none
subkey string false none none
value object false none none

Supply

{
  "total": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ]
}

Properties

Name Type Required Restrictions Description
total [Coin] false none none

Token

{
  "symbol": "hbc",
  "issuer": "",
  "chain": "hbc",
  "type": "2",
  "is_send_enabled": true,
  "is_deposit_enabled": false,
  "is_withdrawal_enabled": false,
  "decimals": "18",
  "total_supply": "0",
  "collect_threshold": "0",
  "deposit_threshold": "0",
  "open_fee": "1000000000000000000",
  "sys_open_fee": "1000000000000000000",
  "withdrawal_fee": "0",
  "max_op_cu_number": "3",
  "systransfer_amount": "0",
  "op_cu_systransfer_amount": "0",
  "gas_limit": "1000000",
  "gas_price": "1"
}

Properties

Name Type Required Restrictions Description
symbol string false none none
issuer string false none none
chain string false none none
type string false none none
is_send_enabled boolean false none none
is_deposit_enabled boolean false none none
is_withdrawal_enabled boolean false none none
decimals string false none none
total_supply string false none none
collect_threshold string false none none
deposit_threshold string false none none
open_fee string false none none
sys_open_fee string false none none
withdrawal_fee string false none none
max_op_cu_number string false none none
systransfer_amount string false none none
op_cu_systransfer_amount string false none none
gas_limit string false none none
gas_price string false none none

Order

{
  "cu_address": "string",
  "id": "string",
  "order_type": 0,
  "symbol": "string",
  "status": 0,
  "key_nodes": [
    "string"
  ],
  "sign_threshold": 0,
  "to": "string",
  "open_fee": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "multi_sign_address": "string"
}

Properties

oneOf

Name Type Required Restrictions Description
anonymous OrderKeyGen false none none

xor

Name Type Required Restrictions Description
anonymous OrderCollect false none none

xor

Name Type Required Restrictions Description
anonymous OrderWithdrawal false none none

xor

Name Type Required Restrictions Description
anonymous OrderSysTransfer false none none

OrderKeyGen

{
  "cu_address": "string",
  "id": "string",
  "order_type": 0,
  "symbol": "string",
  "status": 0,
  "key_nodes": [
    "string"
  ],
  "sign_threshold": 0,
  "to": "string",
  "open_fee": [
    {
      "denom": "stake",
      "amount": "50"
    }
  ],
  "multi_sign_address": "string"
}

Properties

Name Type Required Restrictions Description
cu_address string false none none
id string false none none
order_type number false none none
symbol string false none none
status number false none none
key_nodes [string] false none none
sign_threshold number false none none
to string false none none
open_fee [Coin] false none none
multi_sign_address string false none none

OrderCollect

{
  "cu_address": "string",
  "id": "string",
  "order_type": 0,
  "symbol": "string",
  "status": 0,
  "collect_from_cu": "string",
  "collect_from_address": "string",
  "collect_to_cu": "string",
  "amount": "string",
  "gas_price": "string",
  "gas_limit": "string",
  "tx_hash": "string",
  "height": 0,
  "index": 0,
  "memo": "string",
  "raw_data": "string",
  "signed_Tx": "string",
  "ext_txhash": "string",
  "depositstatus": 0,
  "validnodes": [
    "string"
  ],
  "invalidnodes": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
cu_address string false none none
id string false none none
order_type number false none none
symbol string false none none
status number false none none
collect_from_cu string false none none
collect_from_address string false none none
collect_to_cu string false none none
amount string false none none
gas_price string false none none
gas_limit string false none none
tx_hash string false none none
height number false none none
index number false none none
memo string false none none
raw_data string false none none
signed_Tx string false none none
ext_txhash string false none none
depositstatus number false none none
validnodes [string] false none none
invalidnodes [string] false none none

OrderWithdrawal

{
  "cu_address": "string",
  "id": "string",
  "order_type": 0,
  "symbol": "string",
  "status": 0,
  "amount": "string",
  "gas_fee": "string",
  "cost_fee": "string",
  "withdraw_to_address": "string",
  "opcu_address": "string",
  "tx_hash": "string",
  "raw_data": "string",
  "signed_tx": "string"
}

Properties

Name Type Required Restrictions Description
cu_address string false none none
id string false none none
order_type number false none none
symbol string false none none
status number false none none
amount string false none none
gas_fee string false none none
cost_fee string false none none
withdraw_to_address string false none none
opcu_address string false none none
tx_hash string false none none
raw_data string false none none
signed_tx string false none none

OrderSysTransfer

{
  "cu_address": "string",
  "id": "string",
  "order_type": 0,
  "symbol": "string",
  "status": 0,
  "amount": "string",
  "cost_fee": "string",
  "to_cu": "string",
  "to_address": "string",
  "opcu_address": "string",
  "tx_hash": "string",
  "raw_data": "string",
  "signed_tx": "string"
}

Properties

Name Type Required Restrictions Description
cu_address string false none none
id string false none none
order_type number false none none
symbol string false none none
status number false none none
amount string false none none
cost_fee string false none none
to_cu string false none none
to_address string false none none
opcu_address string false none none
tx_hash string false none none
raw_data string false none none
signed_tx string false none none