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 withincludePrice)
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"
    }
  }
}

Page

Query parameter: page
Options: 0 - ∞

Some endpoints contain the column names in the metadata instead of a next field to retrieve the URL of the next page of data. Therefore, you will need to use the page parameter to loop through all pages of data returned, which begins at page 0 for all endpoints where this query parameter is available.