> For the complete documentation index, see [llms.txt](https://gitbook-docs.coinmetrics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-docs.coinmetrics.io/api-reference/meta-data/reference-data/asset-groups.md).

# Asset Groups

Returns a list of asset groups (e.g. stablecoins, tokenized RWAs), each with a fully resolved and deduplicated list of constituent assets.

```json
{"openapi":"3.0.2","info":{"title":"Coin Metrics API v4","version":"4.0.0"},"tags":[{"name":"Reference Data","description":"Metadata information of entities supported by Coin Metrics.\n\n**Endpoints on this page:**\n- `GET /reference-data/asset-groups` — Asset Groups\n- `GET /reference-data/asset-metrics` — Asset metrics\n- `GET /reference-data/assets` — Assets\n- `GET /reference-data/exchange-asset-metrics` — Exchange asset metrics\n- `GET /reference-data/exchange-metrics` — Exchange metrics\n- `GET /reference-data/exchange-pair-metrics` — Exchange pair metrics\n- `GET /reference-data/exchanges` — Exchanges\n- `GET /reference-data/indexes` — Indexes\n- `GET /reference-data/institution-metrics` — Institution metrics\n- `GET /reference-data/market-metrics` — Market metrics\n- `GET /reference-data/markets` — Markets\n- `GET /reference-data/pair-metrics` — Pair metrics\n- `GET /reference-data/pairs` — Pairs\n- `GET /reference-data/protocols` — Protocols"}],"servers":[{"url":"https://api.coinmetrics.io/v4"},{"url":"wss://api.coinmetrics.io/v4"},{"url":"https://community-api.coinmetrics.io/v4"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"description":"Coin Metrics API key can be specified as `?api_key=` query parameter.","in":"query","name":"api_key","type":"apiKey"}},"parameters":{"AssetGroupId":{"description":"Comma separated list of asset group identifiers (e.g. `stablecoin`, `tokenized_equity`). By default all asset groups are returned.","in":"query","name":"groups","schema":{"type":"array","items":{"type":"string"}},"explode":false},"CatalogAssetId":{"description":"Comma separated list of assets. By default all assets are returned. Supports the following formats: `<asset>` - Coin Metrics asset ticker (e.g., `btc`), `<namespace>:<symbol>` - External provider symbol (e.g., `talos:BTC`), `<namespace>:by-id:<id>` - External provider numeric ID (e.g., `talos:by-id:24`). The `namespace` identifies the external data provider (e.g., `talos`). The `by-id` selector indicates lookup by a provider-specific numeric ID rather than symbol.","in":"query","name":"assets","schema":{"type":"array","items":{"type":"string"}},"explode":false},"Pretty":{"description":"Human-readable formatting of JSON responses.","in":"query","name":"pretty","schema":{"type":"boolean","default":false}}},"responses":{"ReferenceDataAssetGroups":{"description":"List of asset groups with fully resolved, deduplicated constituent assets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceDataAssetGroupsResponse"}}}},"AssetGroupNotFound":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Asset group not found."},"Unauthorized":{"description":"Requested resource requires authorization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"UriTooLong":{"description":"Provided URI is too long. It must not be greater than 10000 symbols."}},"schemas":{"ReferenceDataAssetGroupsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AssetGroupInfo"},"type":"array"}},"required":["data"],"type":"object"},"AssetGroupInfo":{"description":"Asset group metadata.","properties":{"group":{"type":"string"},"constituents":{"$ref":"#/components/schemas/AssetGroupConstituents"}},"required":["group","constituents"],"type":"object"},"AssetGroupConstituents":{"description":"Constituents of the asset group, fully resolved and deduplicated.","properties":{"assets":{"description":"Assets belonging to this group or any of its nested subgroups.","items":{"type":"string"},"type":"array"},"groups":{"description":"Direct child groups of this group (not further descendants).","items":{"type":"string"},"type":"array"}},"required":["assets","groups"],"type":"object"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorObject"}},"required":["error"],"type":"object"},"ErrorObject":{"properties":{"type":{"description":"Error type string. Can be used for error identification.","type":"string"},"message":{"description":"Human-friendly error description. Can be amended without prior notification. Do not use for error identification in your code.","type":"string"}},"required":["type","description"],"type":"object"}}},"paths":{"/reference-data/asset-groups":{"get":{"summary":"Asset Groups","description":"Returns a list of asset groups (e.g. stablecoins, tokenized RWAs), each with a fully resolved and deduplicated list of constituent assets.","operationId":"getReferenceDataAssetGroups","tags":["Reference Data"],"parameters":[{"$ref":"#/components/parameters/AssetGroupId"},{"$ref":"#/components/parameters/CatalogAssetId"},{"$ref":"#/components/parameters/Pretty"}],"responses":{"200":{"$ref":"#/components/responses/ReferenceDataAssetGroups"},"400":{"$ref":"#/components/responses/AssetGroupNotFound"},"401":{"$ref":"#/components/responses/Unauthorized"},"414":{"$ref":"#/components/responses/UriTooLong"}}}}}}
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook-docs.coinmetrics.io/api-reference/meta-data/reference-data/asset-groups.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.