Secret Network

Secret Network API is available on Web3 API platform (opens in a new tab).

Secret Network is the first blockchain with customizable privacy. You get to choose what you share, who you share with, and how long you share it for. This protects users and empowers developers to build a better Web3.

We support the following networks and protocols for Secret Network:

Currently, we provide two interfaces to query Secret Network API — JSON-RPC (opens in a new tab) and REST. Responses for both of them come in JSON format (opens in a new tab).

Here is the request/response structure to use for querying:

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block",
      "params": ["1"],
      "id": 1
    }'

Tendermint JSON-RPC/REST methods

Info — node information:

blockchain — retrieves block headers (max: 20) for minHeight <= height <= maxHeight.
block — retrieves a block at a specified height.
block_by_hash — retrieves a block by hash.
block_results — retrieves block results at a specified height.
commit — retrieves commit results at a specified height.
validators — retrieves a validator set at a specified height.
genesis_chunked — retrieves the Genesis in multiple chunks.
dump_consensus_state — retrieves consensus state.
consensus_state — retrieves consensus state.
consensus_params — retrieves consensus parameters.
unconfirmed_txs — retrieves the list of unconfirmed transactions.
num_unconfirmed_txs — retrieves data about unconfirmed transactions.
tx_search — searches for transactions.
block_search — searches for blocks by BeginBlock and EndBlock events.
tx — retrieves transactions by hash.

Tx — transactions broadcast information:

broadcast_tx_sync — returns with the response from CheckTx. Does not wait for DeliverTx result.
broadcast_tx_async — returns right away, with no response. Does not wait for CheckTx nor DeliverTx results.
broadcast_tx_commit — returns with the responses from CheckTx and DeliverTx.
check_tx — checks the transaction without executing it.

ABCI — ABCI info:

abci_info — retrieves info about the application.
abci_query — queries the application for some information.

Information

`blockchain`

Retrieves block headers for minHeight <= height <= maxHeight.

At most 20 items will return for the minHeight or maxHeight parameters specified. If maxHeight does not yet exist, the blocks up to the current height will return. If minHeight does not exist (pruning), the earliest existing height will be used.

Parameters

minHeight (integer): the minimum block height to return.
maxHeight (integer): the maximum block height to return.

Returns

Block headers, in descending order (highest first).

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "blockchain",
      "params": ["1", "2"],
      "id": 1
    }'

Response example

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "last_height": "1276718",
    "block_metas": [
      {
        "block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "block_size": 1000000,
        "header": {
          "version": {
            "block": "10",
            "app": "0"
          },
          "chain_id": "cosmoshub-2",
          "height": "12",
          "time": "2019-04-22T17:01:51.701356223Z",
          "last_block_id": {
            "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
            "parts": {
              "total": 1,
              "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
            }
          },
          "last_commit_hash": "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812",
          "data_hash": "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73",
          "validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
          "next_validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
          "consensus_hash": "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8",
          "app_hash": "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C",
          "last_results_hash": "",
          "evidence_hash": "",
          "proposer_address": "D540AB022088612AC74B287D076DBFBC4A377A2E"
        },
        "num_txs": "54"
      }
    ]
  }
}

`block`

Retrieves a block at a specified height.

Parameters

height (integer; default: 0): the height to return. If no height is provided, the latest block is to be fetched.

Returns

Block information.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "block_id": {
      "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
      "parts": {
        "total": 1,
        "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
      }
    },
    "block": {
      "header": {
        "version": {
          "block": "10",
          "app": "0"
        },
        "chain_id": "cosmoshub-2",
        "height": "12",
        "time": "2019-04-22T17:01:51.701356223Z",
        "last_block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "last_commit_hash": "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812",
        "data_hash": "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73",
        "validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "next_validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "consensus_hash": "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8",
        "app_hash": "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C",
        "last_results_hash": "",
        "evidence_hash": "",
        "proposer_address": "D540AB022088612AC74B287D076DBFBC4A377A2E"
      },
      "data": [
        "yQHwYl3uCkKoo2GaChRnd+THLQ2RM87nEZrE19910Z28ABIUWW/t8AtIMwcyU0sT32RcMDI9GF0aEAoFdWF0b20SBzEwMDAwMDASEwoNCgV1YXRvbRIEMzEwMRCd8gEaagom61rphyEDoJPxlcjRoNDtZ9xMdvs+lRzFaHe2dl2P5R2yVCWrsHISQKkqX5H1zXAIJuC57yw0Yb03Fwy75VRip0ZBtLiYsUqkOsPUoQZAhDNP+6LY+RUwz/nVzedkF0S29NZ32QXdGv0="
      ],
      "evidence": [
        {
          "type": "string",
          "height": 0,
          "time": 0,
          "total_voting_power": 0,
          "validator": {
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "A6DoBUypNtUAyEHWtQ9bFjfNg8Bo9CrnkUGl6k6OHN4="
            },
            "voting_power": 0,
            "address": "string"
          }
        }
      ],
      "last_commit": {
        "height": 0,
        "round": 0,
        "block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "signatures": [
          {
            "type": 2,
            "height": "1262085",
            "round": 0,
            "block_id": {
              "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
              "parts": {
                "total": 1,
                "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
              }
            },
            "timestamp": "2019-08-01T11:39:38.867269833Z",
            "validator_address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
            "validator_index": 0,
            "signature": "DBchvucTzAUEJnGYpNvMdqLhBAHG4Px8BsOBB3J3mAFCLGeuG7uJqy+nVngKzZdPhPi8RhmE/xcw/M9DOJjEDg=="
          }
        ]
      }
    }
  }
}

`block_by_hash`

Retrieves a block by hash.

Parameters

hash (string; required): a block hash.

Returns

Block information.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block_by_hash",
      "params": ["0xD70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED"],
      "id": 1
    }'

Response example

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "block_id": {
      "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
      "parts": {
        "total": 1,
        "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
      }
    },
    "block": {
      "header": {
        "version": {
          "block": "10",
          "app": "0"
        },
        "chain_id": "cosmoshub-2",
        "height": "12",
        "time": "2019-04-22T17:01:51.701356223Z",
        "last_block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "last_commit_hash": "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812",
        "data_hash": "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73",
        "validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "next_validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "consensus_hash": "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8",
        "app_hash": "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C",
        "last_results_hash": "",
        "evidence_hash": "",
        "proposer_address": "D540AB022088612AC74B287D076DBFBC4A377A2E"
      },
      "data": [
        "yQHwYl3uCkKoo2GaChRnd+THLQ2RM87nEZrE19910Z28ABIUWW/t8AtIMwcyU0sT32RcMDI9GF0aEAoFdWF0b20SBzEwMDAwMDASEwoNCgV1YXRvbRIEMzEwMRCd8gEaagom61rphyEDoJPxlcjRoNDtZ9xMdvs+lRzFaHe2dl2P5R2yVCWrsHISQKkqX5H1zXAIJuC57yw0Yb03Fwy75VRip0ZBtLiYsUqkOsPUoQZAhDNP+6LY+RUwz/nVzedkF0S29NZ32QXdGv0="
      ],
      "evidence": [
        {
          "type": "string",
          "height": 0,
          "time": 0,
          "total_voting_power": 0,
          "validator": {
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "A6DoBUypNtUAyEHWtQ9bFjfNg8Bo9CrnkUGl6k6OHN4="
            },
            "voting_power": 0,
            "address": "string"
          }
        }
      ],
      "last_commit": {
        "height": 0,
        "round": 0,
        "block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "signatures": [
          {
            "type": 2,
            "height": "1262085",
            "round": 0,
            "block_id": {
              "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
              "parts": {
                "total": 1,
                "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
              }
            },
            "timestamp": "2019-08-01T11:39:38.867269833Z",
            "validator_address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
            "validator_index": 0,
            "signature": "DBchvucTzAUEJnGYpNvMdqLhBAHG4Px8BsOBB3J3mAFCLGeuG7uJqy+nVngKzZdPhPi8RhmE/xcw/M9DOJjEDg=="
          }
        ]
      }
    }
  }
}

`block_results`

Retrieves block results at a specified height.

Parameters

height (integer; default: 0): the height to return. If no height is provided, the latest block info is to be fetched.

Returns

Block results.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block_results",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "height": "12",
    "txs_results": [
      {
        "code": "0",
        "data": "",
        "log": "not enough gas",
        "info": "",
        "gas_wanted": "100",
        "gas_used": "100",
        "events": [
          {
            "type": "app",
            "attributes": [
              {
                "key": "YWN0aW9u",
                "value": "c2VuZA==",
                "index": false
              }
            ]
          }
        ],
        "codespace": "ibc"
      }
    ],
    "begin_block_events": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA==",
            "index": false
          }
        ]
      }
    ],
    "end_block": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA==",
            "index": false
          }
        ]
      }
    ],
    "validator_updates": [
      {
        "pub_key": {
          "type": "tendermint/PubKeyEd25519",
          "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
        },
        "power": "300"
      }
    ],
    "consensus_params_updates": {
      "block": {
        "max_bytes": "22020096",
        "max_gas": "1000",
        "time_iota_ms": "1000"
      },
      "evidence": {
        "max_age": "100000"
      },
      "validator": {
        "pub_key_types": [
          "ed25519"
        ]
      }
    }
  }
}

`commit`

Retrieves commit results at a specified height.

Parameters

height (integer; default: 0): the height to return. If no height is provided, the latest block commit info is to be fetched.

Returns

Commit results. Canonical switches from false to true for block H once block H+1 has been committed, until then it's subjective and only reflects what this node has seen so far.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "commit",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "signed_header": {
      "header": {
        "version": {
          "block": "10",
          "app": "0"
        },
        "chain_id": "cosmoshub-2",
        "height": "12",
        "time": "2019-04-22T17:01:51.701356223Z",
        "last_block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "last_commit_hash": "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812",
        "data_hash": "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73",
        "validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "next_validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "consensus_hash": "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8",
        "app_hash": "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C",
        "last_results_hash": "",
        "evidence_hash": "",
        "proposer_address": "D540AB022088612AC74B287D076DBFBC4A377A2E"
      },
      "commit": {
        "height": "1311801",
        "round": 0,
        "block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "signatures": [
          {
            "block_id_flag": 2,
            "validator_address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
            "timestamp": "2019-04-22T17:01:58.376629719Z",
            "signature": "14jaTQXYRt8kbLKEhdHq7AXycrFImiLuZx50uOjs2+Zv+2i7RTG/jnObD07Jo2ubZ8xd7bNBJMqkgtkd0oQHAw=="
          }
        ]
      }
    },
    "canonical": true
  }
}

`validators`

Retrieves a validator set at a specified height.

Validators are sorted by voting power.

Parameters

height (integer; default: 0): the height to return. If no height is provided, the validator set corresponding to the latest block is to be fetched.
page (integer; default: 1): a page number (1-based).
per_page (integer; default: 30; max: 100): a number of entries per page.

Returns

Commit results.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "validators",
      "params": ["1","1","30"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "block_height": "55",
    "validators": [
      {
        "address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
        "pub_key": {
          "type": "tendermint/PubKeyEd25519",
          "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
        },
        "voting_power": "239727",
        "proposer_priority": "-11896414"
      }
    ],
    "count": "1",
    "total": "25"
  }
}

`genesis_chunked`

Retrieves Genesis in multiple chunks.

Gets genesis document in multiple chunks to make it easier to iterate through larger genesis structures. Each chunk is produced by converting the genesis document to JSON and then splitting the resulting payload into 16MB blocks, and then Base64-encoding each block.

Parameters

chunk (integer; default: 0): a sequence number of the chunk to download.

Returns

A Genesis chunk response.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "genesis_chunked",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "chunk": 0,
    "total": 1,
    "data": "Z2VuZXNpcwo="
  }
}

`dump_consensus_state`

Retrieves consensus state.

Not safe to call from inside the ABCI application during a block execution.

Parameters

None.

Returns

A complete consensus state. See the Vote string description (opens in a new tab).

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "dump_consensus_state",
      "params": [],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "round_state": {
      "height": "1311801",
      "round": 0,
      "step": 3,
      "start_time": "2019-08-05T11:28:49.064658805Z",
      "commit_time": "2019-08-05T11:28:44.064658805Z",
      "validators": {
        "validators": [
          {
            "address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
            },
            "voting_power": "239727",
            "proposer_priority": "-11896414"
          }
        ],
        "proposer": {
          "address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
          "pub_key": {
            "type": "tendermint/PubKeyEd25519",
            "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
          },
          "voting_power": "239727",
          "proposer_priority": "-11896414"
        }
      },
      "locked_round": -1,
      "valid_round": "-1",
      "votes": [
        {
          "round": "0",
          "prevotes": [
            "nil-Vote",
            "Vote{19:46A3F8B8393B 1311801/00/1(Prevote) 000000000000 64CE682305CB @ 2019-08-05T11:28:47.374703444Z}"
          ],
          "prevotes_bit_array": "BA{100:___________________x________________________________________________________________________________} 209706/170220253 = 0.00",
          "precommits": [
            "nil-Vote"
          ],
          "precommits_bit_array": "BA{100:____________________________________________________________________________________________________} 0/170220253 = 0.00"
        }
      ],
      "commit_round": -1,
      "last_commit": {
        "votes": [
          "Vote{0:000001E443FD 1311800/00/2(Precommit) 3071ADB27D1A 77EE1B6B6847 @ 2019-08-05T11:28:43.810128139Z}"
        ],
        "votes_bit_array": "BA{100:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} 170220253/170220253 = 1.00",
        "peer_maj_23s": {}
      },
      "last_validators": {
        "validators": [
          {
            "address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
            },
            "voting_power": "239727",
            "proposer_priority": "-11896414"
          }
        ],
        "proposer": {
          "address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
          "pub_key": {
            "type": "tendermint/PubKeyEd25519",
            "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
          },
          "voting_power": "239727",
          "proposer_priority": "-11896414"
        }
      },
      "triggered_timeout_precommit": false
    },
    "peers": [
      {
        "node_address": "357f6a6c1d27414579a8185060aa8adf9815c43c@68.183.41.207:26656",
        "peer_state": {
          "round_state": {
            "height": "1311801",
            "round": "0",
            "step": 3,
            "start_time": "2019-08-05T11:28:49.21730864Z",
            "proposal": false,
            "proposal_block_parts_header": {
              "total": 0,
              "hash": ""
            },
            "proposal_pol_round": -1,
            "proposal_pol": "____________________________________________________________________________________________________",
            "prevotes": "___________________x________________________________________________________________________________",
            "precommits": "____________________________________________________________________________________________________",
            "last_commit_round": 0,
            "last_commit": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "catchup_commit_round": -1,
            "catchup_commit": "____________________________________________________________________________________________________"
          },
          "stats": {
            "votes": "1159558",
            "block_parts": "4786"
          }
        }
      }
    ]
  }
}

`consensus_state`

Retrieves consensus state.

Not safe to call from inside the ABCI application during a block execution.

Parameters

None.

Returns

Consensus state results.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "consensus_state",
      "params": [],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "round_state": {
      "height/round/step": "1262197/0/8",
      "start_time": "2019-08-01T11:52:38.962730289Z",
      "proposal_block_hash": "634ADAF1F402663BEC2ABC340ECE8B4B45AA906FA603272ACC5F5EED3097E009",
      "locked_block_hash": "634ADAF1F402663BEC2ABC340ECE8B4B45AA906FA603272ACC5F5EED3097E009",
      "valid_block_hash": "634ADAF1F402663BEC2ABC340ECE8B4B45AA906FA603272ACC5F5EED3097E009",
      "height_vote_set": [
        {
          "round": 0,
          "prevotes": [
            "Vote{0:000001E443FD 1262197/00/1(Prevote) 634ADAF1F402 7BB974E1BA40 @ 2019-08-01T11:52:35.513572509Z}",
            "nil-Vote"
          ],
          "prevotes_bit_array": "BA{100:xxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} 169753436/170151262 = 1.00",
          "precommits": [
            "Vote{5:18C78D135C9D 1262197/00/2(Precommit) 634ADAF1F402 8B5EFFFEABCD @ 2019-08-01T11:52:36.25600005Z}",
            "nil-Vote"
          ],
          "precommits_bit_array": "BA{100:xxxxxx_xxxxx_xxxx_x_xxx_xx_xx_xx__x_x_x__xxxxxxxxxxxxxx_xxxx_xx_xxxxxx_xxxxxxxx_xxxx_xxx_x_xxxx__xxx} 118726247/170151262 = 0.70"
        }
      ],
      "proposer": {
        "address": "D540AB022088612AC74B287D076DBFBC4A377A2E",
        "index": 0
      }
    }
  }
}

`consensus_params`

Retrieves consensus parameters.

Parameters

height (integer; default: 0): the height to return. If no height is provided, the latest block commit info is to be returned.

Returns

Consensus parameters results.

Request parameters

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "consensus_params",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "block_height": "1",
    "consensus_params": {
      "block": {
        "max_bytes": "22020096",
        "max_gas": "1000",
        "time_iota_ms": "1000"
      },
      "evidence": {
        "max_age": "100000"
      },
      "validator": {
        "pub_key_types": [
          "ed25519"
        ]
      }
    }
  }
}

`unconfirmed_txs`

Retrieves the list of unconfirmed transactions.

Parameters

limit (integer; default: 30; max: 100): the maximum number of unconfirmed transactions to return.

Returns

The list of unconfirmed transactions.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "unconfirmed_txs",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "n_txs": "82",
    "total": "82",
    "total_bytes": "19974",
    "txs": [
      "gAPwYl3uCjCMTXENChSMnIkb5ZpYHBKIZqecFEV2tuZr7xIUA75/FmYq9WymsOBJ0XSJ8yV8zmQKMIxNcQ0KFIyciRvlmlgcEohmp5wURXa25mvvEhQbrvwbvlNiT+Yjr86G+YQNx7kRVgowjE1xDQoUjJyJG+WaWBwSiGannBRFdrbma+8SFK2m+1oxgILuQLO55n8mWfnbIzyPCjCMTXENChSMnIkb5ZpYHBKIZqecFEV2tuZr7xIUQNGfkmhTNMis4j+dyMDIWXdIPiYKMIxNcQ0KFIyciRvlmlgcEohmp5wURXa25mvvEhS8sL0D0wwgGCItQwVowak5YB38KRIUCg4KBXVhdG9tEgUxMDA1NBDoxRgaagom61rphyECn8x7emhhKdRCB2io7aS/6Cpuq5NbVqbODmqOT3jWw6kSQKUresk+d+Gw0BhjiggTsu8+1voW+VlDCQ1GRYnMaFOHXhyFv7BCLhFWxLxHSAYT8a5XqoMayosZf9mANKdXArA="
    ]
  }
}

`num_unconfirmed_txs`

Retrieves data on unconfirmed transactions.

Parameters

None.

Returns

The status of unconfirmed transactions.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "num_unconfirmed_txs",
      "params": [],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "n_txs": "31",
    "total": "82",
    "total_bytes": "19974"
  }
}

`tx_search`

Searches for transactions with their results.

Parameters

query (string; required): query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r()"'=>< are not allowed). operation can be =, <, <=, >, >=, CONTAINS. An operand can be a string (escaped with single quotes), number, date, or time.
prove (boolean; default: false): adds proofs of the transactions inclusion in the block.
page (integer; default: 1): a page number (1-based).
per_page (integer; default: 30, max: 100): a number of entries per page.
order_by (string; default: asc): the order in which transactions are sorted (asc or desc), by height & index. If empty, default sorting still applies.
match_events (boolean; default: false): match attributes in query within events, in addition to the height and txhash.

Returns

The list of unconfirmed transactions.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "tx_search",
      "params": ["4D2000", true, "1", "30", "asc"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "txs": [
      {
        "hash": "D70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED",
        "height": "1000",
        "index": 0,
        "tx_result": {
          "log": "[{\"msg_index\":\"0\",\"success\":true,\"log\":\"\"}]",
          "gas_wanted": "200000",
          "gas_used": "28596",
          "tags": {
            "key": "YWN0aW9u",
            "value": "c2VuZA==",
            "index": false
          }
        },
        "tx": "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU=",
        "proof": {
          "RootHash": "72FE6BF6D4109105357AECE0A82E99D0F6288854D16D8767C5E72C57F876A14D",
          "Data": "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU=",
          "Proof": {
            "total": "2",
            "index": "0",
            "leaf_hash": "eoJxKCzF3m72Xiwb/Q43vJ37/2Sx8sfNS9JKJohlsYI=",
            "aunts": [
              "eWb+HG/eMmukrQj4vNGyFYb3nKQncAWacq4HF5eFzDY="
            ]
          }
        }
      }
    ],
    "total_count": "2"
  }
}

`block_search`

Searches for blocks by BeginBlock and EndBlock events.

Parameters

query (string; required): query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r()"'=>< are not allowed). operation can be =, <, <=, >, >=, CONTAINS. An operand can be a string (escaped with single quotes), number, date, or time.
page (integer; default: 1): a page number (1-based).
per_page (integer; default: 30, max: 100): a number of entries per page.
order_by (string; default: asc): the order in which transactions are sorted (asc or desc), by height & index. If empty, default sorting still applies.
match_events (boolean; default: false): match attributes in query within events, in addition to the height.

Returns

The list of paginated blocks matching the search criteria.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block_search",
      "params": ["4D2000", "1", "30", "asc"],
      "id": 1
    }'

Response example

No example available

`tx`

Retrieves a transaction by hash.

Parameters

hash (string; required): a hash of a transaction to retrieve.
prove (boolean; default: false): adds proofs of the transaction's inclusion in the block.

Returns

Transaction info.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "tx",
      "params": ["0xD70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED", true],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "hash": "D70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED",
    "height": "1000",
    "index": 0,
    "tx_result": {
      "log": "[{\"msg_index\":\"0\",\"success\":true,\"log\":\"\"}]",
      "gas_wanted": "200000",
      "gas_used": "28596",
      "tags": [
        {
          "key": "YWN0aW9u",
          "value": "c2VuZA==",
          "index": false
        }
      ]
    },
    "tx": "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU="
  }
}

Transactions

`broadcast_tx_sync`

Returns with the response from CheckTx. Does not wait for DeliverTx result.

If you want to be sure that the transaction is included in a block, you can subscribe for the result using JSONRPC via a websocket. See https://docs.tendermint.com/v0.34/app-dev/subscribing-to-events-via-websocket.html (opens in a new tab) If you haven't received anything after a couple of blocks, resend it. If the same happens again, send it to some other node. A few reasons why it could happen:

A malicious node drops or pretends it has committed your tx.
A malicious proposer (not necessary the one you're communicating with) drops transactions, which might become valid in the future (https://github.com/tendermint/tendermint/issues/3322 (opens in a new tab)).

Please refer to Tendermint docs (opens in a new tab) for formatting/encoding rules.

Parameters

tx (string; required): the transaction.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "broadcast_tx_sync",
      "params": ["456"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "code": "0",
    "data": "",
    "log": "",
    "codespace": "ibc",
    "hash": "0D33F2F03A5234F38706E43004489E061AC40A2E"
  },
  "error": ""
}

`broadcast_tx_async`

Returns right away, with no response. Does not wait for CheckTx nor DeliverTx results.

A malicious node drops or pretends it has committed your tx.
A malicious proposer (not necessary the one you're communicating with) drops transactions, which might become valid in the future (https://github.com/tendermint/tendermint/issues/3322 (opens in a new tab)).
A node is offline.

Please refer to Tendermint docs (opens in a new tab) for formatting/encoding rules.

Parameters

tx (string; required): the transaction.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "broadcast_tx_async",
      "params": ["123"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "code": "0",
    "data": "",
    "log": "",
    "codespace": "ibc",
    "hash": "0D33F2F03A5234F38706E43004489E061AC40A2E"
  },
  "error": ""
}

`broadcast_tx_commit`

Returns with the responses from CheckTx and DeliverTx.

Use only for testing and development. In production, use BroadcastTxSync or BroadcastTxAsync. You can subscribe for the transaction result using JSONRPC via a websocket (see Tendermint docs (opens in a new tab)).

CONTRACT: only returns error if mempool.CheckTx() errs or if we timeout waiting for tx to commit. If CheckTx or DeliverTx fails, no error will be returned, but the result will contain a non-OK ABCI code. Please refer to Tendermint docs (opens in a new tab) for formatting/encoding rules.

Parameters

tx (string; required): the transaction.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "broadcast_tx_commit",
      "params": ["785"],
      "id": 1
    }'

Response example

{
  "error": "",
  "result": {
    "height": "26682",
    "hash": "75CA0F856A4DA078FC4911580360E70CEFB2EBEE",
    "deliver_tx": {
      "log": "",
      "data": "",
      "code": "0"
    },
    "check_tx": {
      "log": "",
      "data": "",
      "code": "0"
    }
  },
  "id": 0,
  "jsonrpc": "2.0"
}

`check_tx`

Checks the transaction without executing it.

The transaction won't be added to the mempool.

Please refer to Tendermint docs (opens in a new tab) for formatting/encoding rules.

Parameters

tx (string; required): the transaction.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "check_tx",
      "params": ["785"],
      "id": 1
    }'

Response example

{
  "error": "",
  "result": {
    "code": "0",
    "data": "",
    "log": "",
    "info": "",
    "gas_wanted": "1",
    "gas_used": "0",
    "events": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA==",
            "index": false
          }
        ]
      }
    ],
    "codespace": "bank"
  },
  "id": 0,
  "jsonrpc": "2.0"
}

ABCI

`abci_info`

Retrieves application info.

Parameters

None.

Returns

Application info.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "abci_info",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "response": {
            "data": "secret",
            "version": "1.6.1",
            "last_block_height": "7690381",
            "last_block_app_hash": "J1tJC9R3q3cNzkDcI7ipyi9NuZ8XUVbMyy7B42TPWuc="
        }
    }
}

`abci_query`

Queries the application for particular information.

Parameters

path (string; required): a path to the data ("/a/b/c").
data (string; required): the data.
height (integer; default: 0): the height (0 means latest).
prove (boolean; default: false): adds proofs of the transactions inclusion in the block.

Returns

Particular info according to the query submitted.

Request example

curl -X POST https://rpc.ankr.com/scrt \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "abci_query",
      "params": ["a/b/c", "the_data", "1", true],
      "id": 1
    }'

Response example

{
  "error": "",
  "result": {
    "response": {
      "log": "exists",
      "height": "0",
      "proof": "010114FED0DAD959F36091AD761C922ABA3CBF1D8349990101020103011406AA2262E2F448242DF2C2607C3CDC705313EE3B0001149D16177BC71E445476174622EA559715C293740C",
      "value": "61626364",
      "key": "61626364",
      "index": "-1",
      "code": "0"
    }
  },
  "id": 0,
  "jsonrpc": "2.0"
}

Cosmos REST methods

Gaia REST:

/node_info — retrieves the properties of the connected node.

Transactions:

/txs — broadcasts a signed transaction to a full node.

Staking:

/staking/delegators/{delegatorAddr}/delegations — submits a delegation.
/staking/delegators/{delegatorAddr}/unbonding_delegations — submits an unbonding delegation.

Query:

/cosmos/auth/v1beta1/accounts — retrieves all the existing accounts.
/cosmos/auth/v1beta1/accounts/{address} — retrieves account details based on address.
/cosmos/auth/v1beta1/params — retrieves all parameters.
/cosmos/bank/v1beta1/balances/{address} — retrieves the balance of all coins for a single account.
/cosmos/bank/v1beta1/balances/{address}/{denom} — retrieves the balance of a single coin for a single account.
/cosmos/bank/v1beta1/denoms_metadata — retrieves the client metadata for all registered coin denominations.
/cosmos/bank/v1beta1/denoms_metadata/{denom} — retrieves the client metadata of a given coin denomination.
/cosmos/bank/v1beta1/params — retrieves the parameters of x/bank module.
/cosmos/bank/v1beta1/supply — retrieves the total supply of all coins.
/cosmos/distribution/v1beta1/community_pool — retrieves the community pool coins.
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards — retrieves the total rewards accrued by each validator.
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address} — retrieves the total rewards accrued by a delegation.
/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators — retrieves the validators of a delegator.
/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address — retrieves a withdrawal address of a delegator.
/cosmos/distribution/v1beta1/params — retrieves parameters of the distribution module.
/cosmos/distribution/v1beta1/validators/{validator_address}/commission — retrieves accumulated commission for a validator.
/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards — retrieves rewards of a validator address.
/cosmos/distribution/v1beta1/validators/{validator_address}/slashes — retrieves slash events of a validator.
/cosmos/evidence/v1beta1/evidence — retrieves all evidence.
/cosmos/evidence/v1beta1/evidence/{evidence_hash} — retrieves evidence based on evidence hash.
/cosmos/gov/v1beta1/params/{params_type} — retrieves all parameters of the gov module.
/cosmos/gov/v1beta1/proposals — retrieves all proposals based on given status.
/cosmos/gov/v1beta1/proposals/{proposal_id} — retrieves proposal details based on proposal ID.
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits — retrieves all deposits of a single proposal.
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor} — retrieves single deposit information based on proposal ID and deposit address.
/cosmos/gov/v1beta1/proposals/{proposal_id}/tally — retrieves the tally of a proposal vote.
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes — retrieves votes of a given proposal.
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter} — retrieves voted information based on proposal ID and voter address.
/cosmos/mint/v1beta1/annual_provisions — retrieves the current minting annual provisions value.
/cosmos/mint/v1beta1/inflation — retrieves the current minting inflation value.
/cosmos/mint/v1beta1/params — retrieves the total set of minting parameters.
/cosmos/slashing/v1beta1/params — retrieves the parameters of a slashing module.
/cosmos/slashing/v1beta1/signing_infos — retrieves signing info of all validators.
/cosmos/slashing/v1beta1/signing_infos/{cons_address} — retrieves the signing info of given cons address.
/cosmos/staking/v1beta1/delegations/{delegator_addr} — retrieves all delegations of a given delegator address.
/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations — retrieves redelegations of a given address.
/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations — retrieves all unbonding delegations of a given delegator address.
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators — retrieves all validators info for a given delegator address.
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr} — retrieves validator info by given delegator validator pair.
/cosmos/staking/v1beta1/historical_info/{height} — retrieves the historical info for a given height.
/cosmos/staking/v1beta1/params — retrieves the staking parameters.
/cosmos/staking/v1beta1/pool — retrieves the pool info.
/cosmos/staking/v1beta1/validators — retrieves all validators that match the given status.
/cosmos/staking/v1beta1/validators/{validator_addr} — retrieves validator info for a given validator address.
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations — retrieves delegate info for a given validator.
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr} — retrieves delegate info for given validator delegator pair.
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation — retrieves unbonding info for given validator delegator pair.
/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations — retrieves unbonding delegations of a given validator address.
/cosmos/upgrade/v1beta1/applied_plan/{name} — retrieves a previously applied upgrade plan by its name.
/cosmos/upgrade/v1beta1/current_plan — retrieves the current upgrade plan.
/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.
/cosmos/authz/v1beta1/grants — retrieves the list of Authorization, granted to the grantee by the granter.
/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee} — retrieves the fee granted to the grantee by the granter.
/cosmos/feegrant/v1beta1/allowances/{grantee} — retrieves all the grants for an address.

Services:

/cosmos/base/tendermint/v1beta1/blocks/latest — retrieves the latest block.
/cosmos/base/tendermint/v1beta1/blocks/{height} — retrieves the block for a given height.
/cosmos/base/tendermint/v1beta1/validatorsets/latest — retrieves the latest validator-set.
/cosmos/base/tendermint/v1beta1/validatorsets/{height} — retrieves the validator-set at a given height.
/cosmos/tx/v1beta1/simulate — simulates executing a transaction to estimate gas usage.
/cosmos/tx/v1beta1/txs — retrieves transactions by event.
/cosmos/tx/v1beta1/txs — broadcasts a transaction.
/cosmos/tx/v1beta1/txs/{hash} — retrieves a transaction by hash.

Gaia REST

`/node_info`

Retrieves the properties of the connected node.

Parameters

None.

Returns

Node status.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/node_info

Response example

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

Transactions

`/txs`

Broadcasts a signed transaction to a full node.

Parameters

txBroadcast (object; required): the transaction must be a signed StdTx. The supported broadcast modes include block (returns after tx commit), sync (returns after CheckTx) and async (returns right away).

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

Returns

Tx broadcasting result.

Request example

curl -X POST https://rpc.ankr.com/http/scrt_cosmos/txs

Response example

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

Staking

`/staking/delegators/{delegatorAddr}/delegations`

Submits a delegation.

Parameters

delegation (body): delegates an amount of liquid coins to a validator.

{
  "base_req": {
    "from": "cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc",
    "memo": "Sent via Cosmos Voyager",
    "chain_id": "Cosmos-Hub",
    "account_number": "0",
    "sequence": "1",
    "gas": "200000",
    "gas_adjustment": "1.2",
    "fees": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "simulate": false
  },
  "delegator_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
  "validator_address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
  "amount": {
    "denom": "stake",
    "amount": "50"
  }
}

delegatorAddr (string; required): a Bech32 AccAddress of a delegator.

Returns

Submission result codes:

200 — OK.
400 — Invalid delegator address or delegation request body.
401 — Key password is wrong.
500 — Internal Server Error.

Request example

curl -X POST https://rpc.ankr.com/http/scrt_cosmos/staking/delegators/{delegatorAddr}/delegations

Response example

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

`/staking/delegators/{delegatorAddr}/unbonding_delegations`

Submits an unbonding delegation.

Parameters

delegation (body): unbonds an amount of bonded shares from a validator.

{
  "base_req": {
    "from": "cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc",
    "memo": "Sent via Cosmos Voyager",
    "chain_id": "Cosmos-Hub",
    "account_number": "0",
    "sequence": "1",
    "gas": "200000",
    "gas_adjustment": "1.2",
    "fees": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "simulate": false
  },
  "delegator_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
  "validator_address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
  "amount": {
    "denom": "stake",
    "amount": "50"
  }
}

delegatorAddr (string; required): a Bech32 AccAddress of a delegator.

cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv

Returns

Result codes:

200 — OK.
400 — Invalid delegator address or unbonding delegation request body.
401 — Key password is wrong.
500 — Internal Server Error.

Request example

curl -X POST https://rpc.ankr.com/http/scrt_cosmos/staking/delegators/{delegatorAddr}/unbonding_delegations

Response example

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

Query

`/cosmos/auth/v1beta1/accounts`

Retrieves all the existing accounts.

Parameters

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/auth/v1beta1/accounts

Response example

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

`/cosmos/auth/v1beta1/accounts/{address}`

Retrieves account details based on address.

Parameters

address (string; path; required): the address of account to retrieve details for.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/auth/v1beta1/accounts/{address}

Response example

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

`/cosmos/auth/v1beta1/params`

Retrieves all parameters.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

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

Request example

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

`/cosmos/bank/v1beta1/balances/{address}`

Retrieves the balance of all coins for a single account.

Parameters

address (string; path; required): the address to query balances 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/bank/v1beta1/balances/{address}

Response example

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

`/cosmos/bank/v1beta1/balances/{address}/{denom}`

Retrieves the balance of a single coin for a single account.

Parameters

address (string; path; required): the address to query balances for.
denom (string; path; required): the coin denom to query balances for.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/bank/v1beta1/balances/{address}/{denom}

Response example

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

`/cosmos/bank/v1beta1/denoms_metadata`

Retrieves the client metadata for all registered coin denominations.

Parameters

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/bank/v1beta1/denoms_metadata

Response example

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

`/cosmos/bank/v1beta1/denoms_metadata/{denom}`

Retrieves the client metadata of a given coin denomination.

Parameters

denom (string; path; required): the coin denomination to query the metadata for.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/bank/v1beta1/denoms_metadata/{denom}

Response example

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

`/cosmos/bank/v1beta1/params`

Retrieves the parameters of x/bank module.

Parameter

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

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

Response example

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

`/cosmos/bank/v1beta1/supply`

Retrieves the total supply of all coins.

Parameters

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

Code responses:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/bank/v1beta1/supply

Response example

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

`/cosmos/distribution/v1beta1/community_pool`

Retrieves the community pool coins.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/distribution/v1beta1/community_pool

Response example

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

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards`

Retrieves the total rewards accrued by each validator.

Parameters

delegator_address (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/distribution/v1beta1/delegators/{delegator_address}/rewards

Response example

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

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}`

Retrieves the total rewards accrued by a delegation.

Parameters

delegator_address (string; path; required): the delegator address to query for.
validator_address (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/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}

Response example

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

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators`

Retrieves the validators of a delegator.

Parameters

delegator_address (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/distribution/v1beta1/delegators/{delegator_address}/validators

Response example

{
  "validators": [
    "string"
  ]
}

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address`

Retrieves a withdrawal address of a delegator.

Parameters

delegator_address (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/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Response example

{
  "withdraw_address": "string"
}

`/cosmos/distribution/v1beta1/params`

Retrieves parameters of the distribution module.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

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

Response example

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

`/cosmos/distribution/v1beta1/validators/{validator_address}/commission`

Retrieves accumulated commission for a validator.

Parameters

validator_address (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/distribution/v1beta1/validators/{validator_address}/commission

Response example

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

`/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards`

Retrieves the rewards of a validator address.

Parameters

validator_address (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/distribution/v1beta1/validators/{validator_address}/outstanding_rewards

Response example

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

`/cosmos/distribution/v1beta1/validators/{validator_address}/slashes`

Retrieves slash events of a validator.

Parameters

validator_address (string; path; required): the validator address to query for.
starting_height (uint64; query): the optional starting height to query the slashes.
ending_height (uint64; query): the optional ending height to query the slashes.
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/distribution/v1beta1/validators/{validator_address}/slashes

Response example

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

`/cosmos/evidence/v1beta1/evidence`

Retrieves all evidence.

Parameters

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/evidence/v1beta1/evidence

Response example

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

`/cosmos/evidence/v1beta1/evidence/{evidence_hash}`

Retrieves evidence based on evidence hash.

Parameters

evidence_hash (string; byte; path; required): the hash of the evidence to retrieve.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/evidence/v1beta1/evidence/{evidence_hash}

Response example

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

`/cosmos/gov/v1beta1/params/{params_type}`

Retrieves all parameters of the gov module.

Parameters

params_type (string; path; required): defines which parameters to query for, can be one of "voting", "tallying", or "deposit".

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/gov/v1beta1/params/{params_type}

Response example

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

`/cosmos/gov/v1beta1/proposals`

Retrieves all proposals based on given status.

Parameters

proposal_status (string; query): defines the status of the proposals; the following statuses are available:
- PROPOSAL_STATUS_UNSPECIFIED: a default proposal status.
- PROPOSAL_STATUS_DEPOSIT_PERIOD: a proposal status during the deposit period.
- PROPOSAL_STATUS_VOTING_PERIOD: a proposal status during the voting period.
- PROPOSAL_STATUS_PASSED: a proposal status of a proposal that has passed.
- PROPOSAL_STATUS_REJECTED: a proposal status of a proposal that has been rejected.
- PROPOSAL_STATUS_FAILED: a proposal status of a proposal that has failed.
voter (string; query):
depositor (string; query):
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/gov/v1beta1/proposals

Response example

{
  "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": "2023-03-02T10:55:55.465Z",
      "deposit_end_time": "2023-03-02T10:55:55.465Z",
      "total_deposit": [
        {
          "denom": "string",
          "amount": "string"
        }
      ],
      "voting_start_time": "2023-03-02T10:55:55.465Z",
      "voting_end_time": "2023-03-02T10:55:55.465Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/gov/v1beta1/proposals/{proposal_id}`

Retrieves proposal details based on proposal ID.

Parameters

proposal_id (string; uint64; path; required): the unique ID of the proposal.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/gov/v1beta1/proposals/{proposal_id}

Response example

{
  "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": "2023-03-02T11:08:57.204Z",
    "deposit_end_time": "2023-03-02T11:08:57.204Z",
    "total_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "voting_start_time": "2023-03-02T11:08:57.204Z",
    "voting_end_time": "2023-03-02T11:08:57.204Z"
  }
}

`/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits`

Retrieves all deposits of a single proposal.

Parameters

proposal_id (string; uint64; path; required): the unique ID of the proposal.
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/gov/v1beta1/proposals/{proposal_id}/deposits

Response example

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

`/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}`

Retrieves single deposit information based on proposal ID and deposit address.

Parameters

proposal_id (string; uint64; path; required): the unique ID of the proposal.
depositor (string; path; required): the deposit addresses from the proposals.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/

Response example

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

`/cosmos/gov/v1beta1/proposals/{proposal_id}/tally`

Retrieves the tally of a proposal vote.

Parameters

proposal_id (string; uint64; path; required): the unique ID of the proposal.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/gov/v1beta1/proposals/{proposal_id}/tally

Response example

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

`/cosmos/gov/v1beta1/proposals/{proposal_id}/votes`

Retrieves the votes of a given proposal.

Parameters

proposal_id (string; uint64; path; required): the unique ID of the proposal.
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/gov/v1beta1/proposals/{proposal_id}/votes

Response example

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

`/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}`

Retrieves voted information based on proposal ID and voter address.

Parameters

proposal_id (string; uint64; path; required): the unique ID of the proposal.
voter (string; path; required): the voter address for the proposal.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}

Response example

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

`/cosmos/mint/v1beta1/annual_provisions`

Retrieves the current minting annual provisions value.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/mint/v1beta1/annual_provisions

Response example

{
  "annual_provisions": "string"
}

`/cosmos/mint/v1beta1/inflation`

Retrieves the current minting inflation value.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/mint/v1beta1/inflation

Response example

{
  "inflation": "string"
}

`/cosmos/mint/v1beta1/params`

Retrieves the total set of minting parameters.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

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

Response example

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

`/cosmos/slashing/v1beta1/params`

Retrieves the parameters of a slashing module.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

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

Response example

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

`/cosmos/slashing/v1beta1/signing_infos`

Retrieves signing info of all validators.

Parameters

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/slashing/v1beta1/signing_infos

Response example

{
  "info": [
    {
      "address": "string",
      "start_height": "string",
      "index_offset": "string",
      "jailed_until": "2023-03-02T11:34:53.641Z",
      "tombstoned": true,
      "missed_blocks_counter": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/slashing/v1beta1/signing_infos/{cons_address}`

Retrieves the signing info of given cons address.

Parameters

cons_address (string; path; required): the address to query signing info from.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Response example

{
  "val_signing_info": {
    "address": "string",
    "start_height": "string",
    "index_offset": "string",
    "jailed_until": "2023-03-02T11:37:10.986Z",
    "tombstoned": true,
    "missed_blocks_counter": "string"
  }
}

`/cosmos/staking/v1beta1/delegations/{delegator_addr}`

Retrieves all delegations of a given delegator address.

Parameters

delegator_addr (string; path; required): the address of the delegator 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/delegations/{delegator_addr}

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/delegators/{delegator_addr}/redelegations`

Retrieves redelegations of a given address.

Parameters

delegator_addr (string; path; required): the address of the delegator to query for.
src_validator_addr (string; query): the validator address to redelegate from.
dst_validator_addr (string; query): the validator address to redelegate to.
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/delegators/{delegator_addr}/redelegations

Response example

{
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "string",
        "validator_src_address": "string",
        "validator_dst_address": "string",
        "entries": [
          {
            "creation_height": "string",
            "completion_time": "2023-03-02T11:44:00.360Z",
            "initial_balance": "string",
            "shares_dst": "string"
          }
        ]
      },
      "entries": [
        {
          "redelegation_entry": {
            "creation_height": "string",
            "completion_time": "2023-03-02T11:44:00.360Z",
            "initial_balance": "string",
            "shares_dst": "string"
          },
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations`

Retrieves all unbonding delegations of a given delegator address.

Parameters

delegator_addr (string; path; required): the address of the delegator 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/delegators/{delegator_addr}/unbonding_delegations

Reponse example

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

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators`

Retrieves all validators info for a given delegator address.

Parameters

delegator_addr (string; path; required): the address of the delegator 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/delegators/{delegator_addr}/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-02T11:50:03.594Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2023-03-02T11:50:03.594Z"
      },
      "min_self_delegation": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}`

Retrieves validator info by given delegator validator pair.

Parameters

delegator_addr (string; path; required): the delegator address to query for.
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/delegators/{delegator_addr}/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-02T11:52:10.807Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2023-03-02T11:52:10.807Z"
    },
    "min_self_delegation": "string"
  }
}

`/cosmos/staking/v1beta1/historical_info/{height}`

Retrieves the historical info for a given height.

Parameters

height (string; int64; path; required): the height at which to query the historical data.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/staking/v1beta1/historical_info/{height}

Response example

{
  "hist": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2023-03-02T11:55:21.837Z",
      "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": "2023-03-02T11:55:21.837Z",
        "commission": {
          "commission_rates": {
            "rate": "string",
            "max_rate": "string",
            "max_change_rate": "string"
          },
          "update_time": "2023-03-02T11:55:21.837Z"
        },
        "min_self_delegation": "string"
      }
    ]
  }
}

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

Services

`/cosmos/base/tendermint/v1beta1/blocks/latest`

Retrieves the latest block.

Parameters

None.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/base/tendermint/v1beta1/blocks/latest

Response example

{
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2023-03-02T13:02:59.747Z",
      "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": "2023-03-02T13:02:59.747Z",
              "validator_address": "string",
              "validator_index": 0,
              "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": "2023-03-02T13:02:59.747Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2023-03-02T13:02:59.747Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2023-03-02T13:02:59.747Z",
                  "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": "2023-03-02T13:02:59.747Z",
                      "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": "2023-03-02T13:02:59.747Z"
          }
        }
      ]
    },
    "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": "2023-03-02T13:02:59.747Z",
          "signature": "string"
        }
      ]
    }
  }
}

`/cosmos/base/tendermint/v1beta1/blocks/{height}`

Retrieves the block for a given height.

Parameters

height (string; int64; path; required): a height to query the block at.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/base/tendermint/v1beta1/blocks/{height}

Response example

{
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2023-03-02T13:04:50.862Z",
      "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": "2023-03-02T13:04:50.862Z",
              "validator_address": "string",
              "validator_index": 0,
              "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": "2023-03-02T13:04:50.862Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2023-03-02T13:04:50.862Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2023-03-02T13:04:50.862Z",
                  "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": "2023-03-02T13:04:50.862Z",
                      "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": "2023-03-02T13:04:50.862Z"
          }
        }
      ]
    },
    "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": "2023-03-02T13:04:50.862Z",
          "signature": "string"
        }
      ]
    }
  }
}

`/cosmos/base/tendermint/v1beta1/validatorsets/latest`

Retrieves the latest validator-set.

Parameters

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/base/tendermint/v1beta1/validatorsets/latest

Response example

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

`/cosmos/base/tendermint/v1beta1/validatorsets/{height}`

Retrieves the validator-set at a given height.

Parameters

height (string; int64; path; required): the height to retrieve the validator-set at.
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/base/tendermint/v1beta1/validatorsets/{height}

Response example

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

`/cosmos/tx/v1beta1/simulate`

Simulates executing a transaction to estimate gas usage.

Parameters

<body> (object; required):

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "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"
      }
    },
    "signatures": [
      "string"
    ]
  },
  "tx_bytes": "string"
}

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl -X POST https://rpc.ankr.com/http/scrt_cosmos/cosmos/tx/v1beta1/simulate

Response example

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

`/cosmos/tx/v1beta1/txs`

Retrieves transactions by event.

Parameters

events (array[string]; query): the list of transaction event 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.
order_by (string; query): the following values are available:
- ORDER_BY_UNSPECIFIED (default): specifies an unknown sorting order. OrderBy defaults to ASC in this case.
- ORDER_BY_ASC: defines ascending order.
- ORDER_BY_DESC: defines descending order.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/tx/v1beta1/txs

Response example

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "memo": "string",
        "timeout_height": "string",
        "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"
        }
      },
      "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"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/tx/v1beta1/txs`

Broadcasts a transaction.

Parameters

<body> (object; required):

{
  "tx_bytes": "string",
  "mode": "BROADCAST_MODE_UNSPECIFIED"
}

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl -X POST https://rpc.ankr.com/http/scrt_cosmos/cosmos/tx/v1beta1/txs

Response example

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

`/cosmos/tx/v1beta1/txs/{hash}`

Retrieves a transaction by hash.

Parameters

<hash> (string; path; required): the transaction hash to query, encoded as a hex string.

Returns

Response codes:

200 — success.
default — unexpected error.

Request example

curl https://rpc.ankr.com/http/scrt_cosmos/cosmos/tx/v1beta1/txs/{hash}

Response example

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "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"
      }
    },
    "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"
  }
}

Scroll Sei