search

Endpoint finds entity by hash (block, address, validator, namespace and tx). It returns array of responses.SearchItem entities.

Block

Block will be found by its hash. Hash example: 652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF. Hash should be hexadecimal and has a length of 64.

Example response

{
    "type": "block",
    "result": {
        "id": 1,
        "hash": "652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF",
        // ... rest fields from response.Block type
    }
}

Tx

Tx will be found by its hash. Hash example: 652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF. Tx should be hexadecimal and has a length of 64.

Example response

{
    "type": "tx",
    "result": {
        "id": 1,
        "hash": "652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF",
        // ... rest fields from response.Tx type
    }
}

Address

The Address will be found by its hash. Hash example: celestia1jc92qdnty48pafummfr8ava2tjtuhfdw774w60. Address has prefix celestia and has length 47. Also, it should be decoded by bech32.

Example response

{
    "type": "address",
    "result": {
        "id": 1,
        "hash": "celestia1jc92qdnty48pafummfr8ava2tjtuhfdw774w60",
        "height": 100,
        "balance": "6525472354"
    }
}

Namespace

Namespace can be found by base64 hash and identity pair version + namespace id. Hash example: U3dhZ2dlciByb2Nrcw==. Identity pair example: 014723ce10b187716adfc55ff7e6d9179c226e6b5440b02577cca49d02

Example response

{
    "type": "namespace",
    "result": {
        "id": 1,
        "hash": "U3dhZ2dlciByb2Nrcw==",
        "version": 1,
        "namespace_id": "4723ce10b187716adfc55ff7e6d9179c226e6b5440b02577cca49d02"
        // ... rest fields from response.Namespace type
    }
}

Validator

Validator can be found by moniker prefix. For example: names Node 1 and Node 2 can be found with query string Node

Example response

{
    "type": "validator",
    "result": {
        "id": 1,
        "moniker": "Node 1",
        // ... rest fields from response.Validator type
    }
}

Rollup

Rollup can be found by name prefix. For example: rollup with names Rollup 1 and Rollup 2 can be found with query string Rol

Example response

{
    "type": "rollup",
    "result": {
        "id": 1,
        "moniker": "Rollup 1",
        // ... rest fields from response.Rollup type
    }
}
get/search

Request

  • Base URL
    api-mainnet.celenium.io (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    API key in header apikey

Query parameters

querystring required

Search string

Response

OK

resultobject

Search result. Can be one of folowwing types: Block, Address, Namespace, Tx, Validator, Rollup

typestring

Result type which is in the result. Can be 'block', 'address', 'namespace', 'tx', 'validator', 'rollup'

Changes