For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

Secret Network — Query (3/3)

API reference for Secret Network. All methods ->

Part 3 of 3: 1 · 2 · 3

Query​

/cosmos/staking/v1beta1/params​

Retrieves the staking parameters.

Parameters​

None.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/params

Response example​

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

/cosmos/staking/v1beta1/pool​

Retrieves the pool info.

Parameters​

None.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/pool

Response example​

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

/cosmos/staking/v1beta1/validators​

Retrieves all validators that match the given status.

Parameters​


  • status (string; query): a status to query the validators for.
  • pagination.key (string; byte; query): key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.offset (string; uint64; query): offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.limit (string; uint64; query): 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.
  • pagination.count_total (boolean; query): 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; query): reverse is set to true if results are to be returned in the descending order.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/validators

Response example​

{
  "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": "2023-03-02T12:05:06.275Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2023-03-02T12:05:06.275Z"
      },
      "min_self_delegation": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/cosmos/staking/v1beta1/validators/{validator_addr}​

Retrieves validator info for a given validator address.

Parameters​


  • validator_addr (string; path; required): the validator address to query for.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/validators/{validator_addr}

Response example​

{
  "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": "2023-03-02T12:11:37.556Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2023-03-02T12:11:37.556Z"
    },
    "min_self_delegation": "string"
  }
}

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations​

Retrieves delegate info for a given validator.

Parameters​


  • validator_addr (string; path; required): the validator address to query for.
  • pagination.key (string; byte; query): key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.offset (string; uint64; query): offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.limit (string; uint64; query): 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.
  • pagination.count_total (boolean; query): 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; query): reverse is set to true if results are to be returned in the descending order.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

Response example​

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

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}​

Retrieves delegate info for given validator delegator pair.

Parameters​


  • validator_addr (string; path; required): the validator address to query for.
  • delegator_addr (string; path; required): the delegator address to query for.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}

Response example​

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

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation​

Retrieves unbonding info for given validator delegator pair.

Parameters​


  • validator_addr (string; path; required): the validator address to query for.
  • delegator_addr (string; path; required): the delegator address to query for.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation

Response example​

{
  "unbond": {
    "delegator_address": "string",
    "validator_address": "string",
    "entries": [
      {
        "creation_height": "string",
        "completion_time": "2023-03-02T12:22:06.905Z",
        "initial_balance": "string",
        "balance": "string"
      }
    ]
  }
}

/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations​

Retrieves unbonding delegations of a given validator address.

Parameters​


  • validator_addr (string; path; required): the validator address to query for.
  • pagination.key (string; byte; query): key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.offset (string; uint64; query): offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.limit (string; uint64; query): 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.
  • pagination.count_total (boolean; query): 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; query): reverse is set to true if results are to be returned in the descending order.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

Response example​

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2023-03-02T12:23:51.870Z",
          "initial_balance": "string",
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/cosmos/upgrade/v1beta1/applied_plan/{name}​

Retrieves a previously applied upgrade plan by its name.

Parameters​


  • name (string; path; required): the name of the applied plan to query for.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/upgrade/v1beta1/applied_plan/{name}

Response example​

{
  "height": "string"
}

/cosmos/upgrade/v1beta1/current_plan​

Retrieves the current upgrade plan.

Parameters​

None.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/upgrade/v1beta1/current_plan

Response example​

{
  "plan": {
    "name": "string",
    "time": "2023-03-02T12:29:52.518Z",
    "height": "string",
    "info": "string",
    "upgraded_client_state": {
      "type_url": "string",
      "value": "string"
    }
  }
}

/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}​

Retrieves 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.

Parameters​


  • last_height (string; int64; path; required): the last height of the current chain must be sent in request as this is the height under which the next consensus state is stored.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

Response example​

{
  "upgraded_consensus_state": "string"
}

/cosmos/authz/v1beta1/grants​

Retrieves the list of Authorization, granted to the grantee by the granter.

Parameters​


  • granter (string; query): a granter.
  • grantee (string; query): a grantee.
  • msg_type_url (string; query): define to retrieve the grants matching a given message type.
  • pagination.key (string; byte; query): key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.offset (string; uint64; query): offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.limit (string; uint64; query): 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.
  • pagination.count_total (boolean; query): 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; query): reverse is set to true if results are to be returned in the descending order.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/authz/v1beta1/grants

Response example​

{
  "grants": [
    {
      "authorization": {
        "type_url": "string",
        "value": "string"
      },
      "expiration": "2023-03-02T12:52:34.325Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee}​

Retrieves the fee granted to the grantee by the granter.

Parameters​


  • granter (string; query): a granter.
  • grantee (string; query): a grantee.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee}

Response example​

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

/cosmos/feegrant/v1beta1/allowances/{grantee}​

Retrieves all the grants for an address.

Parameters​


  • grantee (string; query): a grantee.
  • pagination.key (string; byte; query): key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.offset (string; uint64; query): offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of the pagination parameters should be set — pagination.key or pagination.offset.
  • pagination.limit (string; uint64; query): 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.
  • pagination.count_total (boolean; query): 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; query): reverse is set to true if results are to be returned in the descending order.

Returns​

Response codes:

  • 200 — success.
  • default — unexpected error.

Request example​

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/feegrant/v1beta1/allowances/{grantee}

Response example​

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