ETH Fund Data

This namespace cointains endpoints to retreive metrics related to regulated funds such as trust, including market price, market volume, market premium, and digital asset holdings. These metrics are useful to measure sentiments of investors such as institutions in regulated market. All Symbol will be updated no later then UTC 12:00, this may be changed depending on update time of source data. Also the return value may be changed because of late updated fund.

Supported Symbols

Name

Symbol

Status

Source

All Symbol (ETH)

all_symbol

Validated

All Fund

Grayscale Ethereum Trust (ETHE)

ethe

Validated

Grayscale Investments

Grayscale Ethereum Mini Trust (ETH)

eth

Validated

Grayscale Investments

iShares Ethereum Trust ETF (ETHA)

etha

Validated

BlackRock

Fidelity Ethereum Fund ETF (FETH)

feth

Validated

Fidelity

Bitwise Ethereum ETF (ETHW)

ethw

Validated

Bitwise

21Shares Ethereum Core ETP (CETH)

ceth

Validated

21Shares

Invesco Galaxy Ethereum ETF (QETH)

qeth

Validated

Invesco

VanEck Ethereum ETF (ETHV)

ethv

Validated

VanEck

Franklin Ethereum ETF (EZET)

ezet

Validated

Franklin Templeton

Purpose Ether ETF (ETHH.U)

ethh_u

Validated

Purpose Investments

Market Price USD

get

The price of certain symbol (e.g. ethe) managed by each fund (e.g. Grayscale) reflects sentiment of investors in regulated markets. In this specific case, having single share of ETHE means having approximately 0.01 ETH invested to Grayscale. This endpoint returns metrics related to the US Dollar(USD) price of fund related stocks (e.g. ethe). We provide five metrics, price_usd_open, USD opening price at the beginning of the window, price_usd_close, USD closing price at the end of the window, price_usd_high, the highest USD price in a given window, price_usd_low, the lowest USD price in a given window, and price_usd_adj_close, USD adjusted closing price at the end of the window. All Symbol is not supported.

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

symbolstringRequired

A stock symbol (ticker) from the table that we support. See here

Example: ethe

windowstringOptional

Currently, we only support day.

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

Market Price OHLC and adjusted C Data in USD

application/json

get/eth/fund-data/market-price-usd

curl "https://api.cryptoquant.com/v1/eth/fund-data/market-price-usd?symbol=ethe&window=day&from=20191001&limit=2"

200

Market Price OHLC and adjusted C Data in USD

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "price_usd_open": null,
        "price_usd_high": null,
        "price_usd_low": null,
        "price_usd_close": null,
        "price_usd_adj_close": null
      },
      {
        "date": "2019-10-01",
        "price_usd_open": null,
        "price_usd_high": null,
        "price_usd_low": null,
        "price_usd_close": null,
        "price_usd_adj_close": null
      }
    ]
  }
}

Market Volume

get

The volume of certain symbol (e.g. ethe) managed by each fund (e.g. Grayscale) reflects sentiment of investors in regulated markets. This endpoint returns traded volume of fund related stocks (e.g. ethe). At this endpoint, metrics are calculated by Day. We provide one metric, volume, traded volume of the window.

Authorizations

AuthorizationstringRequired

Query parameters

symbolstringRequired

A stock symbol (ticker) from the table that we support. See here

Example: ethe

windowstringOptional

Currently, we only support day.

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

Market Volume Data

application/json

get/eth/fund-data/market-volume

curl "https://api.cryptoquant.com/v1/eth/fund-data/market-volume?symbol=ethe&window=day&from=20191001&limit=2"

200

Market Volume Data

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

Market Premium

get

The premium of certain symbol (e.g. ethe) is defined as (market price of the symbol - NAV) divided by NAV where NAV (Native Asset Value) is the current value of holdings (e.g. ETH price multiplied by ETH per Share). Higher the premium indicates market bullish, which also indicates downside risk. On the other hand, lower the premium indicates market bearish, which also indicates upside risk. All Symbol market premium is calculated by taking VWAP (Volume Weighted Average Ratio) of each fund data volume (usd).

Authorizations

AuthorizationstringRequired

Query parameters

symbolstringRequired

A stock symbol (ticker) from the table that we support. See here

Example: ethe

windowstringOptional

Currently, we only support day.

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

Market Premium Data

application/json

get/eth/fund-data/market-premium

curl "https://api.cryptoquant.com/v1/eth/fund-data/market-premium?symbol=ethe&window=day&from=20191001&limit=2"

200

Market Premium Data

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

Digital Asset Holdings

get

This endpoint returns digital asset holdings status of each fund. For example, Grayscale ETH Holdings along with ETHE represents how much ETH Grayscale is holding for its investment. This metric indicates stock market's sentiment where higher the value means bullish sentiment of investors in stock market.

Authorizations

AuthorizationstringRequired

Query parameters

symbolstringRequired

A stock symbol (ticker) from the table that we support. See here

Example: ethe

windowstringOptional

Currently, we only support day.

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

Digital Asset Holdings Data

application/json

get/eth/fund-data/digital-asset-holdings

curl "https://api.cryptoquant.com/v1/eth/fund-data/digital-asset-holdings?symbol=ethe&window=day&from=20191001&limit=2"

200

Digital Asset Holdings Data

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

PreviousETH Flow Indicator

NextETH 2.0

Last updated 8 months ago

Was this helpful?