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).
/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>"
| Parameter | Description |
|---|---|
limitquery · 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. |
symbolpath · 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.
| Field | Type | Description |
|---|---|---|
symbol | string | The coin the trust holds, upper-cased. |
days | object[] | Oldest first, one per day. |
days[].date | string | The trading day, YYYY-MM-DD (UTC). |
days[].at | integer | The start of that day, unix seconds (UTC). |
days[].marketPriceUsd | number | null | The price one trust share traded at, US dollars. null before the shares were quoted. |
days[].navUsd | number | null | Net asset value per trust share, US dollars. null when not stated. |
days[].premiumDiscountPct | number | null | How 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