getAssetsByGroup_v2

POST

/{apiKey}

Returns all Solana NFTs and compressed NFTs belonging to a specific group identified by groupKey and groupValue (for example, all assets in a given collection).

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringrequired

The group classification type to search by (for example, collection, community, creator).

stringrequired

The collection address or group identifier to retrieve all matching NFTs for.

integeroptional

The page of results to return (1-based).

integeroptional

The maximum number of assets to return per page.

objectoptional

Sorting configuration for ordering the returned assets.

stringoptional

The cursor for paginating backwards through the assets.

stringoptional

The cursor for paginating forwards through the assets.

objectoptional

Display and formatting options for the response.

Responses

200

A paginated list of assets in the specified group.

POST/v2/{apiKey}

curl --request POST \  --url https://solana-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "getAssetsByGroup_v2",  "params": {    "groupKey": "collection",    "groupValue": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",    "page": 1,    "limit": 10,    "sortBy": {      "sortBy": "created"    },    "before": "string",    "after": "string",    "options": {      "showUnverifiedCollections": false,      "showCollectionMetadata": false,      "showGrandTotal": false    }  }}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "last_indexed_slot": 365750752,    "total": 1,    "limit": 10,    "page": 1,    "items": [      {        "interface": "ProgrammableNFT",        "id": "JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC",        "authorities": [          {            "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",            "scopes": [              "full"            ]          }        ],        "compression": {          "eligible": false,          "compressed": false,          "data_hash": "",          "creator_hash": "",          "asset_hash": "",          "tree": "",          "seq": 0,          "leaf_id": 0        },        "grouping": [          {            "group_key": "collection",            "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"          }        ],        "royalty": {          "royalty_model": "creators",          "target": null,          "percent": 0.042,          "basis_points": 420,          "primary_sale_happened": true,          "locked": false        },        "creators": [          {            "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv",            "share": 0,            "verified": true          }        ],        "ownership": {          "frozen": true,          "delegated": false,          "delegate": null,          "ownership_model": "single",          "owner": "3F21SJs4FMpsakrxmd8GjgfQZG6BN6MVsvXcm5Yc6Jcf"        },        "mutable": true,        "burnt": false      }    ]  }}

Was this page helpful?