ETH Network Data

Ethereum on-chain network data including but not limited to token movements, fees, supply, address movements, etc. All metrics have data entries starting from the genesis block (block height 0, datetime 2015-07-30 15:26:13).

Supply

get

This endpoint returns metrics related to Ethereum supply, i.e. the amount of Ethereum in existence. We currently provide two metrics, supply_total, the total amount of Ethereum in existence (sum of all Ethereum issued by the block rewards), and supply_new, the amount of newly issued tokens in a given window.

Authorizations

AuthorizationstringRequired

For each API request, include this HTTP header: Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required. You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.

Example: 20191001T100000

toanyOptional

This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

supply_total, supply_new.

application/json

get/eth/network-data/supply

curl "https://api.cryptoquant.com/v1/eth/network-data/supply?window=day"

200

supply_total, supply_new.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "supply_total": null,
        "supply_new": null
      },
      {
        "date": "2019-09-01",
        "supply_total": null,
        "supply_new": null
      }
    ]
  }
}

Velocity

get

This endpoint returns metrics related to the velocity of Ethereum. Ethereum's velocity is calculated by dividing the trailing 1 year estimated transaction volume(the cumulated sum of transferred tokens) by current supply. Velocity is a metric that explains how actively is money circulating in the market.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

Estimated transaction volume in the trailing 1 year divided by current total supply.

application/json

get/eth/network-data/velocity

curl "https://api.cryptoquant.com/v1/eth/network-data/velocity?window=day"

200

Estimated transaction volume in the trailing 1 year divided by current total supply.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "velocity_supply_total": null
      },
      {
        "date": "2021-09-01",
        "velocity_supply_total": null
      }
    ]
  }
}

Contracts Count

get

This endpoint returns metrics related to the number of contracts. We provide contracts_created_new representing the number of contracts created, contracts_destroyed_new representing the number of contracts destroyed, and contracts_count_total representing the unique number of contracts.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

contracts_created_new, contracts_destroyed_new, contracts_count_total.

application/json

get/eth/network-data/contracts-count

curl "https://api.cryptoquant.com/v1/eth/network-data/contracts-count?window=day"

200

contracts_created_new, contracts_destroyed_new, contracts_count_total.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "contracts_created_new": null,
        "contracts_destroyed_new": null,
        "contracts_count_total": null
      },
      {
        "date": "2021-09-01",
        "contracts_created_new": null,
        "contracts_destroyed_new": null,
        "contracts_count_total": null
      }
    ]
  }
}

Transactions Count

get

This endpoint returns metrics related to the number of transactions. We provide several metrics, transactions_count_total, the total number of transactions, transactions_count_mean, the mean number of transactions.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

transactions_count_total, transactions_count_mean.

application/json

get/eth/network-data/transactions-count

curl "https://api.cryptoquant.com/v1/eth/network-data/transactions-count?window=day"

200

transactions_count_total, transactions_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "transactions_count_total": null,
        "transactions_count_mean": null
      },
      {
        "date": "2019-09-01",
        "transactions_count_total": null,
        "transactions_count_mean": null
      }
    ]
  }
}

Transactions Count Between EOA

get

This endpoint returns metrics related to the number of transactions between externally owned accounts (EOAs).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

transactions_count_total, transactions_count_mean.

application/json

get/eth/network-data/transactions-count-between-eoa

curl "https://api.cryptoquant.com/v1/eth/network-data/transactions-count-between-eoa?window=day"

200

transactions_count_total, transactions_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "transactions_count_total": null,
        "transactions_count_mean": null
      },
      {
        "date": "2021-09-01",
        "transactions_count_total": null,
        "transactions_count_mean": null
      }
    ]
  }
}

Contract Calls Count External

get

This endpoint returns metrics related to the number of external contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

contract_calls_count_total, contract_calls_count_mean.

application/json

get/eth/network-data/contract-calls-count-external

curl "https://api.cryptoquant.com/v1/eth/network-data/contract-calls-count-external?window=day"

200

contract_calls_count_total, contract_calls_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "contract_calls_count_total": null,
        "contract_calls_count_mean": null
      },
      {
        "date": "2021-09-01",
        "contract_calls_count_total": null,
        "contract_calls_count_mean": null
      }
    ]
  }
}

Contract Calls Count Internal

get

This endpoint returns metrics related to the number of internal contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

contract_calls_count_total, contract_calls_count_mean.

application/json

get/eth/network-data/contract-calls-count-internal

curl "https://api.cryptoquant.com/v1/eth/network-data/contract-calls-count-internal?window=day"

200

contract_calls_count_total, contract_calls_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "contract_calls_count_total": null,
        "contract_calls_count_mean": null
      },
      {
        "date": "2021-09-01",
        "contract_calls_count_total": null,
        "contract_calls_count_mean": null
      }
    ]
  }
}

Contract Calls Count

get

This endpoint returns metrics related to the number of contract calls including both internal and external calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

contract_calls_count_total, contract_calls_count_mean.

application/json

get/eth/network-data/contract-calls-count

curl "https://api.cryptoquant.com/v1/eth/network-data/contract-calls-count?window=day"

200

contract_calls_count_total, contract_calls_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "contract_calls_count_total": null,
        "contract_calls_count_mean": null
      },
      {
        "date": "2021-09-01",
        "contract_calls_count_total": null,
        "contract_calls_count_mean": null
      }
    ]
  }
}

Transactions Count All

get

This endpoint returns metrics related to the number of transactions including internal contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

transactions_count_total, transactions_count_mean.

application/json

get/eth/network-data/transactions-count-all

curl "https://api.cryptoquant.com/v1/eth/network-data/transactions-count-all?window=day"

200

transactions_count_total, transactions_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "transactions_count_total": null,
        "transactions_count_mean": null
      },
      {
        "date": "2021-09-01",
        "transactions_count_total": null,
        "transactions_count_mean": null
      }
    ]
  }
}

Addresses Count

get

This endpoint returns metrics relating to the number of used Ethereum addresses. We provide several metrics, addresses_count_active, the total number of unique addresses that were active (either sender or receiver) on the blockchain in a given window, addresses_count_sender, the number of addresses that were active as a sender, and addresses_count_receiver, the number of addresses that were active as a receiver.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

addresses_count_active, addresses_count_sender, addresses_count_receiver.

application/json

get/eth/network-data/addresses-count

curl "https://api.cryptoquant.com/v1/eth/network-data/addresses-count?window=day"

200

addresses_count_active, addresses_count_sender, addresses_count_receiver.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "addresses_count_active": null,
        "addresses_count_sender": null,
        "addresses_count_receiver": null
      },
      {
        "date": "2019-09-01",
        "addresses_count_active": null,
        "addresses_count_sender": null,
        "addresses_count_receiver": null
      }
    ]
  }
}

Addresses Count All

get

This endpoint returns metrics related to the number of used Ethereum addresses including internal contract calls. We provide several metrics, addresses_count_active, the total number of unique addresses that were active (either sender or receiver) on the blockchain, addresses_count_sender, the number of addresses that were active as a sender, and addresses_count_receiver, the number of addresses that were active as a receiver.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

addresses_count_active, addresses_count_sender, addresses_count_receiver.

application/json

get/eth/network-data/addresses-count-all

curl "https://api.cryptoquant.com/v1/eth/network-data/addresses-count-all?window=day"

200

addresses_count_active, addresses_count_sender, addresses_count_receiver.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "addresses_count_active": null,
        "addresses_count_sender": null,
        "addresses_count_receiver": null
      },
      {
        "date": "2019-09-01",
        "addresses_count_active": null,
        "addresses_count_sender": null,
        "addresses_count_receiver": null
      }
    ]
  }
}

Tokens Transferred Count

get

This endpoint returns metrics related to the number of tokens transferred executed. We provide several metrics, tokens_transferred_count_total, the total number of executed tokens transferred, and tokens_transferred_count_mean, the mean number of executed tokens transferred.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_count_total, tokens_transferred_count_mean.

application/json

get/eth/network-data/tokens-transferred-count

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-count?window=day"

200

tokens_transferred_count_total, tokens_transferred_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      }
    ]
  }
}

Tokens Transferred Count Between EOA

get

This endpoint returns metrics related to the number of tokens transferred executed between externally owned accounts (EOAs).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_count_total, tokens_transferred_count_mean.

application/json

get/eth/network-data/tokens-transferred-count-between-eoa

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-count-between-eoa?window=day"

200

tokens_transferred_count_total, tokens_transferred_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      }
    ]
  }
}

Tokens Transferred Count By Contract Calls External

get

This endpoint returns metrics related to the number of tokens transferred executed by external contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_count_total, tokens_transferred_count_mean.

application/json

get/eth/network-data/tokens-transferred-count-by-contract-calls-external

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-count-by-contract-calls-external?window=day"

200

tokens_transferred_count_total, tokens_transferred_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      }
    ]
  }
}

Tokens Transferred Count By Contract Calls Internal

get

This endpoint returns metrics related to the number of tokens transferred executed by internal contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_count_total, tokens_transferred_count_mean.

application/json

get/eth/network-data/tokens-transferred-count-by-contract-calls-internal

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-count-by-contract-calls-internal?window=day"

200

tokens_transferred_count_total, tokens_transferred_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      }
    ]
  }
}

Tokens Transferred Count By Contract Calls

get

This endpoint returns metrics related to the number of tokens transferred executed by contract calls including both internal and external calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_count_total, tokens_transferred_count_mean.

application/json

get/eth/network-data/tokens-transferred-count-by-contract-calls

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-count-by-contract-calls?window=day"

200

tokens_transferred_count_total, tokens_transferred_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      }
    ]
  }
}

Tokens Transferred Count All

get

This endpoint returns metrics related to the number of tokens transferred executed including internal contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_count_total, tokens_transferred_count_mean.

application/json

get/eth/network-data/tokens-transferred-count-all

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-count-all?window=day"

200

tokens_transferred_count_total, tokens_transferred_count_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_count_total": null,
        "tokens_transferred_count_mean": null
      }
    ]
  }
}

Tokens Transferred

get

This endpoint returns metrics related to the number of tokens transferred, i.e transaction volume. We provide several metrics, tokens_transferred_total, the total number of transferred tokens in that window, tokens_transferred_mean, the mean of transferred tokens per transaction in that window, and tokens_transferred_median, the median of tokens transferred per transaction. We also provide this value in USD units.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

application/json

get/eth/network-data/tokens-transferred

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred?window=day"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      }
    ]
  }
}

Tokens Transferred Between EOA

get

This endpoint returns metrics related to the number of tokens transferred, i.e transaction volume. Note these metrics include transactions with tokens transferred between externally owned accounts (EOAs).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

application/json

get/eth/network-data/tokens-transferred-between-eoa

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-between-eoa?window=day"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      }
    ]
  }
}

Tokens Transferred By Contract Calls External

get

This endpoint returns metrics related to the number of tokens transferred by external contract calls, i.e transaction volume.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

application/json

get/eth/network-data/tokens-transferred-by-contract-calls-external

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-by-contract-calls-external?window=day"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      }
    ]
  }
}

Tokens Transferred By Contract Calls Internal

get

This endpoint returns metrics related to the number of tokens transferred by internal contract calls, i.e transaction volume.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

application/json

get/eth/network-data/tokens-transferred-by-contract-calls-internal

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-by-contract-calls-internal?window=day"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      }
    ]
  }
}

Tokens Transferred By Contract Calls

get

This endpoint returns metrics related to the number of tokens transferred by contract calls including both internal and external calls, i.e transaction volume.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

application/json

get/eth/network-data/tokens-transferred-by-contract-calls

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-by-contract-calls?window=day"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      }
    ]
  }
}

Tokens Transferred All

get

This endpoint returns metrics related to the number of tokens transferred, i.e transaction volume. Note these metrics include internal contract calls.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

application/json

get/eth/network-data/tokens-transferred-all

curl "https://api.cryptoquant.com/v1/eth/network-data/tokens-transferred-all?window=day"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median, tokens_transferred_total_usd, tokens_transferred_mean_usd, tokens_transferred_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      },
      {
        "date": "2021-09-01",
        "tokens_transferred_total": null,
        "tokens_transferred_mean": null,
        "tokens_transferred_median": null,
        "tokens_transferred_total_usd": null,
        "tokens_transferred_mean_usd": null,
        "tokens_transferred_median_usd": null
      }
    ]
  }
}

Failed Transactions Count

get

This endpoint returns metrics related to the number of failed transactions. We provide failed_transactions_count_total metric, the total number of failed transactions.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The number of failed transactions count.

application/json

get/eth/network-data/failed-transactions-count

curl "https://api.cryptoquant.com/v1/eth/network-data/failed-transactions-count?window=day"

200

The number of failed transactions count.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "failed_transactions_count_total": null
      },
      {
        "date": "2021-09-01",
        "failed_transactions_count_total": null
      }
    ]
  }
}

Failed Tokens Transferred Count

get

This endpoint returns metrics related to the number of failed transactions with tokens transferred. We provide failed_tokens_transferred_count_total metric, the total number of failed transactions with tokens transferred.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The number of failed tokens transferred count.

application/json

get/eth/network-data/failed-tokens-transferred-count

curl "https://api.cryptoquant.com/v1/eth/network-data/failed-tokens-transferred-count?window=day"

200

The number of failed tokens transferred count.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "failed_tokens_transferred_count_total": null
      },
      {
        "date": "2021-09-01",
        "failed_tokens_transferred_count_total": null
      }
    ]
  }
}

Block Bytes

get

The mean size(in bytes) of all blocks generated.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The mean size(in bytes) of all blocks generated.

application/json

get/eth/network-data/block-bytes

curl "https://api.cryptoquant.com/v1/eth/network-data/block-bytes?window=day"

200

The mean size(in bytes) of all blocks generated.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "block_bytes": null
      },
      {
        "date": "2019-09-01",
        "block_bytes": null
      }
    ]
  }
}

Block Count

get

The number of blocks generated in a given window.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently, we support day, hour, and 10min.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The number of blocks generated in a given window.

application/json

get/eth/network-data/block-count

curl "https://api.cryptoquant.com/v1/eth/network-data/block-count?window=day"

200

The number of blocks generated in a given window.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "block_count": null
      },
      {
        "date": "2019-09-01",
        "block_count": null
      }
    ]
  }
}

Block Interval

get

The average time between blocks generated displayed in seconds.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The average time between blocks generated in seconds.

application/json

get/eth/network-data/block-interval

curl "https://api.cryptoquant.com/v1/eth/network-data/block-interval?window=day"

200

The average time between blocks generated in seconds.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "block_interval": null
      },
      {
        "date": "2019-09-01",
        "block_interval": null
      }
    ]
  }
}

Fees

get

This endpoint returns the statistics related to fees paid from executing transactions. We provide the following statistics, fees_total, the sum of all fees, fees_block_mean, the average fee per block, and fees_reward_percent, the percentage of fees relative to the total block reward. We provide the metrics in both ETH and USD units.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_total, fees_total_usd, fees_block_mean, fees_block_mean_usd, fees_reward_percent.

application/json

get/eth/network-data/fees

curl "https://api.cryptoquant.com/v1/eth/network-data/fees?window=day"

200

fees_total, fees_total_usd, fees_block_mean, fees_block_mean_usd, fees_reward_percent.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_block_mean": null,
        "fees_block_mean_usd": null,
        "fees_total": null,
        "fees_total_usd": null,
        "fees_reward_percent": null
      },
      {
        "date": "2019-09-01",
        "fees_block_mean": null,
        "fees_block_mean_usd": null,
        "fees_total": null,
        "fees_total_usd": null,
        "fees_reward_percent": null
      }
    ]
  }
}

Fees Burnt

get

This endpoint returns the statistics related to fees burnt in Ethereum chain by executing transactions, introduced after London upgrade. We provide the total amount of burnt fees as fees_burnt_total in ETH and fees_burnt_total_usd in USD units. These metrics have data entries starting post to London upgrade (block height 12965000, datetime 2021-08-05 12:33:42).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_burnt_total, fees_burnt_total_usd.

application/json

get/eth/network-data/fees-burnt

curl "https://api.cryptoquant.com/v1/eth/network-data/fees-burnt?window=day"

200

fees_burnt_total, fees_burnt_total_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_burnt_total": null,
        "fees_burnt_total_usd": null
      },
      {
        "date": "2019-09-01",
        "fees_burnt_total": null,
        "fees_burnt_total_usd": null
      }
    ]
  }
}

Fees Tips

get

This endpoint returns the statistics related to fees directly paid to Ethereum miners, introduced after London upgrade. We provide the total amount of fees as tips as fees_tips_total in ETH and fees_tips_total_usd in USD units. These metrics have data entries starting post to London upgrade (block height 12965000, datetime 2021-08-05 12:33:42).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_tips_total, fees_tips_total_usd.

application/json

get/eth/network-data/fees-tips

curl "https://api.cryptoquant.com/v1/eth/network-data/fees-tips?window=day"

200

fees_tips_total, fees_tips_total_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_tips_total": null,
        "fees_tips_total_usd": null
      },
      {
        "date": "2019-09-01",
        "fees_tips_total": null,
        "fees_tips_total_usd": null
      }
    ]
  }
}

Fees Transaction

get

This endpoint returns the statistics related to fees per transaction that are paid from executing transactions. We provide the following statistics, fees_transaction_mean, the average fee per transaction, fees_transaction_median, the median fee per transaction. We provide the metrics in both ETH and USD units.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_transaction_mean, fees_transaction_mean_usd, fees_transaction_median, fees_transaction_median_usd.

application/json

get/eth/network-data/fees-transaction

curl "https://api.cryptoquant.com/v1/eth/network-data/fees-transaction?window=day"

200

fees_transaction_mean, fees_transaction_mean_usd, fees_transaction_median, fees_transaction_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_transaction_mean": null,
        "fees_transaction_mean_usd": null,
        "fees_transaction_median": null,
        "fees_transaction_median_usd": null
      },
      {
        "date": "2019-09-01",
        "fees_transaction_mean": null,
        "fees_transaction_mean_usd": null,
        "fees_transaction_median": null,
        "fees_transaction_median_usd": null
      }
    ]
  }
}

Fees Burnt Transaction

get

This endpoint returns the statistics related to fees per transaction burnt in Ethereum chain by executing transactions, introduced after London upgrade. We provide the average amount of burnt fees per transaction as fees_burnt_transaction_mean and the median amount as fees_burnt_transaction_median. We provide the metrics in both ETH and USD units. These metrics have data entries starting post to London upgrade (block height 12965000, datetime 2021-08-05 12:33:42).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_burnt_transaction_mean, fees_burnt_transaction_mean_usd, fees_burnt_transaction_median, fees_burnt_transaction_median_usd.

application/json

get/eth/network-data/fees-burnt-transaction

curl "https://api.cryptoquant.com/v1/eth/network-data/fees-burnt-transaction?window=day"

200

fees_burnt_transaction_mean, fees_burnt_transaction_mean_usd, fees_burnt_transaction_median, fees_burnt_transaction_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_burnt_transaction_mean": null,
        "fees_burnt_transaction_mean_usd": null,
        "fees_burnt_transaction_median": null,
        "fees_burnt_transaction_median_usd": null
      },
      {
        "date": "2019-09-01",
        "fees_burnt_transaction_mean": null,
        "fees_burnt_transaction_mean_usd": null,
        "fees_burnt_transaction_median": null,
        "fees_burnt_transaction_median_usd": null
      }
    ]
  }
}

Fees Tips Transaction

get

This endpoint returns the statistics related to fees per transaction directly paid to Ethereum miners, introduced after London upgrade. We provide the average amount of fees tips per transaction as fees_tips_transaction_mean and the median amount as fees_tips_transaction_median. We provide the metrics in both ETH and USD units. These metrics have data entries starting post to London upgrade (block height 12965000, datetime 2021-08-05 12:33:42).

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_tips_transaction_mean, fees_tips_transaction_mean_usd, fees_tips_transaction_median, fees_tips_transaction_median_usd.

application/json

get/eth/network-data/fees-tips-transaction

curl "https://api.cryptoquant.com/v1/eth/network-data/fees-tips-transaction?window=day"

200

fees_tips_transaction_mean, fees_tips_transaction_mean_usd, fees_tips_transaction_median, fees_tips_transaction_median_usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_tips_transaction_mean": null,
        "fees_tips_transaction_mean_usd": null,
        "fees_tips_transaction_median": null,
        "fees_tips_transaction_median_usd": null
      },
      {
        "date": "2019-09-01",
        "fees_tips_transaction_mean": null,
        "fees_tips_transaction_mean_usd": null,
        "fees_tips_transaction_median": null,
        "fees_tips_transaction_median_usd": null
      }
    ]
  }
}

Blockreward

get

The sum of block rewards (including mining or staking rewards and transaction fees). We also provide this value in USD units.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The sum of block rewards (including mining or staking rewards and transaction fees). We also provide this value in USD units.

application/json

get/eth/network-data/blockreward

curl "https://api.cryptoquant.com/v1/eth/network-data/blockreward?window=day"

200

The sum of block rewards (including mining or staking rewards and transaction fees). We also provide this value in USD units.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "blockreward": null,
        "blockreward_usd": null
      },
      {
        "date": "2019-09-01",
        "blockreward": null,
        "blockreward_usd": null
      }
    ]
  }
}

Blockreward Except Uncle

get

The sum of block rewards except uncle blocks. We also provide this value in USD units.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The sum of block rewards except uncle blocks. We also provide this value in USD units.

application/json

get/eth/network-data/blockreward-except-uncle

curl "https://api.cryptoquant.com/v1/eth/network-data/blockreward-except-uncle?window=day"

200

The sum of block rewards except uncle blocks. We also provide this value in USD units.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "blockreward_except_uncle": null,
        "blockreward_except_uncle_usd": null
      },
      {
        "date": "2019-09-01",
        "blockreward_except_uncle": null,
        "blockreward_except_uncle_usd": null
      }
    ]
  }
}

Gas

get

This endpoint returns the statistics related to gas used in all transactions. We provide the total amount of gas used as gas_used_total, the average amount of gas used as gas_used_mean, the average gas price as gas_price_mean in Gwei per gas, and the average gas limit as gas_limit_mean.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

gas_used_total, gas_used_mean, gas_price_mean, gas_limit_mean.

application/json

get/eth/network-data/gas

curl "https://api.cryptoquant.com/v1/eth/network-data/gas?window=day"

200

gas_used_total, gas_used_mean, gas_price_mean, gas_limit_mean.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "gas_used_total": null,
        "gas_used_mean": null,
        "gas_price_mean": null,
        "gas_limit_mean": null
      },
      {
        "date": "2019-09-01",
        "gas_used_total": null,
        "gas_used_mean": null,
        "gas_price_mean": null,
        "gas_limit_mean": null
      }
    ]
  }
}

Base Fee

get

Base Fee represents the base fee per gas used to burn the fees in Ethereum chain, introduced after London upgrade. base_fee_mean is the average value of the base fee per gas over the blocks in Gwei.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The average value of the base fee per gas over the blocks in Gwei.

application/json

get/eth/network-data/base-fee

curl "https://api.cryptoquant.com/v1/eth/network-data/base-fee?window=day"

200

The average value of the base fee per gas over the blocks in Gwei.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "base_fee_mean": null
      },
      {
        "date": "2021-09-01",
        "base_fee_mean": null
      }
    ]
  }
}

Max Fee

get

Max Fee represents the fee per gas that the user can maximally admit when submitting the transaction, introduced after London upgrade. max_fee_mean is the average value of the max fee per gas over the transactions in Gwei.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The average value of the max fee per gas over the transactions in Gwei.

application/json

get/eth/network-data/max-fee

curl "https://api.cryptoquant.com/v1/eth/network-data/max-fee?window=day"

200

The average value of the max fee per gas over the transactions in Gwei.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "max_fee_mean": null
      },
      {
        "date": "2021-09-01",
        "max_fee_mean": null
      }
    ]
  }
}

Max Priority Fee

get

Max Priority Fee represents the fee per gas used to provide tips (fees) to the miner, introduced after London upgrade. max_priority_fee_mean is the average value of the max priority fee per gas over the transactions in Gwei.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The average value of the max priority fee per gas over the transactions in Gwei.

application/json

get/eth/network-data/max-priority-fee

curl "https://api.cryptoquant.com/v1/eth/network-data/max-priority-fee?window=day"

200

The average value of the max priority fee per gas over the transactions in Gwei.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "max_priority_fee_mean": null
      },
      {
        "date": "2021-09-01",
        "max_priority_fee_mean": null
      }
    ]
  }
}

Difficulty

get

The mean difficulty of mining a new block.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The mean difficulty of mining a new block.

application/json

get/eth/network-data/difficulty

curl "https://api.cryptoquant.com/v1/eth/network-data/difficulty?window=day"

200

The mean difficulty of mining a new block.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "difficulty": null
      },
      {
        "date": "2019-09-01",
        "difficulty": null
      }
    ]
  }
}

Hashrate

get

The mean speed at which miners in the network are solving hash problems. It is displayed as hashes (GigaBytes) per second.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The mean speed at which hash problems are being solved across all miners in the network. It is displayed as hashes (Gigabytes) per second.

application/json

get/eth/network-data/hashrate

curl "https://api.cryptoquant.com/v1/eth/network-data/hashrate?window=day"

200

The mean speed at which hash problems are being solved across all miners in the network. It is displayed as hashes (Gigabytes) per second.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "hashrate": null
      },
      {
        "date": "2019-09-01",
        "hashrate": null
      }
    ]
  }
}

Uncle Block Count

get

The number of uncle blocks generated in a given window.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The number of uncle blocks generated in a given window.

application/json

get/eth/network-data/uncle-block-count

curl "https://api.cryptoquant.com/v1/eth/network-data/uncle-block-count?window=day"

200

The number of uncle blocks generated in a given window.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "uncle_block_count": null
      },
      {
        "date": "2021-09-01",
        "uncle_block_count": null
      }
    ]
  }
}

Uncle Blockreward

get

The sum of uncle block rewards (including mining or staking rewards and transaction fees). We also provide this value in USD units.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, 10min, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The sum of uncle block rewards (including mining or staking rewards and transaction fees). We also provide this value in USD units.

application/json

get/eth/network-data/uncle-blockreward

curl "https://api.cryptoquant.com/v1/eth/network-data/uncle-blockreward?window=day"

200

The sum of uncle block rewards (including mining or staking rewards and transaction fees). We also provide this value in USD units.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2021-09-02",
        "uncle_blockreward": null,
        "uncle_blockreward_usd": null
      },
      {
        "date": "2021-09-01",
        "uncle_blockreward": null,
        "uncle_blockreward_usd": null
      }
    ]
  }
}

PreviousETH Entity Status

NextETH Exchange Flows

Last updated 8 months ago

Was this helpful?