Interchain API
  1. Bitcoin
  2. Chain
Interchain API
  • Overview
    • Introduction
  • Bitcoin
    • Transaction
      • Get transaction by hash.
    • Block
      • Get block by hash.
      • Get block by hash.
    • Chain
      • Returns various state info regarding block chain processing.
        GET
    • Memory Pool
      • Returns various information about the TX mempool.
      • Returns transactions in the TX mempool.
      • Returns headers.
      • Returns Unspent Transaction (TX) Outputs
  • Ethereum
    • ETH Methods
      • Returns array of all accounts owned by the client.
      • Returns the number of most recent block.
      • Executes a new message call immediately without creating a transaction on the block chain.
      • Returns the current gas price in the default EVM denomination parameter.
      • Returns the balance of the account of given address.
      • Returns information about a block by hash.
      • Returns information about a block by block number.
      • Returns the number of transactions sent from an address.
      • Returns the number of transactions in a block from a block matching the given block hash.
      • Returns code at a given address.
      • Polling method for a filter, which returns an array of logs which occurred since last poll.
      • Returns an array of all logs matching filter with given id.
      • Returns an array of all logs matching a given filter object.
      • Returns the value from a storage position at a given address.
      • Returns information about a transaction by block hash and transaction index position.
      • Returns information about a transaction by block number and transaction index position.
      • Returns the information about a transaction requested by transaction hash.
      • Returns the value from a storage position at a given address.
      • Returns the receipt of a transaction by transaction hash.
      • Returns information about a uncle of a block by hash and uncle index position.
      • Returns information about a uncle of a block by number and uncle index position.
      • Returns the number of transactions in a block matching the given block number.
      • Returns the number of uncles in a block from a block matching the given block number.
      • Creates a filter in the node, to notify when a new block arrives.
      • Creates a filter object, based on filter options, to notify when the state changes (logs).
      • Creates a filter in the node, to notify when new pending transactions arrive.
      • Returns the current ethereum protocol version.
      • Creates new message call transaction or a contract creation for signed transactions.
      • Creates new message call transaction or a contract creation, if the data field contains code.
      • The sign method calculates an Ethereum specific signature with: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).
      • The sync status object may need to be different depending on the details of Tendermint's sync protocol. However, the 'synced' result is simply a boolean, and can easily be derived from Tendermint's internal sync state.
      • Uninstalls a filter with given id. Should always be called when watch is no longer needed.
    • Net Methods
      • Returns if client is actively listening for network connections.
      • Returns the number of peers currently connected to the client.
      • Returns the current network id.
    • Web3 Methods
      • Get the web3 client version.
      • Returns Keccak-256 (not the standardized SHA3-256) of the given data.
  1. Bitcoin
  2. Chain

Returns various state info regarding block chain processing.

GET
/chaininfo.json
chain
Last modified:2024-05-27 22:00:31
Returns various state info regarding block chain processing. Only supports JSON as output format.

Request

None

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/chaininfo.json'

Responses

🟢200successful operation
application/json
Body
chain
enum<string> 
optional
Current network name as defined in BIP70 (main, test, regtest)
Allowed values:
maintestregtest
blocks
integer <int64>
optional
The current number of blocks processed in the server
headers
integer <int64>
optional
The current number of headers we have validated
bestblockhash
string 
optional
The hash of the currently best block
difficulty
integer <int64>
optional
The current difficulty
mediantime
integer <int32>
optional
The median time of the 11 blocks before the most recent block on the blockchain
verificationprogress
integer <int32>
optional
Estimate of verification progress [0..1]
initialblockdownload
boolean 
optional
chainwork
string 
optional
Total amount of work in active chain, in hexadecimal
size_on_disk
integer <int64>
optional
pruned
boolean 
optional
If the blocks are subject to pruning
softforks
array[object (BIP) {3}] 
optional
status of softforks in progress
id
string 
optional
The BIP number, or ? before being assigned
version
integer <int32>
optional
The BIP version number
reject
object 
optional
the BIP rejection status
bip9_softforks
object 
optional
status of BIP9 softforks in progress
name
object (BIP9) 
optional
warnings
string 
optional
An eventual warning on the current build status.
Example
{
  "chain": "main",
  "blocks": 0,
  "headers": 0,
  "bestblockhash": "string",
  "difficulty": 0,
  "mediantime": 0,
  "verificationprogress": 0,
  "initialblockdownload": true,
  "chainwork": "string",
  "size_on_disk": 0,
  "pruned": true,
  "softforks": [
    {
      "id": "string",
      "version": 0,
      "reject": {
        "status": true
      }
    }
  ],
  "bip9_softforks": {
    "name": {
      "status": "defined",
      "startTime": 0,
      "timeout": 0,
      "since": 0
    }
  },
  "warnings": "string"
}
Modified at 2024-05-27 22:00:31
Previous
Get block by hash.
Next
Returns various information about the TX mempool.
Built with