Query Params

Some endpoints have optional query parameters which attach additional data in the response.
Below are a list of those parameters and their respective responses.

Validation Method

Query parameter: validationMethod

All of the blockchain related endpoints have the option to return the necessary data used to prove the validity of the associated data returned with the response.

Value

Description

none

Default. No validation data is returned in the response

basic

Returns validation information about the principal components of a block.

full*

Returns all of the validation information about the components of a block, and each of its sub-components (transactions and uncles). This allows one to fully verify a block and each of its component.

*Note: Only applies to endpoints that returns block data

Example Response: Block

{
  "validation": {
    "hash": {
      "data": {
        "difficulty": "2957101900364072",
        "extraData": "0x76697231",
        "gasLimit": "8000029",
        "gasUsed": "7992790",
        "logsBloom": "0x007412...",
        "miner": "0xb2930b35844a230f00e51431acae96fe543a0347",
        "mixHash": "0x1f7cf0...",
        "nonce": "3191105210499409716",
        "number": "7280000",
        "parentHash": "0x215060...",
        "receiptsRoot": "0xbea5cd...",
        "sha3Uncles": "0x1dcc4d...",
        "stateRoot": "0x1e3022...",
        "timestamp": "2019-02-28T19:52:04.000Z",
        "transactionsRoot": "0x4eb851..."
      },
      "value": "0xeddb0590e1095fbe51205a51a297daef7259e229af0432214ae6cb2c1f750750"
    },
    "receiptsRoot": {
      "value": "0xbea5cd80cb9a2264ea6d48320cae033f863592771513ee1addcabb40327db129"
    },
    "sha3Uncles": {
      "value": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
    },
    "stateRoot": {
      "value": "0x1e302241298f913b30f7a0df60272c9983d8d8726932f66582f182bd99ef42bc"
    },
    "transactionsRoot": {
      "value": "0x4eb851a13c63ad37eb8e7ca618cc23987469fc347539689a28484c5d1ccd31d7"
    }
  }
}

Example Response: Transaction

"validation": {
  "hash": {
    "data": {
      "gas": "4436670",
      "gasPrice": "1400000000",
      "input": "0x724ef9...",
      "nonce": "6",
      "to": "0x4459b42d034330ecc1e4d604c0a5c855b857df2c",
      "value": "0",
      "r": "0x1c3cb405d96057e71706761611512d89508e9316fa9999c9d214f0240ac14ba5",
      "s": "0x418f42217acf527bee526c626bd144d0cd4de2529148c165fbbd0ab44d992087",
      "v": "38"
    },
    "value": "0x5c0eac44212b783822d0b725319304b7bc43e81ff0cf7db648a11d096b47598e"
  }
}

Include Price

Query parameter: includePrice

Value

Description

true

Include price data.

false

Default. Don't include price data.

Blockchain data endpoints have the option to include price data in the response.

Example Response

{
  "price": {
    "value": {
      "currency": "usd",
      "quote": "174.623263251",
      "total": "91.24846943967798225000000000000"
    }
}

Currency

(To be used in conjunction with includePrice)
Query parameter: currency
Options: usd btc eth (These vary by endpoint)

Value

Description

usd

United States Dollar

btc

Bitcoin (coming soon)

eth

Ether (coming soon)

This option selects the currency type to be returned with the includePrice
Example Response

{
  ...
  "price": {
    "value": {
      "currency": "eth",
      "quote": "174.623263251",
      "total": "91.24846943967798225000000000000"
    }
  }
}