Terp Network API | Terp Network Docs

Balance queries the number of NFTs of a given class owned by the owner, same as balanceOf in ERC721

Path Parameters

owner*string

owner is the owner address of the nft

class_id*string

class_id associated with the nft

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/balance/string/string"

{
  "amount": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Classes queries all NFT classes

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/classes"

{
  "classes": [
    {
      "id": "string",
      "name": "string",
      "symbol": "string",
      "description": "string",
      "uri": "string",
      "uri_hash": "string",
      "data": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Class queries an NFT class based on its id

Path Parameters

class_id*string

class_id associated with the nft

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/classes/string"

{
  "class": {
    "id": "string",
    "name": "string",
    "symbol": "string",
    "description": "string",
    "uri": "string",
    "uri_hash": "string",
    "data": {
      "type_url": "string",
      "value": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

NFTs queries all NFTs of a given class or owner,choose at least one of the two, similar to tokenByIndex in ERC721Enumerable

Query Parameters

class_id?string

class_id associated with the nft.

owner?string

owner is the owner address of the nft.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/nfts"

{
  "nfts": [
    {
      "class_id": "string",
      "id": "string",
      "uri": "string",
      "uri_hash": "string",
      "data": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

NFT queries an NFT based on its class and id.

Path Parameters

class_id*string

class_id associated with the nft

id*string

id is a unique identifier of the NFT

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/nfts/string/string"

{
  "nft": {
    "class_id": "string",
    "id": "string",
    "uri": "string",
    "uri_hash": "string",
    "data": {
      "type_url": "string",
      "value": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Owner queries the owner of the NFT based on its class and id, same as ownerOf in ERC721

Path Parameters

class_id*string

class_id associated with the nft

id*string

id is a unique identifier of the NFT

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/owner/string/string"

{
  "owner": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Supply queries the number of NFTs from the given class, same as totalSupply of ERC721.

Path Parameters

class_id*string

class_id associated with the nft

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/nft/v1beta1/supply/string"

{
  "amount": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AccountInfo queries account info which is common to all account types.

Path Parameters

address*string

address is the account address string.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/account_info/string"

{
  "info": {
    "address": "string",
    "pub_key": {
      "type_url": "string",
      "value": "string"
    },
    "account_number": "string",
    "sequence": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Accounts returns all the existing accounts.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/accounts"

{
  "accounts": [
    {
      "type_url": "string",
      "value": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Account returns account details based on address.

Path Parameters

address*string

address defines the address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/accounts/string"

{
  "account": {
    "type_url": "string",
    "value": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AccountAddressByID returns account address based on account number.

Path Parameters

id*string

Deprecated, use account_id instead

id is the account number of the address to be queried. This field should have been an uint64 (like all account numbers), and will be updated to uint64 in a future version of the auth query.

Formatint64

Query Parameters

account_id?string

account_id is the account number of the address to be queried.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/address_by_id/string"

{
  "account_address": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Bech32Prefix queries bech32Prefix

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/bech32"

{
  "bech32_prefix": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AddressBytesToString converts Account Address bytes to string

Path Parameters

address_bytes*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/bech32/string"

{
  "address_string": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AddressStringToBytes converts Address string to bytes

Path Parameters

address_string*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/bech32/string"

{
  "address_bytes": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ModuleAccounts returns all the existing module accounts.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/module_accounts"

{
  "accounts": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ModuleAccountByName returns the module account info by module name

Path Parameters

name*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/module_accounts/string"

{
  "account": {
    "type_url": "string",
    "value": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries all parameters.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/auth/v1beta1/params"

{
  "params": {
    "max_memo_characters": "string",
    "tx_sig_limit": "string",
    "tx_size_cost_per_byte": "string",
    "sig_verify_cost_ed25519": "string",
    "sig_verify_cost_secp256k1": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupInfo queries group info based on group id.

Path Parameters

group_id*string

group_id is the unique ID of the group.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/group_info/string"

{
  "info": {
    "id": "string",
    "admin": "string",
    "metadata": "string",
    "version": "string",
    "total_weight": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupMembers queries members of a group by group id.

Path Parameters

group_id*string

group_id is the unique ID of the group.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/group_members/string"

{
  "members": [
    {
      "group_id": "string",
      "member": {
        "address": "string",
        "weight": "string",
        "metadata": "string",
        "added_at": "2019-08-24T14:15:22Z"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupPoliciesByAdmin queries group policies by admin address.

Path Parameters

admin*string

admin is the admin address of the group policy.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/group_policies_by_admin/string"

{
  "group_policies": [
    {
      "address": "string",
      "group_id": "string",
      "admin": "string",
      "metadata": "string",
      "version": "string",
      "decision_policy": {
        "type_url": "string",
        "value": "string"
      },
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupPoliciesByGroup queries group policies by group id.

Path Parameters

group_id*string

group_id is the unique ID of the group policy's group.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/group_policies_by_group/string"

{
  "group_policies": [
    {
      "address": "string",
      "group_id": "string",
      "admin": "string",
      "metadata": "string",
      "version": "string",
      "decision_policy": {
        "type_url": "string",
        "value": "string"
      },
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupPolicyInfo queries group policy info based on account address of group policy.

Path Parameters

address*string

address is the account address of the group policy.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/group_policy_info/string"

{
  "info": {
    "address": "string",
    "group_id": "string",
    "admin": "string",
    "metadata": "string",
    "version": "string",
    "decision_policy": {
      "type_url": "string",
      "value": "string"
    },
    "created_at": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Groups queries all groups in state.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/groups"

{
  "groups": [
    {
      "id": "string",
      "admin": "string",
      "metadata": "string",
      "version": "string",
      "total_weight": "string",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupsByAdmin queries groups by admin address.

Path Parameters

admin*string

admin is the account address of a group's admin.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/groups_by_admin/string"

{
  "groups": [
    {
      "id": "string",
      "admin": "string",
      "metadata": "string",
      "version": "string",
      "total_weight": "string",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GroupsByMember queries groups by member address.

Path Parameters

address*string

address is the group member address.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/groups_by_member/string"

{
  "groups": [
    {
      "id": "string",
      "admin": "string",
      "metadata": "string",
      "version": "string",
      "total_weight": "string",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Proposal queries a proposal based on proposal id.

Path Parameters

proposal_id*string

proposal_id is the unique ID of a proposal.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/proposal/string"

{
  "proposal": {
    "id": "string",
    "group_policy_address": "string",
    "metadata": "string",
    "proposers": [
      "string"
    ],
    "submit_time": "2019-08-24T14:15:22Z",
    "group_version": "string",
    "group_policy_version": "string",
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes_count": "string",
      "abstain_count": "string",
      "no_count": "string",
      "no_with_veto_count": "string"
    },
    "voting_period_end": "2019-08-24T14:15:22Z",
    "executor_result": "PROPOSAL_EXECUTOR_RESULT_UNSPECIFIED",
    "messages": [
      {
        "type_url": "string",
        "value": "string"
      }
    ],
    "title": "string",
    "summary": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TallyResult returns the tally result of a proposal. If the proposal is still in voting period, then this query computes the current tally state, which might not be final. On the other hand, if the proposal is final, then it simply returns the `final_tally_result` state stored in the proposal itself.

Path Parameters

proposal_id*string

proposal_id is the unique id of a proposal.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/proposals/string/tally"

{
  "tally": {
    "yes_count": "string",
    "abstain_count": "string",
    "no_count": "string",
    "no_with_veto_count": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ProposalsByGroupPolicy queries proposals based on account address of group policy.

Path Parameters

address*string

address is the account address of the group policy related to proposals.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/proposals_by_group_policy/string"

{
  "proposals": [
    {
      "id": "string",
      "group_policy_address": "string",
      "metadata": "string",
      "proposers": [
        "string"
      ],
      "submit_time": "2019-08-24T14:15:22Z",
      "group_version": "string",
      "group_policy_version": "string",
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes_count": "string",
        "abstain_count": "string",
        "no_count": "string",
        "no_with_veto_count": "string"
      },
      "voting_period_end": "2019-08-24T14:15:22Z",
      "executor_result": "PROPOSAL_EXECUTOR_RESULT_UNSPECIFIED",
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "title": "string",
      "summary": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

VoteByProposalVoter queries a vote by proposal id and voter.

Path Parameters

proposal_id*string

proposal_id is the unique ID of a proposal.

Formatuint64

voter*string

voter is a proposal voter account address.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/vote_by_proposal_voter/string/string"

{
  "vote": {
    "proposal_id": "string",
    "voter": "string",
    "option": "VOTE_OPTION_UNSPECIFIED",
    "metadata": "string",
    "submit_time": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

VotesByProposal queries a vote by proposal id.

Path Parameters

proposal_id*string

proposal_id is the unique ID of a proposal.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/votes_by_proposal/string"

{
  "votes": [
    {
      "proposal_id": "string",
      "voter": "string",
      "option": "VOTE_OPTION_UNSPECIFIED",
      "metadata": "string",
      "submit_time": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

VotesByVoter queries a vote by voter.

Path Parameters

voter*string

voter is a proposal voter account address.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/group/v1/votes_by_voter/string"

{
  "votes": [
    {
      "proposal_id": "string",
      "voter": "string",
      "option": "VOTE_OPTION_UNSPECIFIED",
      "metadata": "string",
      "submit_time": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AllBalances queries the balance of all coins for a single account.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

address*string

address is the address to query balances for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

resolve_denom?boolean

resolve_denom is the flag to resolve the denom into a human-readable form from the metadata.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/balances/string"

{
  "balances": [
    {
      "denom": "string",
      "amount": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Balance queries the balance of a single coin for a single account.

Path Parameters

address*string

address is the address to query balances for.

Query Parameters

denom?string

denom is the coin denom to query balances for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/balances/string/by_denom"

{
  "balance": {
    "denom": "string",
    "amount": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomOwners queries for all account addresses that own a particular token denomination.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

denom*string

denom defines the coin denomination to query all account holders for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/denom_owners/string"

{
  "denom_owners": [
    {
      "address": "string",
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomOwnersByQuery queries for all account addresses that own a particular token denomination.

Query Parameters

denom?string

denom defines the coin denomination to query all account holders for.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/denom_owners_by_query"

{
  "denom_owners": [
    {
      "address": "string",
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomsMetadata queries the client metadata for all registered coin denominations.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/denoms_metadata"

{
  "metadatas": [
    {
      "description": "string",
      "denom_units": [
        {
          "denom": "string",
          "exponent": 0,
          "aliases": [
            "string"
          ]
        }
      ],
      "base": "string",
      "display": "string",
      "name": "string",
      "symbol": "string",
      "uri": "string",
      "uri_hash": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomMetadata queries the client metadata of a given coin denomination.

Path Parameters

denom*string

denom is the coin denom to query the metadata for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/denoms_metadata/string"

{
  "metadata": {
    "description": "string",
    "denom_units": [
      {
        "denom": "string",
        "exponent": 0,
        "aliases": [
          "string"
        ]
      }
    ],
    "base": "string",
    "display": "string",
    "name": "string",
    "symbol": "string",
    "uri": "string",
    "uri_hash": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomMetadataByQueryString queries the client metadata of a given coin denomination.

Query Parameters

denom?string

denom is the coin denom to query the metadata for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/denoms_metadata_by_query_string"

{
  "metadata": {
    "description": "string",
    "denom_units": [
      {
        "denom": "string",
        "exponent": 0,
        "aliases": [
          "string"
        ]
      }
    ],
    "base": "string",
    "display": "string",
    "name": "string",
    "symbol": "string",
    "uri": "string",
    "uri_hash": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries the parameters of x/bank module.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/params"

{
  "params": {
    "send_enabled": [
      {
        "denom": "string",
        "enabled": true
      }
    ],
    "default_send_enabled": true
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SendEnabled queries for SendEnabled entries.

This query only returns denominations that have specific SendEnabled settings. Any denomination that does not have a specific setting will use the default params.default_send_enabled, and will not be returned by this query.

Query Parameters

denoms?array<>

denoms is the specific denoms you want look up. Leave empty to get all entries.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/send_enabled"

{
  "send_enabled": [
    {
      "denom": "string",
      "enabled": true
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SpendableBalances queries the spendable balance of all coins for a single account.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

address*string

address is the address to query spendable balances for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/spendable_balances/string"

{
  "balances": [
    {
      "denom": "string",
      "amount": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SpendableBalanceByDenom queries the spendable balance of a single denom for a single account.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

address*string

address is the address to query balances for.

Query Parameters

denom?string

denom is the coin denom to query balances for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/spendable_balances/string/by_denom"

{
  "balance": {
    "denom": "string",
    "amount": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TotalSupply queries the total supply of all coins.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/supply"

{
  "supply": [
    {
      "denom": "string",
      "amount": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SupplyOf queries the supply of a single coin.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Query Parameters

denom?string

denom is the coin denom to query balances for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/bank/v1beta1/supply/by_denom"

{
  "amount": {
    "denom": "string",
    "amount": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Account returns account permissions.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/circuit/v1/accounts"

{
  "accounts": [
    {
      "address": "string",
      "permissions": {
        "level": "LEVEL_NONE_UNSPECIFIED",
        "limit_type_urls": [
          "string"
        ]
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Account returns account permissions.

Path Parameters

address*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/circuit/v1/accounts/string"

{
  "permission": {
    "level": "LEVEL_NONE_UNSPECIFIED",
    "limit_type_urls": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DisabledList returns a list of disabled message urls

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/circuit/v1/disable_list"

{
  "disabled_list": [
    "string"
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

CommunityPool queries the community pool coins.

WARNING: This query will fail if an external community pool is used.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/community_pool"

{
  "pool": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegationTotalRewards queries the total rewards accrued by each validator.

Path Parameters

delegator_address*string

delegator_address defines the delegator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/delegators/string/rewards"

{
  "rewards": [
    {
      "validator_address": "string",
      "reward": [
        {
          "denom": "string",
          "amount": "string"
        }
      ]
    }
  ],
  "total": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegationRewards queries the total rewards accrued by a delegation.

Path Parameters

delegator_address*string

delegator_address defines the delegator address to query for.

validator_address*string

validator_address defines the validator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/delegators/string/rewards/string"

{
  "rewards": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegatorValidators queries the validators of a delegator.

Path Parameters

delegator_address*string

delegator_address defines the delegator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/delegators/string/validators"

{
  "validators": [
    "string"
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegatorWithdrawAddress queries withdraw address of a delegator.

Path Parameters

delegator_address*string

delegator_address defines the delegator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/delegators/string/withdraw_address"

{
  "withdraw_address": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries params of the distribution module.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/params"

{
  "params": {
    "community_tax": "string",
    "base_proposer_reward": "string",
    "bonus_proposer_reward": "string",
    "withdraw_addr_enabled": true
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

Path Parameters

validator_address*string

validator_address defines the validator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/validators/string"

{
  "operator_address": "string",
  "self_bond_rewards": [
    {
      "denom": "string",
      "amount": "string"
    }
  ],
  "commission": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ValidatorCommission queries accumulated commission for a validator.

Path Parameters

validator_address*string

validator_address defines the validator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/validators/string/commission"

{
  "commission": {
    "commission": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ValidatorOutstandingRewards queries rewards of a validator address.

Path Parameters

validator_address*string

validator_address defines the validator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/validators/string/outstanding_rewards"

{
  "rewards": {
    "rewards": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ValidatorSlashes queries slash events of a validator.

Path Parameters

validator_address*string

validator_address defines the validator address to query for.

Query Parameters

starting_height?string

starting_height defines the optional starting height to query the slashes.

Formatuint64

ending_height?string

starting_height defines the optional ending height to query the slashes.

Formatuint64

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/distribution/v1beta1/validators/string/slashes"

{
  "slashes": [
    {
      "validator_period": "string",
      "fraction": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TxDecode decodes the transaction.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tx_bytes?string

tx_bytes is the raw transaction.

Response Body

`application/json`

curl -X POST "http://localhost:1317/cosmos/tx/v1beta1/decode" \  -H "Content-Type: application/json" \  -d '{}'

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "unordered": true,
      "timeout_timestamp": "2019-08-24T14:15:22Z",
      "extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "string",
            "value": "string"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": {
              "bitarray": {
                "extra_bits_stored": 0,
                "elems": "string"
              },
              "mode_infos": [
                null
              ]
            }
          },
          "sequence": "string"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "gas_limit": "string",
        "payer": "string",
        "granter": "string"
      },
      "tip": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "tipper": "string"
      }
    },
    "signatures": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

amino_binary?string

Response Body

`application/json`

curl -X POST "http://localhost:1317/cosmos/tx/v1beta1/decode/amino" \  -H "Content-Type: application/json" \  -d '{}'

{
  "amino_json": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TxEncode encodes the transaction.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tx?

tx is the transaction to encode.

Response Body

`application/json`

curl -X POST "http://localhost:1317/cosmos/tx/v1beta1/encode" \  -H "Content-Type: application/json" \  -d '{}'

{
  "tx_bytes": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

amino_json?string

Response Body

`application/json`

curl -X POST "http://localhost:1317/cosmos/tx/v1beta1/encode/amino" \  -H "Content-Type: application/json" \  -d '{}'

{
  "amino_binary": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Simulate simulates executing a transaction for estimating gas usage.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tx?

tx is the transaction to simulate. Deprecated. Send raw tx bytes instead.

tx_bytes?string

tx_bytes is the raw transaction.

Response Body

`application/json`

curl -X POST "http://localhost:1317/cosmos/tx/v1beta1/simulate" \  -H "Content-Type: application/json" \  -d '{}'

{
  "gas_info": {
    "gas_wanted": "string",
    "gas_used": "string"
  },
  "result": {
    "data": "string",
    "log": "string",
    "events": [
      {
        "type": "string",
        "attributes": [
          {
            "key": "string",
            "value": "string",
            "index": true
          }
        ]
      }
    ],
    "msg_responses": [
      {
        "type_url": "string",
        "value": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetTxsEvent fetches txs by event.

Query Parameters

events?array<>

events is the list of transaction event type. Deprecated post v0.47.x: use query instead, which should contain a valid events query.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

order_by?string

ORDER_BY_UNSPECIFIED: ORDER_BY_UNSPECIFIED specifies an unknown sorting order. OrderBy defaults to ASC in this case.
ORDER_BY_ASC: ORDER_BY_ASC defines ascending order
ORDER_BY_DESC: ORDER_BY_DESC defines descending order

Value in"ORDER_BY_UNSPECIFIED" | "ORDER_BY_ASC" | "ORDER_BY_DESC"

page?string

page is the page number to query, starts at 1. If not provided, will default to first page.

Formatuint64

limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

query?string

query defines the transaction event query that is proxied to Tendermint's TxSearch RPC method. The query must be valid.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/tx/v1beta1/txs"

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "memo": "string",
        "timeout_height": "string",
        "unordered": true,
        "timeout_timestamp": "2019-08-24T14:15:22Z",
        "extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "string",
              "value": "string"
            },
            "mode_info": {
              "single": {
                "mode": "SIGN_MODE_UNSPECIFIED"
              },
              "multi": {
                "bitarray": {
                  "extra_bits_stored": 0,
                  "elems": "string"
                },
                "mode_infos": [
                  null
                ]
              }
            },
            "sequence": "string"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "string",
              "amount": "string"
            }
          ],
          "gas_limit": "string",
          "payer": "string",
          "granter": "string"
        },
        "tip": {
          "amount": [
            {
              "denom": "string",
              "amount": "string"
            }
          ],
          "tipper": "string"
        }
      },
      "signatures": [
        "string"
      ]
    }
  ],
  "tx_responses": [
    {
      "height": "string",
      "txhash": "string",
      "codespace": "string",
      "code": 0,
      "data": "string",
      "raw_log": "string",
      "logs": [
        {
          "msg_index": 0,
          "log": "string",
          "events": [
            {
              "type": "string",
              "attributes": [
                {
                  "key": "string",
                  "value": "string"
                }
              ]
            }
          ]
        }
      ],
      "info": "string",
      "gas_wanted": "string",
      "gas_used": "string",
      "tx": {
        "type_url": "string",
        "value": "string"
      },
      "timestamp": "string",
      "events": [
        {
          "type": "string",
          "attributes": [
            {
              "key": "string",
              "value": "string",
              "index": true
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "total": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

BroadcastTx broadcast transaction.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tx_bytes?string

tx_bytes is the raw transaction.

mode?string

BroadcastMode specifies the broadcast mode for the TxService.Broadcast RPC method.

BROADCAST_MODE_UNSPECIFIED: zero-value for mode ordering
BROADCAST_MODE_BLOCK: DEPRECATED: use BROADCAST_MODE_SYNC instead, BROADCAST_MODE_BLOCK is not supported by the SDK from v0.47.x onwards.
BROADCAST_MODE_SYNC: BROADCAST_MODE_SYNC defines a tx broadcasting mode where the client waits for a CheckTx execution response only.
BROADCAST_MODE_ASYNC: BROADCAST_MODE_ASYNC defines a tx broadcasting mode where the client returns immediately.

Default"BROADCAST_MODE_UNSPECIFIED"

Value in"BROADCAST_MODE_UNSPECIFIED" | "BROADCAST_MODE_BLOCK" | "BROADCAST_MODE_SYNC" | "BROADCAST_MODE_ASYNC"

Response Body

`application/json`

curl -X POST "http://localhost:1317/cosmos/tx/v1beta1/txs" \  -H "Content-Type: application/json" \  -d '{}'

{
  "tx_response": {
    "height": "string",
    "txhash": "string",
    "codespace": "string",
    "code": 0,
    "data": "string",
    "raw_log": "string",
    "logs": [
      {
        "msg_index": 0,
        "log": "string",
        "events": [
          {
            "type": "string",
            "attributes": [
              {
                "key": "string",
                "value": "string"
              }
            ]
          }
        ]
      }
    ],
    "info": "string",
    "gas_wanted": "string",
    "gas_used": "string",
    "tx": {
      "type_url": "string",
      "value": "string"
    },
    "timestamp": "string",
    "events": [
      {
        "type": "string",
        "attributes": [
          {
            "key": "string",
            "value": "string",
            "index": true
          }
        ]
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetBlockWithTxs fetches a block with decoded txs.

Path Parameters

height*string

height is the height of the block to query.

Formatint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/tx/v1beta1/txs/block/string"

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "memo": "string",
        "timeout_height": "string",
        "unordered": true,
        "timeout_timestamp": "2019-08-24T14:15:22Z",
        "extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "string",
              "value": "string"
            },
            "mode_info": {
              "single": {
                "mode": "SIGN_MODE_UNSPECIFIED"
              },
              "multi": {
                "bitarray": {
                  "extra_bits_stored": 0,
                  "elems": "string"
                },
                "mode_infos": [
                  null
                ]
              }
            },
            "sequence": "string"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "string",
              "amount": "string"
            }
          ],
          "gas_limit": "string",
          "payer": "string",
          "granter": "string"
        },
        "tip": {
          "amount": [
            {
              "denom": "string",
              "amount": "string"
            }
          ],
          "tipper": "string"
        }
      },
      "signatures": [
        "string"
      ]
    }
  ],
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2019-08-24T14:15:22Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2019-08-24T14:15:22Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2019-08-24T14:15:22Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2019-08-24T14:15:22Z",
          "signature": "string"
        }
      ]
    }
  },
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetTx fetches a tx by hash.

Path Parameters

hash*string

hash is the tx hash to query, encoded as a hex string.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/tx/v1beta1/txs/string"

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "unordered": true,
      "timeout_timestamp": "2019-08-24T14:15:22Z",
      "extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "string",
            "value": "string"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": {
              "bitarray": {
                "extra_bits_stored": 0,
                "elems": "string"
              },
              "mode_infos": [
                null
              ]
            }
          },
          "sequence": "string"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "gas_limit": "string",
        "payer": "string",
        "granter": "string"
      },
      "tip": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "tipper": "string"
      }
    },
    "signatures": [
      "string"
    ]
  },
  "tx_response": {
    "height": "string",
    "txhash": "string",
    "codespace": "string",
    "code": 0,
    "data": "string",
    "raw_log": "string",
    "logs": [
      {
        "msg_index": 0,
        "log": "string",
        "events": [
          {
            "type": "string",
            "attributes": [
              {
                "key": "string",
                "value": "string"
              }
            ]
          }
        ]
      }
    ],
    "info": "string",
    "gas_wanted": "string",
    "gas_used": "string",
    "tx": {
      "type_url": "string",
      "value": "string"
    },
    "timestamp": "string",
    "events": [
      {
        "type": "string",
        "attributes": [
          {
            "key": "string",
            "value": "string",
            "index": true
          }
        ]
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

CurrentEpoch provide current epoch of specified identifier

Query Parameters

identifier?string

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/epochs/v1beta1/current_epoch"

{
  "current_epoch": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

EpochInfos provide running epochInfos

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/epochs/v1beta1/epochs"

{
  "epochs": [
    {
      "identifier": "string",
      "start_time": "2019-08-24T14:15:22Z",
      "duration": "string",
      "current_epoch": "string",
      "current_epoch_start_time": "2019-08-24T14:15:22Z",
      "epoch_counting_started": true,
      "current_epoch_start_height": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

CommunityPool queries the community pool coins.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/protocolpool/v1/community_pool"

{
  "pool": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ContinuousFunds queries all continuous funds in the store.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/protocolpool/v1/continuous_funds"

{
  "continuous_funds": [
    {
      "recipient": "string",
      "percentage": "string",
      "expiry": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ContinuousFund queries a continuous fund by the recipient is is associated with.

Path Parameters

recipient*string

recipient is the recipient address to query unclaimed budget amount for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/protocolpool/v1/continuous_funds/string"

{
  "continuous_fund": {
    "recipient": "string",
    "percentage": "string",
    "expiry": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params returns the total set of x/protocolpool parameters.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/protocolpool/v1/params"

{
  "params": {
    "enabled_distribution_denoms": [
      "string"
    ],
    "distribution_frequency": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegatorDelegations queries all delegations of a given delegator address.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

delegator_addr*string

delegator_addr defines the delegator address to query for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/delegations/string"

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "string",
        "validator_address": "string",
        "shares": "string"
      },
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Redelegations queries redelegations of given address.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

delegator_addr*string

delegator_addr defines the delegator address to query for.

Query Parameters

src_validator_addr?string

src_validator_addr defines the validator address to redelegate from.

dst_validator_addr?string

dst_validator_addr defines the validator address to redelegate to.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/delegators/string/redelegations"

{
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "string",
        "validator_src_address": "string",
        "validator_dst_address": "string",
        "entries": [
          {
            "creation_height": "string",
            "completion_time": "2019-08-24T14:15:22Z",
            "initial_balance": "string",
            "shares_dst": "string",
            "unbonding_id": "string",
            "unbonding_on_hold_ref_count": "string"
          }
        ]
      },
      "entries": [
        {
          "redelegation_entry": {
            "creation_height": "string",
            "completion_time": "2019-08-24T14:15:22Z",
            "initial_balance": "string",
            "shares_dst": "string",
            "unbonding_id": "string",
            "unbonding_on_hold_ref_count": "string"
          },
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

delegator_addr*string

delegator_addr defines the delegator address to query for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/delegators/string/unbonding_delegations"

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2019-08-24T14:15:22Z",
          "initial_balance": "string",
          "balance": "string",
          "unbonding_id": "string",
          "unbonding_on_hold_ref_count": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegatorValidators queries all validators info for given delegator address.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

delegator_addr*string

delegator_addr defines the delegator address to query for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/delegators/string/validators"

{
  "validators": [
    {
      "operator_address": "string",
      "consensus_pubkey": {
        "type_url": "string",
        "value": "string"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "string",
      "delegator_shares": "string",
      "description": {
        "moniker": "string",
        "identity": "string",
        "website": "string",
        "security_contact": "string",
        "details": "string"
      },
      "unbonding_height": "string",
      "unbonding_time": "2019-08-24T14:15:22Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2019-08-24T14:15:22Z"
      },
      "min_self_delegation": "string",
      "unbonding_on_hold_ref_count": "string",
      "unbonding_ids": [
        "string"
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DelegatorValidator queries validator info for given delegator validator pair.

Path Parameters

delegator_addr*string

delegator_addr defines the delegator address to query for.

validator_addr*string

validator_addr defines the validator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/delegators/string/validators/string"

{
  "validator": {
    "operator_address": "string",
    "consensus_pubkey": {
      "type_url": "string",
      "value": "string"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "security_contact": "string",
      "details": "string"
    },
    "unbonding_height": "string",
    "unbonding_time": "2019-08-24T14:15:22Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2019-08-24T14:15:22Z"
    },
    "min_self_delegation": "string",
    "unbonding_on_hold_ref_count": "string",
    "unbonding_ids": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

HistoricalInfo queries the historical info for given height.

Path Parameters

height*string

height defines at which height to query the historical info.

Formatint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/historical_info/string"

{
  "hist": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2019-08-24T14:15:22Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "valset": [
      {
        "operator_address": "string",
        "consensus_pubkey": {
          "type_url": "string",
          "value": "string"
        },
        "jailed": true,
        "status": "BOND_STATUS_UNSPECIFIED",
        "tokens": "string",
        "delegator_shares": "string",
        "description": {
          "moniker": "string",
          "identity": "string",
          "website": "string",
          "security_contact": "string",
          "details": "string"
        },
        "unbonding_height": "string",
        "unbonding_time": "2019-08-24T14:15:22Z",
        "commission": {
          "commission_rates": {
            "rate": "string",
            "max_rate": "string",
            "max_change_rate": "string"
          },
          "update_time": "2019-08-24T14:15:22Z"
        },
        "min_self_delegation": "string",
        "unbonding_on_hold_ref_count": "string",
        "unbonding_ids": [
          "string"
        ]
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Parameters queries the staking parameters.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/params"

{
  "params": {
    "unbonding_time": "string",
    "max_validators": 0,
    "max_entries": 0,
    "historical_entries": 0,
    "bond_denom": "string",
    "min_commission_rate": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Pool queries the pool info.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/pool"

{
  "pool": {
    "not_bonded_tokens": "string",
    "bonded_tokens": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Validators queries all validators that match the given status.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Query Parameters

status?string

status enables to query for validators matching a given status.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators"

{
  "validators": [
    {
      "operator_address": "string",
      "consensus_pubkey": {
        "type_url": "string",
        "value": "string"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "string",
      "delegator_shares": "string",
      "description": {
        "moniker": "string",
        "identity": "string",
        "website": "string",
        "security_contact": "string",
        "details": "string"
      },
      "unbonding_height": "string",
      "unbonding_time": "2019-08-24T14:15:22Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2019-08-24T14:15:22Z"
      },
      "min_self_delegation": "string",
      "unbonding_on_hold_ref_count": "string",
      "unbonding_ids": [
        "string"
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Validator queries validator info for given validator address.

Path Parameters

validator_addr*string

validator_addr defines the validator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators/string"

{
  "validator": {
    "operator_address": "string",
    "consensus_pubkey": {
      "type_url": "string",
      "value": "string"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "security_contact": "string",
      "details": "string"
    },
    "unbonding_height": "string",
    "unbonding_time": "2019-08-24T14:15:22Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2019-08-24T14:15:22Z"
    },
    "min_self_delegation": "string",
    "unbonding_on_hold_ref_count": "string",
    "unbonding_ids": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ValidatorDelegations queries delegate info for given validator.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

validator_addr*string

validator_addr defines the validator address to query for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators/string/delegations"

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "string",
        "validator_address": "string",
        "shares": "string"
      },
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Delegation queries delegate info for given validator delegator pair.

Path Parameters

validator_addr*string

validator_addr defines the validator address to query for.

delegator_addr*string

delegator_addr defines the delegator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators/string/delegations/string"

{
  "delegation_response": {
    "delegation": {
      "delegator_address": "string",
      "validator_address": "string",
      "shares": "string"
    },
    "balance": {
      "denom": "string",
      "amount": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

UnbondingDelegation queries unbonding info for given validator delegator pair.

Path Parameters

validator_addr*string

validator_addr defines the validator address to query for.

delegator_addr*string

delegator_addr defines the delegator address to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators/string/delegations/string/unbonding_delegation"

{
  "unbond": {
    "delegator_address": "string",
    "validator_address": "string",
    "entries": [
      {
        "creation_height": "string",
        "completion_time": "2019-08-24T14:15:22Z",
        "initial_balance": "string",
        "balance": "string",
        "unbonding_id": "string",
        "unbonding_on_hold_ref_count": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Path Parameters

validator_addr*string

validator_addr defines the validator address to query for.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators/string/unbonding_delegations"

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2019-08-24T14:15:22Z",
          "initial_balance": "string",
          "balance": "string",
          "unbonding_id": "string",
          "unbonding_on_hold_ref_count": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries a specific parameter of a module, given its subspace and key.

Query Parameters

subspace?string

subspace defines the module to query the parameter for.

key?string

key defines the key of the parameter in the subspace.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/params/v1beta1/params"

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

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Subspaces queries for all registered subspaces and all keys for a subspace.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/params/v1beta1/subspaces"

{
  "subspaces": [
    {
      "subspace": "string",
      "keys": [
        "string"
      ]
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Returns list of `Authorization`, granted to the grantee by the granter.

Query Parameters

granter?string

grantee?string

msg_type_url?string

Optional, msg_type_url, when set, will query only grants matching given msg type.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/authz/v1beta1/grants"

{
  "grants": [
    {
      "authorization": {
        "type_url": "string",
        "value": "string"
      },
      "expiration": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GranteeGrants returns a list of `GrantAuthorization` by grantee.

Path Parameters

grantee*string

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/authz/v1beta1/grants/grantee/string"

{
  "grants": [
    {
      "granter": "string",
      "grantee": "string",
      "authorization": {
        "type_url": "string",
        "value": "string"
      },
      "expiration": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GranterGrants returns list of `GrantAuthorization`, granted by granter.

Path Parameters

granter*string

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/authz/v1beta1/grants/granter/string"

{
  "grants": [
    {
      "granter": "string",
      "grantee": "string",
      "authorization": {
        "type_url": "string",
        "value": "string"
      },
      "expiration": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries the parameters of slashing module

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/slashing/v1beta1/params"

{
  "params": {
    "signed_blocks_window": "string",
    "min_signed_per_window": "string",
    "downtime_jail_duration": "string",
    "slash_fraction_double_sign": "string",
    "slash_fraction_downtime": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SigningInfos queries signing info of all validators

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/slashing/v1beta1/signing_infos"

{
  "info": [
    {
      "address": "string",
      "start_height": "string",
      "index_offset": "string",
      "jailed_until": "2019-08-24T14:15:22Z",
      "tombstoned": true,
      "missed_blocks_counter": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SigningInfo queries the signing info of given cons address

Path Parameters

cons_address*string

cons_address is the address to query signing info of

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/slashing/v1beta1/signing_infos/string"

{
  "val_signing_info": {
    "address": "string",
    "start_height": "string",
    "index_offset": "string",
    "jailed_until": "2019-08-24T14:15:22Z",
    "tombstoned": true,
    "missed_blocks_counter": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ABCIQuery defines a query handler that supports ABCI queries directly to the application, bypassing Tendermint completely. The ABCI query must contain a valid and supported path, including app, custom, p2p, and store.

Query Parameters

data?string

path?string

height?string

Formatint64

prove?boolean

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/abci_query"

{
  "code": 0,
  "log": "string",
  "info": "string",
  "index": "string",
  "key": "string",
  "value": "string",
  "proof_ops": {
    "ops": [
      {
        "type": "string",
        "key": "string",
        "data": "string"
      }
    ]
  },
  "height": "string",
  "codespace": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetLatestBlock returns the latest block.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/blocks/latest"

{
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2019-08-24T14:15:22Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2019-08-24T14:15:22Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2019-08-24T14:15:22Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2019-08-24T14:15:22Z",
          "signature": "string"
        }
      ]
    }
  },
  "sdk_block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2019-08-24T14:15:22Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2019-08-24T14:15:22Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2019-08-24T14:15:22Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2019-08-24T14:15:22Z",
          "signature": "string"
        }
      ]
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetBlockByHeight queries block for given height.

Path Parameters

height*string

Formatint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/blocks/string"

{
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2019-08-24T14:15:22Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2019-08-24T14:15:22Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2019-08-24T14:15:22Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2019-08-24T14:15:22Z",
          "signature": "string"
        }
      ]
    }
  },
  "sdk_block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2019-08-24T14:15:22Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2019-08-24T14:15:22Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string",
              "extension": "string",
              "extension_signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2019-08-24T14:15:22Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2019-08-24T14:15:22Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2019-08-24T14:15:22Z",
          "signature": "string"
        }
      ]
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetNodeInfo queries the current node info.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/node_info"

{
  "default_node_info": {
    "protocol_version": {
      "p2p": "string",
      "block": "string",
      "app": "string"
    },
    "default_node_id": "string",
    "listen_addr": "string",
    "network": "string",
    "version": "string",
    "channels": "string",
    "moniker": "string",
    "other": {
      "tx_index": "string",
      "rpc_address": "string"
    }
  },
  "application_version": {
    "name": "string",
    "app_name": "string",
    "version": "string",
    "git_commit": "string",
    "build_tags": "string",
    "go_version": "string",
    "build_deps": [
      {
        "path": "string",
        "version": "string",
        "sum": "string"
      }
    ],
    "cosmos_sdk_version": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetSyncing queries node syncing.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/syncing"

{
  "syncing": true
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetLatestValidatorSet queries latest validator-set.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/validatorsets/latest"

{
  "block_height": "string",
  "validators": [
    {
      "address": "string",
      "pub_key": {
        "type_url": "string",
        "value": "string"
      },
      "voting_power": "string",
      "proposer_priority": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

GetValidatorSetByHeight queries validator-set at a given height.

Path Parameters

height*string

Formatint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/tendermint/v1beta1/validatorsets/string"

{
  "block_height": "string",
  "validators": [
    {
      "address": "string",
      "pub_key": {
        "type_url": "string",
        "value": "string"
      },
      "voting_power": "string",
      "proposer_priority": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Config queries for the operator configuration.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/node/v1beta1/config"

{
  "minimum_gas_price": "string",
  "pruning_keep_recent": "string",
  "pruning_interval": "string",
  "halt_height": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Status queries for the node status.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/base/node/v1beta1/status"

{
  "earliest_store_height": "string",
  "height": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "app_hash": "string",
  "validator_hash": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Constitution queries the chain's constitution.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/constitution"

{
  "constitution": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries all parameters of the gov module.

Path Parameters

params_type*string

params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/params/string"

{
  "voting_params": {
    "voting_period": "string"
  },
  "deposit_params": {
    "min_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "max_deposit_period": "string"
  },
  "tally_params": {
    "quorum": "string",
    "threshold": "string",
    "veto_threshold": "string"
  },
  "params": {
    "min_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "max_deposit_period": "string",
    "voting_period": "string",
    "quorum": "string",
    "threshold": "string",
    "veto_threshold": "string",
    "min_initial_deposit_ratio": "string",
    "proposal_cancel_ratio": "string",
    "proposal_cancel_dest": "string",
    "expedited_voting_period": "string",
    "expedited_threshold": "string",
    "expedited_min_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "burn_vote_quorum": true,
    "burn_proposal_deposit_prevote": true,
    "burn_vote_veto": true,
    "min_deposit_ratio": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Proposals queries all proposals based on given status.

Query Parameters

proposal_status?string

proposal_status defines the status of the proposals.

PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status.
PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.

Value in

"PROPOSAL_STATUS_UNSPECIFIED" | "PROPOSAL_STATUS_DEPOSIT_PERIOD" | "PROPOSAL_STATUS_VOTING_PERIOD" | "PROPOSAL_STATUS_PASSED" | "PROPOSAL_STATUS_REJECTED" | "PROPOSAL_STATUS_FAILED"

voter?string

voter defines the voter address for the proposals.

depositor?string

depositor defines the deposit addresses from the proposals.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals"

{
  "proposals": [
    {
      "id": "string",
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes_count": "string",
        "abstain_count": "string",
        "no_count": "string",
        "no_with_veto_count": "string"
      },
      "submit_time": "2019-08-24T14:15:22Z",
      "deposit_end_time": "2019-08-24T14:15:22Z",
      "total_deposit": [
        {
          "denom": "string",
          "amount": "string"
        }
      ],
      "voting_start_time": "2019-08-24T14:15:22Z",
      "voting_end_time": "2019-08-24T14:15:22Z",
      "metadata": "string",
      "title": "string",
      "summary": "string",
      "proposer": "string",
      "expedited": true,
      "failed_reason": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Proposal queries proposal details based on ProposalID.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals/string"

{
  "proposal": {
    "id": "string",
    "messages": [
      {
        "type_url": "string",
        "value": "string"
      }
    ],
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes_count": "string",
      "abstain_count": "string",
      "no_count": "string",
      "no_with_veto_count": "string"
    },
    "submit_time": "2019-08-24T14:15:22Z",
    "deposit_end_time": "2019-08-24T14:15:22Z",
    "total_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "voting_start_time": "2019-08-24T14:15:22Z",
    "voting_end_time": "2019-08-24T14:15:22Z",
    "metadata": "string",
    "title": "string",
    "summary": "string",
    "proposer": "string",
    "expedited": true,
    "failed_reason": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Deposits queries all deposits of a single proposal.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals/string/deposits"

{
  "deposits": [
    {
      "proposal_id": "string",
      "depositor": "string",
      "amount": [
        {
          "denom": "string",
          "amount": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Deposit queries single deposit information based on proposalID, depositAddr.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

depositor*string

depositor defines the deposit addresses from the proposals.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals/string/deposits/string"

{
  "deposit": {
    "proposal_id": "string",
    "depositor": "string",
    "amount": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TallyResult queries the tally of a proposal vote.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals/string/tally"

{
  "tally": {
    "yes_count": "string",
    "abstain_count": "string",
    "no_count": "string",
    "no_with_veto_count": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Votes queries votes of a given proposal.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals/string/votes"

{
  "votes": [
    {
      "proposal_id": "string",
      "voter": "string",
      "options": [
        {
          "option": "VOTE_OPTION_UNSPECIFIED",
          "weight": "string"
        }
      ],
      "metadata": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Vote queries voted information based on proposalID, voterAddr.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

voter*string

voter defines the voter address for the proposals.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1/proposals/string/votes/string"

{
  "vote": {
    "proposal_id": "string",
    "voter": "string",
    "options": [
      {
        "option": "VOTE_OPTION_UNSPECIFIED",
        "weight": "string"
      }
    ],
    "metadata": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries all parameters of the gov module.

Path Parameters

params_type*string

params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/params/string"

{
  "voting_params": {
    "voting_period": "string"
  },
  "deposit_params": {
    "min_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "max_deposit_period": "string"
  },
  "tally_params": {
    "quorum": "string",
    "threshold": "string",
    "veto_threshold": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Proposals queries all proposals based on given status.

Query Parameters

proposal_status?string

proposal_status defines the status of the proposals.

PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status.
PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.

Value in

"PROPOSAL_STATUS_UNSPECIFIED" | "PROPOSAL_STATUS_DEPOSIT_PERIOD" | "PROPOSAL_STATUS_VOTING_PERIOD" | "PROPOSAL_STATUS_PASSED" | "PROPOSAL_STATUS_REJECTED" | "PROPOSAL_STATUS_FAILED"

voter?string

voter defines the voter address for the proposals.

depositor?string

depositor defines the deposit addresses from the proposals.

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals"

{
  "proposals": [
    {
      "proposal_id": "string",
      "content": {
        "type_url": "string",
        "value": "string"
      },
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes": "string",
        "abstain": "string",
        "no": "string",
        "no_with_veto": "string"
      },
      "submit_time": "2019-08-24T14:15:22Z",
      "deposit_end_time": "2019-08-24T14:15:22Z",
      "total_deposit": [
        {
          "denom": "string",
          "amount": "string"
        }
      ],
      "voting_start_time": "2019-08-24T14:15:22Z",
      "voting_end_time": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Proposal queries proposal details based on ProposalID.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals/string"

{
  "proposal": {
    "proposal_id": "string",
    "content": {
      "type_url": "string",
      "value": "string"
    },
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes": "string",
      "abstain": "string",
      "no": "string",
      "no_with_veto": "string"
    },
    "submit_time": "2019-08-24T14:15:22Z",
    "deposit_end_time": "2019-08-24T14:15:22Z",
    "total_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "voting_start_time": "2019-08-24T14:15:22Z",
    "voting_end_time": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Deposits queries all deposits of a single proposal.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals/string/deposits"

{
  "deposits": [
    {
      "proposal_id": "string",
      "depositor": "string",
      "amount": [
        {
          "denom": "string",
          "amount": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Deposit queries single deposit information based on proposalID, depositor address.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

depositor*string

depositor defines the deposit addresses from the proposals.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals/string/deposits/string"

{
  "deposit": {
    "proposal_id": "string",
    "depositor": "string",
    "amount": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

TallyResult queries the tally of a proposal vote.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals/string/tally"

{
  "tally": {
    "yes": "string",
    "abstain": "string",
    "no": "string",
    "no_with_veto": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Votes queries votes of a given proposal.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals/string/votes"

{
  "votes": [
    {
      "proposal_id": "string",
      "voter": "string",
      "option": "VOTE_OPTION_UNSPECIFIED",
      "options": [
        {
          "option": "VOTE_OPTION_UNSPECIFIED",
          "weight": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Vote queries voted information based on proposalID, voterAddr.

Path Parameters

proposal_id*string

proposal_id defines the unique id of the proposal.

Formatuint64

voter*string

voter defines the voter address for the proposals.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/gov/v1beta1/proposals/string/votes/string"

{
  "vote": {
    "proposal_id": "string",
    "voter": "string",
    "option": "VOTE_OPTION_UNSPECIFIED",
    "options": [
      {
        "option": "VOTE_OPTION_UNSPECIFIED",
        "weight": "string"
      }
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params queries the parameters of x/consensus module.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/consensus/v1/params"

{
  "params": {
    "block": {
      "max_bytes": "string",
      "max_gas": "string"
    },
    "evidence": {
      "max_age_num_blocks": "string",
      "max_age_duration": "string",
      "max_bytes": "string"
    },
    "validator": {
      "pub_key_types": [
        "string"
      ]
    },
    "version": {
      "app": "string"
    },
    "abci": {
      "vote_extensions_enable_height": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AppliedPlan queries a previously applied upgrade plan by its name.

Path Parameters

name*string

name is the name of the applied plan to query for.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/upgrade/v1beta1/applied_plan/string"

{
  "height": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Returns the account with authority to conduct upgrades

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/upgrade/v1beta1/authority"

{
  "address": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

CurrentPlan queries the current upgrade plan.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/upgrade/v1beta1/current_plan"

{
  "plan": {
    "name": "string",
    "time": "2019-08-24T14:15:22Z",
    "height": "string",
    "info": "string",
    "upgraded_client_state": {
      "type_url": "string",
      "value": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ModuleVersions queries the list of module versions from state.

Query Parameters

module_name?string

module_name is a field to query a specific module consensus version from state. Leaving this empty will fetch the full list of module versions from state.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/upgrade/v1beta1/module_versions"

{
  "module_versions": [
    {
      "name": "string",
      "version": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

UpgradedConsensusState queries the consensus state that will serve as a trusted kernel for the next version of this chain. It will only be stored at the last height of this chain. UpgradedConsensusState RPC not supported with legacy querier This rpc is deprecated now that IBC has its own replacement (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54)

Path Parameters

last_height*string

last height of the current chain must be sent in request as this is the height under which next consensus state is stored

Formatint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/upgrade/v1beta1/upgraded_consensus_state/string"

{
  "upgraded_consensus_state": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Allowance returns granted allwance to the grantee by the granter.

Path Parameters

granter*string

granter is the address of the user granting an allowance of their funds.

grantee*string

grantee is the address of the user being granted an allowance of another user's funds.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/feegrant/v1beta1/allowance/string/string"

{
  "allowance": {
    "granter": "string",
    "grantee": "string",
    "allowance": {
      "type_url": "string",
      "value": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Allowances returns all the grants for the given grantee address.

Path Parameters

grantee*string

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/feegrant/v1beta1/allowances/string"

{
  "allowances": [
    {
      "granter": "string",
      "grantee": "string",
      "allowance": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AllowancesByGranter returns all the grants given by an address

Path Parameters

granter*string

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/feegrant/v1beta1/issued/string"

{
  "allowances": [
    {
      "granter": "string",
      "grantee": "string",
      "allowance": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AllEvidence queries all evidence.

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/evidence/v1beta1/evidence"

{
  "evidence": [
    {
      "type_url": "string",
      "value": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Evidence queries evidence based on evidence hash.

Path Parameters

hash*string

hash defines the evidence hash of the requested evidence.

Query Parameters

evidence_hash?string

evidence_hash defines the hash of the requested evidence. Deprecated: Use hash, a HEX encoded string, instead.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmos/evidence/v1beta1/evidence/string"

{
  "evidence": {
    "type_url": "string",
    "value": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Codes gets the metadata for all stored wasm codes

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/code"

{
  "code_infos": [
    {
      "code_id": "string",
      "creator": "string",
      "data_hash": "string",
      "instantiate_permission": {
        "permission": "ACCESS_TYPE_UNSPECIFIED",
        "addresses": [
          "string"
        ]
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

CodeInfo gets the metadata for a single wasm code

Path Parameters

code_id*string

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/code-info/string"

{
  "code_id": "string",
  "creator": "string",
  "checksum": "string",
  "instantiate_permission": {
    "permission": "ACCESS_TYPE_UNSPECIFIED",
    "addresses": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Code gets the binary code and metadata for a single wasm code

Path Parameters

code_id*string

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/code/string"

{
  "code_info": {
    "code_id": "string",
    "creator": "string",
    "data_hash": "string",
    "instantiate_permission": {
      "permission": "ACCESS_TYPE_UNSPECIFIED",
      "addresses": [
        "string"
      ]
    }
  },
  "data": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ContractsByCode lists all smart contracts for a code id

Path Parameters

code_id*string

Formatuint64

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/code/string/contracts"

{
  "contracts": [
    "string"
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params gets the module params

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/codes/params"

{
  "params": {
    "code_upload_access": {
      "permission": "ACCESS_TYPE_UNSPECIFIED",
      "addresses": [
        "string"
      ]
    },
    "instantiate_default_permission": "ACCESS_TYPE_UNSPECIFIED"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

PinnedCodes gets the pinned code ids

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/codes/pinned"

{
  "code_ids": [
    "string"
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

BuildAddress builds a contract address

Query Parameters

code_hash?string

CodeHash is the hash of the code.

creator_address?string

CreatorAddress is the address of the contract instantiator.

salt?string

Salt is a hex encoded salt.

init_args?string

InitArgs are optional json encoded init args to be used in contract address building if provided.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contract/build_address"

{
  "address": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ContractInfo gets the contract meta data

Path Parameters

address*string

address is the address of the contract to query

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contract/string"

{
  "address": "string",
  "contract_info": {
    "code_id": "string",
    "creator": "string",
    "admin": "string",
    "label": "string",
    "created": {
      "block_height": "string",
      "tx_index": "string"
    },
    "ibc_port_id": "string",
    "ibc2_port_id": "string",
    "extension": {
      "type_url": "string",
      "value": "string"
    }
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ContractHistory gets the contract code history

Path Parameters

address*string

address is the address of the contract to query

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contract/string/history"

{
  "entries": [
    {
      "operation": "CONTRACT_CODE_HISTORY_OPERATION_TYPE_UNSPECIFIED",
      "code_id": "string",
      "updated": {
        "block_height": "string",
        "tx_index": "string"
      },
      "msg": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

RawContractState gets single key from the raw store data of a contract

Path Parameters

address*string

address is the address of the contract

query_data*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contract/string/raw/string"

{
  "data": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

SmartContractState get smart query result from the contract

Path Parameters

address*string

address is the address of the contract

query_data*string

QueryData contains the query data passed to the contract

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contract/string/smart/string"

{
  "data": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

AllContractState gets all raw store data for a single contract

Path Parameters

address*string

address is the address of the contract

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contract/string/state"

{
  "models": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ContractsByCreator gets the contracts by creator

Path Parameters

creator_address*string

CreatorAddress is the address of contract creator

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/contracts/creator/string"

{
  "contract_addresses": [
    "string"
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

WasmLimitsConfig gets the configured limits for static validation of Wasm files, encoded in JSON.

Response Body

`application/json`

curl -X GET "http://localhost:1317/cosmwasm/wasm/v1/wasm-limits-config"

{
  "config": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomAuthorityMetadata defines a gRPC query method for fetching DenomAuthorityMetadata for a particular denom.

Path Parameters

denom*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/osmosis/tokenfactory/v1beta1/denoms/string/authority_metadata"

{
  "authority_metadata": {
    "admin": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DenomsFromCreator defines a gRPC query method for fetching all denominations created by a specific admin/creator.

Path Parameters

creator*string

Response Body

`application/json`

curl -X GET "http://localhost:1317/osmosis/tokenfactory/v1beta1/denoms_from_creator/string"

{
  "denoms": [
    "string"
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params defines a gRPC query method that returns the tokenfactory module's parameters.

Response Body

`application/json`

curl -X GET "http://localhost:1317/osmosis/tokenfactory/v1beta1/params"

{
  "params": {
    "denom_creation_fee": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "denom_creation_gas_consume": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

MinimumGasPrices returns the minimum gas prices.

Response Body

`application/json`

curl -X GET "http://localhost:1317/gaia/globalfee/v1beta1/minimum_gas_prices"

{
  "minimum_gas_prices": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params retrieves the Drip module params

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/drip/v1/params"

{
  "params": {
    "enable_drip": true,
    "allowed_addresses": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

FeeShares retrieves all registered FeeShares

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/feeshare/v1/fee_shares"

{
  "feeshare": [
    {
      "contract_address": "string",
      "deployer_address": "string",
      "withdrawer_address": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

FeeShare retrieves a registered FeeShare for a given contract address

Path Parameters

contract_address*string

contract_address of a registered contract in bech32 format

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/feeshare/v1/fee_shares/string"

{
  "feeshare": {
    "contract_address": "string",
    "deployer_address": "string",
    "withdrawer_address": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

DeployerFeeShares retrieves all FeeShares that a given deployer has registered

Path Parameters

deployer_address*string

deployer_address in bech32 format

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/feeshare/v1/fee_shares/string"

{
  "contract_addresses": [
    "string"
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

WithdrawerFeeShares retrieves all FeeShares with a given withdrawer address

Path Parameters

withdrawer_address*string

withdrawer_address in bech32 format

Query Parameters

pagination.key?string

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset?string

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

Formatuint64

pagination.limit?string

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

Formatuint64

pagination.count_total?boolean

pagination.reverse?boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/feeshare/v1/fee_shares/string"

{
  "contract_addresses": [
    "string"
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params retrieves the FeeShare module params

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/feeshare/v1/params"

{
  "params": {
    "enable_fee_share": true,
    "developer_shares": "string",
    "allowed_denoms": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Get Authenticator_19562

Path Parameters

account*string

authenticator_id*string

Formatuint64

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/smartaccount/authenticator/string/string"

{
  "account_authenticator": {
    "id": "string",
    "type": "string",
    "config": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

`application/json`

curl -X GET "http://localhost:1317/terp/smartaccount/authenticators/string"

{
  "account_authenticators": [
    {
      "id": "string",
      "type": "string",
      "config": "string"
    }
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Parameters queries the parameters of the module.

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/smartaccount/params"

{
  "params": {
    "maximum_unauthenticated_gas": "string",
    "is_smart_account_active": true,
    "circuit_breaker_controllers": [
      "string"
    ]
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

ClockContracts

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/clock/v1/contracts"

{
  "contract_addresses": [
    "string"
  ]
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

Params

Response Body

`application/json`

curl -X GET "http://localhost:1317/terp/clock/v1/params"

{
  "params": {
    "contract_addresses": [
      "string"
    ],
    "contract_gas_limit": "string"
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

200application/json

defaultapplication/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`