ETFs API

One Grayscale trust's premium or discount to NAV over time

A Grayscale single-coin trust's share price, NAV per share and premium or discount, day by day, by the coin it holds (ETC, BCH, ZEC…; BTC up to its ETF conversion).

GET/api/external/etf/grayscale-trust-premium-history/{symbol}

What it returns

One Grayscale single-coin trust, day by day: the price a trust share traded at, its net asset value per share, and the premium (positive) or discount (negative) between them, in percent. Oldest first, the newest limit days. Before a trust's shares were quoted, the price and premium are null. The history can have gaps of months and can end weeks before today; date says which day each figure is for. Not scoped to any chain. A coin with no trust history answers 404.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/etf/grayscale-trust-premium-history/<symbol>"
Parameters
ParameterDescription
limit

query · integer · optional

How many of the most recent days to return, 1 to 5000. Defaults to 90. Fewer come back when the history is shorter. limit ≤ 300 keeps the answer under 32 KB.
symbol

path · string · required

The coin the trust holds, e.g. "ETC", "BCH" or "ZEC" — as grayscale-trusts lists them; "BTC" gives the bitcoin trust up to its conversion into an ETF. Case-insensitive.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of One Grayscale trust's premium or discount to NAV over time
FieldTypeDescription
symbolstringThe coin the trust holds, upper-cased.
daysobject[]Oldest first, one per day.
days[].datestringThe trading day, YYYY-MM-DD (UTC).
days[].atintegerThe start of that day, unix seconds (UTC).
days[].marketPriceUsdnumber | nullThe price one trust share traded at, US dollars. null before the shares were quoted.
days[].navUsdnumber | nullNet asset value per trust share, US dollars. null when not stated.
days[].premiumDiscountPctnumber | nullHow far the share price stood above (positive) or below (negative) the net asset value, percent. null before the shares were quoted.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key