> For the complete documentation index, see [llms.txt](https://docs.glassnode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.glassnode.com/basic-api/endpoints/institutions.md). # Institutions ## Purpose Bitcoin ETF AUM > \*\*Definition.\*\* The total assets under management of the Purpose Bitcoin ETF fund.\n\n\*\*Notes.\*\* Source: Purpose Investments.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/purpose_etf_aum_sum":{"get":{"summary":"Purpose Bitcoin ETF AUM","description":"**Definition.** The total assets under management of the Purpose Bitcoin ETF fund.\\n\\n**Notes.** Source: Purpose Investments.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.PurposeEtfAumSum?a=BTC)\n","operationId":"institutions.PurposeEtfAumSum","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Purpose Bitcoin ETF Flows > \*\*Definition.\*\* The number of bitcoin flowing into or out of the Purpose Bitcoin ETF.\n\n\*\*Notes.\*\* Source data provided by Purpose Investments.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/purpose_etf_flows_sum":{"get":{"summary":"Purpose Bitcoin ETF Flows","description":"**Definition.** The number of bitcoin flowing into or out of the Purpose Bitcoin ETF.\\n\\n**Notes.** Source data provided by Purpose Investments.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.PurposeEtfFlowsSum?a=BTC)\n","operationId":"institutions.PurposeEtfFlowsSum","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Purpose Bitcoin ETF Holdings > \*\*Definition.\*\* The number of bitcoin held by the Purpose Bitcoin ETF.\n\n\*\*Notes.\*\* Source data provided by Purpose Investments.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/purpose_etf_holdings_sum":{"get":{"summary":"Purpose Bitcoin ETF Holdings","description":"**Definition.** The number of bitcoin held by the Purpose Bitcoin ETF.\\n\\n**Notes.** Source data provided by Purpose Investments.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.PurposeEtfHoldingsSum?a=BTC)\n","operationId":"institutions.PurposeEtfHoldingsSum","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Balances > \*\*Definition.\*\* US Spot ETF Balances reports the most recent balances of the leading Crypto ETFs traded in the U.S., typically reflecting holdings at the end of the previous trading day (T+1). Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\n\n\*\*Technical.\*\* Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The maximum available timestamp per ETF may differ, depending on the issuers\' update frequency. \'Total\' is only updated once data for all contributing ETFs is available.\n\n\*\*Notes.\*\* Source data is publicly available information obtained directly from the respective ETF issuers.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_balances_all":{"get":{"summary":"US Spot ETF Balances","description":"**Definition.** US Spot ETF Balances reports the most recent balances of the leading Crypto ETFs traded in the U.S., typically reflecting holdings at the end of the previous trading day (T+1). Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\\n\\n**Technical.** Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The maximum available timestamp per ETF may differ, depending on the issuers' update frequency. 'Total' is only updated once data for all contributing ETFs is available.\\n\\n**Notes.** Source data is publicly available information obtained directly from the respective ETF issuers.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfBalancesAll?a=BTC)\n","operationId":"institutions.UsSpotEtfBalancesAll","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1month, 1w, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Balances (Latest 24h) > \*\*Definition.\*\* US Spot ETF Balances (Latest 24h) is a consolidated snapshot combining the most recent balances and flows of the leading Crypto ETFs traded in the U.S., joining the latest data points from the \'US Spot ETF Balances\' and \'US Bitcoin ETF Flows\' metrics. Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\n\n\*\*Technical.\*\* Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The maximum available timestamp per ETF may differ, depending on the issuers\' update frequency. \'Total\' is only updated once data for all contributing ETFs is available.\n\n\*\*Notes.\*\* Source data is publicly available information obtained directly from the respective ETF issuers.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_balances_latest":{"get":{"summary":"US Spot ETF Balances (Latest 24h)","description":"**Definition.** US Spot ETF Balances (Latest 24h) is a consolidated snapshot combining the most recent balances and flows of the leading Crypto ETFs traded in the U.S., joining the latest data points from the 'US Spot ETF Balances' and 'US Bitcoin ETF Flows' metrics. Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\\n\\n**Technical.** Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The maximum available timestamp per ETF may differ, depending on the issuers' update frequency. 'Total' is only updated once data for all contributing ETFs is available.\\n\\n**Notes.** Source data is publicly available information obtained directly from the respective ETF issuers.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfBalancesLatest?a=BTC)\n","operationId":"institutions.UsSpotEtfBalancesLatest","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Flows > \*\*Definition.\*\* US Spot ETF Flows is an estimate of the daily net flow of funds within the leading Crypto ETFs traded in the U.S., reflecting day-to-day changes in each ETF\'s holdings. Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\n\n\*\*Technical.\*\* Calculated as the difference between today\'s balance data point and the previously available balance data point in native units. Each day\'s native net flow is then converted into USD using the closing USD exchange rate at 16:00 New York time. Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The maximum available timestamp per ETF may differ, depending on the issuers\' update frequency. \'Total\' is only updated once data for all contributing ETFs is available.\n\n\*\*Notes.\*\* Source data is publicly available information obtained directly from the respective ETF issuers.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_flows_all":{"get":{"summary":"US Spot ETF Flows","description":"**Definition.** US Spot ETF Flows is an estimate of the daily net flow of funds within the leading Crypto ETFs traded in the U.S., reflecting day-to-day changes in each ETF's holdings. Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\\n\\n**Technical.** Calculated as the difference between today's balance data point and the previously available balance data point in native units. Each day's native net flow is then converted into USD using the closing USD exchange rate at 16:00 New York time. Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The maximum available timestamp per ETF may differ, depending on the issuers' update frequency. 'Total' is only updated once data for all contributing ETFs is available.\\n\\n**Notes.** Source data is publicly available information obtained directly from the respective ETF issuers.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfFlowsAll?a=BTC)\n","operationId":"institutions.UsSpotEtfFlowsAll","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1month, 1w, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Net Flows > \*\*Definition.\*\* The total net flow of funds of the leading Crypto ETFs traded in the U.S., reflecting the day-to-day changes in the ETFs\' holdings. Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\n\n\*\*Technical.\*\* Calculated as the difference between today\'s balance data point and the previously available balance data point in native units. Each day\'s native net flow is then converted into USD using the closing USD exchange rate at 16:00 New York time. Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The metric is only updated once data for all contributing ETFs is available.\n\n\*\*Interpretation.\*\* Positive prints mean net inflows into the ETF cohort. Negative prints mean net outflows from it.\n\n\*\*Notes.\*\* Source data is publicly available information obtained directly from the respective ETF issuers.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_flows_net":{"get":{"summary":"US Spot ETF Net Flows","description":"**Definition.** The total net flow of funds of the leading Crypto ETFs traded in the U.S., reflecting the day-to-day changes in the ETFs' holdings. Amongst others, the following Bitcoin ETFs are covered: IBIT by BlackRock, GBTC by Grayscale, BTC by Grayscale (Mini Trust), FBTC by Fidelity, ARKB by Ark/21 Shares, BITB by Bitwise, HODL by VanEck, BRRR by Valkyrie, BTCO by Invesco/Galaxy, EZBC by Franklin Templeton, BTCW by WisdomTree. For Ethereum the following ETFs are supported: ETHA by BlackRock, ETHE by Grayscale, ETH by Grayscale (Mini Trust), FETH by Fidelity, CETH by 21 Shares, ETHW by Bitwise, ETHV by VanEck, QETH by Invesco/Galaxy, EZET by Franklin Templeton.\\n\\n**Technical.** Calculated as the difference between today's balance data point and the previously available balance data point in native units. Each day's native net flow is then converted into USD using the closing USD exchange rate at 16:00 New York time. Data is taken directly from the ETF issuers. Hence, outside trading hours and in particular during the weekend, the metric may receive delayed updates only. The metric is only updated once data for all contributing ETFs is available.\\n\\n**Interpretation.** Positive prints mean net inflows into the ETF cohort. Negative prints mean net outflows from it.\\n\\n**Notes.** Source data is publicly available information obtained directly from the respective ETF issuers.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfFlowsNet?a=BTC)\n","operationId":"institutions.UsSpotEtfFlowsNet","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1month, 1w, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Price > \*\*Definition.\*\* Daily closing stock price of US-traded spot ETFs that hold the selected crypto asset as their underlying (e.g. IBIT, FBTC, GBTC for BTC; ETHA, FETH, ETHE for ETH). One series per ETF ticker.\n\n\*\*Interpretation.\*\* Tracks the secondary-market price of each spot ETF, letting you compare performance across issuers and gauge relative investor demand. The price is already in USD, so it is directly comparable across tickers and over time.\n\n\*\*Technical.\*\* Daily close price per ETF symbol from the US equity (OPRA) feed, denominated in USD. ETFs trade on weekdays only, so no datapoint is produced on weekends or market holidays.\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_price":{"get":{"summary":"US Spot ETF Price","description":"**Definition.** Daily closing stock price of US-traded spot ETFs that hold the selected crypto asset as their underlying (e.g. IBIT, FBTC, GBTC for BTC; ETHA, FETH, ETHE for ETH). One series per ETF ticker.\\n\\n**Interpretation.** Tracks the secondary-market price of each spot ETF, letting you compare performance across issuers and gauge relative investor demand. The price is already in USD, so it is directly comparable across tickers and over time.\\n\\n**Technical.** Daily close price per ETF symbol from the US equity (OPRA) feed, denominated in USD. ETFs trade on weekdays only, so no datapoint is produced on weekends or market holidays.\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfPrice?a=BTC)\n","operationId":"institutions.UsSpotEtfPrice","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Total Trading Volume > \*\*Definition.\*\* Daily aggregate trading volume across all US-traded spot ETFs that hold the selected crypto asset as their underlying, reported as total ETF shares traded (native) and the equivalent USD value.\n\n\*\*Interpretation.\*\* Gauges overall ETF market liquidity and investor activity for the asset. Rising totals often reflect growing institutional participation; compare to per-ETF volume to assess concentration across funds.\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_volume_total":{"get":{"summary":"US Spot ETF Total Trading Volume","description":"**Definition.** Daily aggregate trading volume across all US-traded spot ETFs that hold the selected crypto asset as their underlying, reported as total ETF shares traded (native) and the equivalent USD value.\\n\\n**Interpretation.** Gauges overall ETF market liquidity and investor activity for the asset. Rising totals often reflect growing institutional participation; compare to per-ETF volume to assess concentration across funds.\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfVolumeTotal?a=BTC)\n","operationId":"institutions.UsSpotEtfVolumeTotal","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## US Spot ETF Trading Volume > \*\*Definition.\*\* Daily trading volume of US-traded spot ETFs that hold the selected crypto asset as their underlying. One series per ETF ticker.\n\n\*\*Interpretation.\*\* A measure of liquidity and investor activity in each ETF — higher volume points to stronger participation and easier execution. Available both as the number of ETF shares traded (native) and as the equivalent USD value, so volume can be compared in unit or dollar terms across tickers.\n\n\*\*Technical.\*\* Daily share volume per ETF symbol from the US equity (OPRA) feed. The USD series is the share volume multiplied by that day\'s closing price. ETFs trade on weekdays only, so no datapoint is produced on weekends or market holidays.\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - institutions","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/institutions/us_spot_etf_volume":{"get":{"summary":"US Spot ETF Trading Volume","description":"**Definition.** Daily trading volume of US-traded spot ETFs that hold the selected crypto asset as their underlying. One series per ETF ticker.\\n\\n**Interpretation.** A measure of liquidity and investor activity in each ETF — higher volume points to stronger participation and easier execution. Available both as the number of ETF shares traded (native) and as the equivalent USD value, so volume can be compared in unit or dollar terms across tickers.\\n\\n**Technical.** Daily share volume per ETF symbol from the US equity (OPRA) feed. The USD series is the share volume multiplied by that day's closing price. ETFs trade on weekdays only, so no datapoint is produced on weekends or market holidays.\n\n[View in Studio](https://studio.glassnode.com/charts/institutions.UsSpotEtfVolume?a=BTC)\n","operationId":"institutions.UsSpotEtfVolume","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.glassnode.com/basic-api/endpoints/institutions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.