> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# getAssetsByGroup

> 특정 컬렉션 또는 그룹에서 모든 Solana NFT 및 압축된 NFT를 유연한 그룹화 키와 페이지네이션 지원으로 검색

## 요청 매개변수

<ParamField body="groupKey" type="string" required>
  검색할 Solana 그룹 분류 유형 (예: 'collection', 'community', 'creator' 등).
</ParamField>

<ParamField body="groupValue" type="string" required>
  일치하는 모든 NFT를 검색할 Solana 컬렉션 주소 또는 그룹 식별자.
</ParamField>

<ParamField body="page" type="number">
  Solana 컬렉션 결과를 페이지네이션하기 위한 페이지 번호.
</ParamField>

<ParamField body="limit" type="number">
  이 요청에서 반환할 최대 Solana NFT 수.
</ParamField>

<ParamField body="sortBy" type="object">
  응답에 대한 정렬 옵션.
</ParamField>

<ParamField body="sortBy.sortBy" type="string">
  컬렉션에서 검색된 Solana NFT를 정렬할 기준.

  * `created`
  * `recent_action`
  * `updated`
  * `none`
</ParamField>

<ParamField body="sortBy.sortDirection" type="string">
  컬렉션에서 검색된 Solana NFT를 정렬할 방향.

  * `asc`
  * `desc`
</ParamField>

<ParamField body="before" type="string">
  자산을 거꾸로 페이지네이션하기 위한 커서.
</ParamField>

<ParamField body="after" type="string">
  자산을 앞으로 페이지네이션하기 위한 커서.
</ParamField>

<ParamField body="options" type="object">
  응답에 대한 디스플레이 옵션.
</ParamField>

<ParamField body="options.showUnverifiedCollections" type="boolean" default="false">
  건너뛰기 대신 검증되지 않은 컬렉션에 대한 그룹화 정보를 표시합니다.
</ParamField>

<ParamField body="options.showCollectionMetadata" type="boolean" default="false">
  컬렉션의 메타데이터를 표시합니다.
</ParamField>

<ParamField body="options.showGrandTotal" type="boolean" default="false">
  쿼리에 일치하는 자산의 총 수를 보여줍니다. 이로 인해 요청이 느려집니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
  title: Solana NFT 컬렉션 탐색 API
  version: 1.0.0
  description: >
    Solana 블록체인에서 완전한 NFT 컬렉션과 토큰 그룹을 탐색할 수 있는 고급 Solana Digital Asset Standard
    (DAS) API입니다. 이 전문화된 컬렉션 탐색 API는 특정 컬렉션, 커뮤니티 또는 그룹 내의 모든 디지털 자산을 강력한 필터링 및
    정렬 기능으로 검색할 수 있게 합니다. 전통적인 NFT와 압축된 NFT 모두에서 일관된 형식으로 완전한 컬렉션을 표시해야 하는 NFT
    마켓플레이스, 포트폴리오 애플리케이션 및 분석 플랫폼에 적합합니다.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Mainnet RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getAssetsByGroup
      description: >
        특정 컬렉션 또는 그룹에 속한 모든 Solana 디지털 자산을 검색합니다.

        이 강력한 컬렉션 탐색 API는 동일한 그룹 지정(예: 컬렉션, 커뮤니티 또는 기타 그룹)을 공유하는 NFT의 완전한 목록을
        반환하며, 각 자산에 대한 포괄적인 메타데이터와 소유권 세부 정보를 제공합니다. 컬렉션을 표시하는 NFT 마켓플레이스, 그룹화된
        자산을 보여주는 포트폴리오 애플리케이션, Solana 생태계 전반에 걸친 컬렉션별 메트릭을 추적하는 분석 플랫폼에 필수적입니다.
      operationId: rpc
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: JSON-RPC 프로토콜의 버전입니다.
                  default: '2.0'
                id:
                  type: string
                  description: 요청을 식별하기 위한 ID입니다.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getAssetsByGroup
                  description: 호출할 DAS 메서드의 이름입니다.
                  default: getAssetsByGroup
                params:
                  type: object
                  default:
                    groupKey: collection
                    groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
                  properties:
                    groupKey:
                      type: string
                      description: >-
                        검색할 Solana 그룹 분류 유형 (예: 'collection', 'community',
                        'creator' 등)입니다.
                      example: collection
                    groupValue:
                      type: string
                      description: 모든 일치하는 NFT를 검색할 Solana 컬렉션 주소 또는 그룹 식별자입니다.
                      example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
                    page:
                      type: integer
                      description: Solana 컬렉션 결과를 페이지로 나눌 때 사용할 페이지 번호입니다.
                      example: 1
                    limit:
                      type: integer
                      description: 이 컬렉션에서 요청당 반환할 수 있는 최대 Solana NFT 수입니다.
                      example: 100
                    sortBy:
                      type: object
                      description: 응답에 대한 정렬 옵션입니다.
                      properties:
                        sortBy:
                          type: string
                          description: 컬렉션의 검색된 Solana NFT가 정렬될 기준입니다.
                          enum:
                            - created
                            - recent_action
                            - updated
                            - none
                        sortDirection:
                          type: string
                          description: 컬렉션의 검색된 Solana NFT가 정렬될 방향입니다.
                          enum:
                            - asc
                            - desc
                    before:
                      type: string
                      description: 자산을 역순으로 페이지네이션하기 위한 커서입니다.
                      example: string
                    after:
                      type: string
                      description: 자산을 순방향으로 페이지네이션하기 위한 커서입니다.
                      example: string
                    options:
                      type: object
                      description: 응답에 대한 표시 옵션입니다.
                      properties:
                        showUnverifiedCollections:
                          type: boolean
                          description: 검증되지 않은 컬렉션에 대한 그룹 정보를 건너뛰지 않고 표시합니다.
                          default: false
                        showCollectionMetadata:
                          type: boolean
                          description: 컬렉션의 메타데이터를 표시합니다.
                          default: false
                        showGrandTotal:
                          type: boolean
                          description: 쿼리에 일치하는 자산의 총 수를 보여줍니다. 이로 인해 요청이 느려질 수 있습니다.
                          default: false
                  required:
                    - groupKey
                    - groupValue
      responses:
        '200':
          description: 성공적인 응답
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  result:
                    type: object
                    properties:
                      last_indexed_slot:
                        type: integer
                        description: 이 슬롯까지의 모든 데이터가 인덱싱된 것이 보장됩니다.
                        example: 365750752
                      total:
                        type: integer
                        description: 이 컬렉션 또는 그룹에서 발견된 Solana NFT의 총 수입니다.
                        example: 1
                      limit:
                        type: integer
                        description: 요청된 최대 자산 수입니다.
                        example: 1
                      page:
                        type: integer
                        description: 결과의 현재 페이지입니다.
                        example: 1
                      items:
                        type: array
                        description: 이 컬렉션 또는 그룹에 속한 Solana NFT의 배열입니다.
                        items:
                          type: object
                          properties:
                            interface:
                              type: string
                              description: 이 컬렉션의 Solana 토큰 표준 인터페이스입니다.
                              enum:
                                - V1_NFT
                                - V1_PRINT
                                - LEGACY_NFT
                                - V2_NFT
                                - FungibleAsset
                                - FungibleToken
                                - Custom
                                - Identity
                                - Executable
                                - ProgrammableNFT
                                - MplCoreAsset
                                - MplBubblegumV2
                                - MplCoreCollection
                                - MplCoreGroup
                              example: ProgrammableNFT
                            is_agent:
                              type: boolean
                              description: >-
                                이 자산에 에이전트 아이덴티티(MPL Core AgentIdentity 외부
                                플러그인)가 있는지 여부입니다. 거짓일 경우 생략됩니다.
                            agent_token:
                              type: string
                              description: >-
                                Agent Registry 프로그램에서 Base58로 인코딩된 에이전트 토큰
                                민트입니다. 등록되지 않았을 경우 생략됩니다.
                            asset_signer:
                              type: string
                              description: >-
                                MPL Core의 Base58로 인코딩된 자산 서명자 PDA입니다. 해당되지 않을 경우
                                생략됩니다.
                            plugins:
                              type: object
                              description: 선택적 MIP-11 `groups` 멤버십을 포함한 MPL Core 플러그인입니다.
                              additionalProperties: true
                            id:
                              type: string
                              description: 컬렉션 내 이 Solana NFT의 고유 민트 주소입니다.
                              example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
                            authorities:
                              type: array
                              description: 이 컬렉션 내 Solana NFT의 업데이트 권한입니다.
                            compression:
                              type: object
                              description: 이 Solana NFT의 압축 상태로, 상태 압축 기술을 사용하는지 여부를 나타냅니다.
                            grouping:
                              type: array
                              description: 이 Solana NFT의 컬렉션 및 그룹 연결입니다.
                            royalty:
                              type: object
                              description: 마켓플레이스에서 판매될 때 이 Solana NFT의 로열티 구성입니다.
                            creators:
                              type: array
                              description: 컬렉션 내 이 Solana NFT와 관련된 검증된 생성자 주소입니다.
                            ownership:
                              type: object
                              description: 컬렉션 내 이 Solana NFT의 현재 소유권 세부 정보입니다.
                            supply:
                              type: object
                              description: 프린트가 있는 마스터 에디션인 경우 이 Solana NFT의 공급 정보입니다.
                            mutable:
                              type: boolean
                              description: 이 Solana NFT의 메타데이터를 권한이 업데이트할 수 있는지 여부입니다.
                              example: true
                            burnt:
                              type: boolean
                              description: 이 Solana NFT가 소각/파괴되었는지 여부입니다.
                              example: false
        '400':
          description: 잘못된 요청. 서버가 잘못된 문법으로 인해 요청을 이해할 수 없습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: -32602
                      message:
                        type: string
                        example: 유효하지 않은 요청 매개변수입니다.
                  id:
                    type: string
                    example: '1'
        '401':
          description: 권한 없음. 클라이언트는 요청된 응답을 받기 위해 인증해야 합니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: -32001
                      message:
                        type: string
                        example: 인증 실패. API 키가 없거나 유효하지 않습니다.
                  id:
                    type: string
                    example: '1'
        '403':
          description: 금지됨. 클라이언트는 콘텐츠에 대한 액세스 권한이 없습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: -32003
                      message:
                        type: string
                        example: 이 리소스에 접근할 수 있는 권한이 없습니다.
                  id:
                    type: string
                    example: '1'
        '404':
          description: 찾을 수 없음. 서버는 요청된 리소스를 찾을 수 없습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: -32004
                      message:
                        type: string
                        example: 지정된 그룹에 대한 자산을 찾을 수 없습니다.
                  id:
                    type: string
                    example: '1'
        '429':
          description: 요청이 너무 많습니다. 사용자가 일정 시간 동안 너무 많은 요청을 보냈습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: -32029
                      message:
                        type: string
                        example: 속도 제한을 초과했습니다. 나중에 다시 시도하십시오.
                  id:
                    type: string
                    example: '1'
        '500':
          description: 내부 서버 오류. 서버가 처리할 수 없는 상황에 마주쳤습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: '2.0'
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: -32000
                      message:
                        type: string
                        example: 서버에서 예기치 않은 오류가 발생했습니다.
                  id:
                    type: string
                    example: '1'
      security:
        - ApiKeyQuery: []
components:
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
        받을 수 있습니다.

````