Overview
네트워크에 존재하는 ERC-721, ERC-1155 기반의 자산에 대한 소유자 계정 별 조회, 컨트랙트 Metadata 조회, 특정 키워드로 Metadata 조회 등을 지원합니다. 향후 새로운 형태의 자산이 정의됨에 따라 향후 추가될 수 있습니다.
컨트랙트 기반의 자산이란, 스마트 컨트랙트상에서 발행된 자산을 의미합니다. EVM 계열의 체인상에 존재하는 ERC20 기반의 Fungible Token, ERC721, ERC1155 등을 기반으로 하는 Non-Fungible Token(NFT)등이 대표적인 컨트랙트 기반의 자산입니다. 컨트랙트 기반 자산의 특징은 자산의 총 발급 수량, 현재 해당 자산을 소유하고 있는 소유자 계정 정보 및 각 계정의 보유 수량 등의 상태 정보가 모두 해당 컨트랙트 내에서 관리된다는 것입니다. 따라서 모든 컨트랙트 기반의 자산은 도메인 내에서 컨트랙트 주소(CA)를 구분자로 가집니다.
Usecases
POST
listNftByOwner- 특정 주소가 소유한 NFT에 대한 목록을 조회할 수 있습니다.
POST
listNftByContract- 특정 컨트랙트가 발행한 NFT 목록을 조회할 수 있습니다.
POST
listNftByOwnerAndContract- 특정 주소가 소유한 특정 컨트랙트에서 발행한 NFT 목록을 조회할 수 있습니다.
POST
listNftOwnerByContract- 특정 컨트랙트에서 발행한 NFT의 Owner 목록을 조회할 수 있습니다.
POST
getNftOwnerByTokenId- TokenId를 이용하여 특정 NFT의 Owner 주소를 조회할 수 있습니다.
POST
listNftContractMetadataByContract- 특정 NFT 컨트랙트의 Metadata를 조회할 수 있습니다.
POST
listNftContractMetadataByOwner- 특정 주소가 소유한 NFT의 컨트랙트 메타데이터를 조회할 수 있습니다.
POST
searchNftContractMetadataByKeyword- 특정 Keyword로 컨트랙트의 메타데이터를 검색할 수 있습니다.
- Keyword로 입력할 수 있는 값은 symbol, name 입니다.
POST
getNftMetadataByTokenId- TokenId를 이용하여 특정 NFT의 메타데이터를 조회할 수 있습니다.
Domain
Non-Fungible Token
Non-Fungible Token(NFT)에서 구분되어지는 각 토큰에 대한 정보를 나타내기 위한 도메인입니다. 각 토큰은 id값을 기준으로 구분되며 발행된 컨트랙트 주소와 결합하면 구분자로 사용 가능합니다.
Property | Type | Description | Required |
---|---|---|---|
id | string | 토큰의 ID | required |
uri | string | NFT의 원본 메타데이터의 위치. | required |
name | string | 토큰의 이름 | optional |
description | string | 토큰 상세 | optional |