NFT 조회

개요

조회하고 싶은 블록체인 네트워크만 설정할 수 있습니다. ERC721, ERC1155를 지원합니다.

1. network와 account를 기재하여 소유자가 소유한 모든 컬렉션에 대한 NFT를 조회할 수 있습니다.

2. network, account, collection_id를 같이 기재하여 소유자가 소유한 해당 컬렉션에 대한 NFT를 조회할 수 있습니다.

Android

Parameters

이름	타입	설명	참조
network	Array <String>	네트워크	required
account	Array <String>	계정	required
collection_id	String	컬렉션 아이디	(select)
sort	String	정렬 (asc, desc)	(select) default: desc
limit	int	수량 (0: 전체)	(select) default: 0
page_number	int	페이지 넘버	(select) default: 1 if limit=not empty, select else if limit=empty, error

Response

이름	타입	설명
result	String	호출 결과 성공여부 (성공: OK, 실패: FAIL)
sum	int	호출 결과 카운터
sort	String	정렬
page_count	int	페이지 수

value (array of object)

이름	타입	설명
network	String	네트워크
collection_id	String	컬렉션 아이디
collection_name	String	컬렉션 이름
collection_symbol	String	컬렉션 심볼
collection_creator	String	컬렉션 생성자
collection_timestamp	date	컬렉션 생성 시간
collection_total_supply	String	컬렉션 총 발행량
nft_type	String	NFT 타입
block_number	int	NFT 블럭 넘버
owner	String	NFT 소유자
token_id	String	NFT 토큰 아이디
token_balance	String	NFT 수량
token_uri	String	NFT 토큰 URI
name	String	NFT 이름
description	String	NFT 설명
image	String	NFT 이미지 URL
external_url	String	NFT 외부 URL
attributes	String	NFT 속성
metadata	String	NFT 메타데이터

example

// parameters
val network = arrayOf("ethereum", "cypress", "polygon", "bnb")
val account = arrayOf("0x...")
val collection_id = "0x..."
val sort = "desc"
val limit = 3
val page_number = 1
val getNFTsByWallet = getNFTsByWalletArray(network, 
    account, 
    collection_id, 
    sort, 
    limit, 
    page_number);
println(getNFTsByWallet)

// result log
/*
    {
        "result": "OK",
        "sum": 10000,
        "sort": "desc",
        "page_count": 100,
        "value": [
            {
                "network": "ethereum",
                "collection_id": "0x...",
                "collection_name": "KTHULU",
                "collection_symbol": "KTH",
                "collection_creator": "0x...",
                "collection_timestamp": 1689673723,
                "collection_total_supply": "30000",
                "nft_type": "erc721",
                "minted_timestamp": 1689673723,
                "block_number": 45244898,
                "owner": "0x...",
                "token_id": "1",
                "token_balance": "1",
                "token_uri": "https://storage.kthulu.io/metadata/1",
                "name": "Emperor Chiu #1",
                "description": "A collection for community members...",
                "image": "https://storage.kthulu.io/image/1.png",
                "external_url": "https://kthulu.io", 
                "attributes": [ ... ],
                "metadata": "{
                    "name": "Emperor Chiu #1",
                    "description": "A collection for community members...",
                    "image": "https://storage.kthulu.io/image/1.png",
                    "external_url": "https://kthulu.io", 
                    "attributes": [ ... ], 
                    ...
                }"
            }
        ]
    }
*/

iOS

Parameters

이름	타입	설명	참조
network	Array <String>	네트워크	required
account	Array <String>	계정	required
collection_id	String	컬렉션 아이디	(select)
sort	String	정렬 (asc, desc)	(select) default: desc
limit	int	수량 (0: 전체)	(select) default: 0
page_number	int	페이지 넘버	(select) default: 1 if limit=not empty, select else if limit=empty, error

Response

이름	타입	설명
result	String	호출 결과 성공여부 (성공: OK, 실패: FAIL)
sum	int	호출 결과 카운터
sort	String	정렬
page_count	int	페이지 수

value (array of object)

이름	타입	설명
network	String	네트워크
collection_id	String	컬렉션 아이디
collection_name	String	컬렉션 이름
collection_symbol	String	컬렉션 심볼
collection_creator	String	컬렉션 생성자
collection_timestamp	date	컬렉션 생성 시간
collection_total_supply	String	컬렉션 총 발행량
nft_type	String	NFT 타입
minted_timestamp	int	NFT 생성 시간
block_number	int	NFT 블럭 넘버
owner	String	NFT 소유자
token_id	String	NFT 토큰 아이디
token_balance	String	NFT 수량
token_uri	String	NFT 토큰 URI
name	String	NFT 이름
description	String	NFT 설명
image	String	NFT 이미지 URL
external_url	String	NFT 외부 URL
attributes	String	NFT 속성
metadata	String	NFT 메타데이터

example

// parameters
let network = ["ethereum", "cypress", "polygon", "bnb"]
let account = ["0x..."]
let collection_id = "0x..."
let sort = "desc"
let limit = 3
let page_number = 1
let getNFTsByWallet = try await getNFTsByWalletArray(network: network, 
    account: account, 
    collection_id: collection_id, 
    sort: sort, 
    limit: limit, 
    page_number: page_number)
print(getNFTsByWallet)

// result log
/*
    {
        "result": "OK",
        "sum": 10000,
        "sort": "desc",
        "page_count": 100,
        "value": [
            {
                "network": "ethereum",
                "collection_id": "0x...",
                "collection_name": "KTHULU",
                "collection_symbol": "KTH",
                "collection_creator": "0x...",
                "collection_timestamp": 1689673723,
                "collection_total_supply": "30000",
                "nft_type": "erc721",
                "minted_timestamp": 1689673723,
                "block_number": 45244898,
                "owner": "0x...",
                "token_id": "1",
                "token_balance": "1",
                "token_uri": "https://storage.kthulu.io/metadata/1",
                "name": "Emperor Chiu #1",
                "description": "A collection for community members...",
                "image": "https://storage.kthulu.io/image/1.png",
                "external_url": "https://kthulu.io", 
                "attributes": [ ... ],
                "metadata": "{
                    "name": "Emperor Chiu #1",
                    "description": "A collection for community members...",
                    "image": "https://storage.kthulu.io/image/1.png",
                    "external_url": "https://kthulu.io", 
                    "attributes": [ ... ], 
                    ...
                }"
            }
        ]
    }
*/

Web

RequestURL

메소드	설명
post	https://app.kthulu.io:3302/nft/getNftListAsync

Parameters

이름	타입	설명	참조
network	Array <String>	네트워크	required
account	String	계정	required
collection_id	String	컬렉션 아이디	(select)
sort	String	정렬 (asc, desc)	(select) default: desc
limit	int	수량 (0: 전체)	(select) default: 0
page_number	int	페이지 넘버	(select) default: 1 if limit=not empty, select else if limit=empty, error

Response

이름	타입	설명
result	String	호출 결과 성공여부 (성공: OK, 실패: FAIL)
sum	int	호출 결과 카운터
sort	String	정렬
page_count	int	페이지 수

value (array of object)

이름	타입	설명
network	String	네트워크
collection_id	String	컬렉션 아이디
collection_name	String	컬렉션 이름
collection_symbol	String	컬렉션 심볼
collection_creator	String	컬렉션 생성자
collection_timestamp	date	컬렉션 생성 시간
collection_total_supply	String	컬렉션 총 발행량
nft_type	String	NFT 타입
minted_timestamp	int	NFT 생성 시간
block_number	int	NFT 블럭 넘버
owner	String	NFT 소유자
token_id	String	NFT 토큰 아이디
token_balance	String	NFT 수량
token_uri	String	NFT 토큰 URI
name	String	NFT 이름
description	String	NFT 설명
image	String	NFT 이미지 URL
external_url	String	NFT 외부 URL
attributes	String	NFT 속성
metadata	String	NFT 메타데이터

example

// parameters
const network = ["ethereum", "cypress", "polygon", "bnb"]
const account = "0x..."
const collection_id = "0x..."
const sort = "desc"
const limit = 100
const page_number = 1
sQuery = {"network":network, 
    "account":account, 
    "collection_id":collection_id,
    "sort": sort,
    "limit":limit,
    "page_number":page_number 
}
let nfts = await nft.getNFTsByWallet(sQuery);
console.log(nfts)

// result log
/*
    {
        "result": "OK",
        "sum": 10000,
        "sort": "desc",
        "page_count": 100,
        "value": [
            {
                "network": "ethereum",
                "collection_id": "0x...",
                "collection_name": "KTHULU",
                "collection_symbol": "KTH",
                "collection_creator": "0x...",
                "collection_timestamp": 1689673723,
                "collection_total_supply": "30000",
                "nft_type": "erc721",
                "minted_timestamp": 1689673723,
                "block_number": 45244898,
                "owner": "0x...",
                "token_id": "1",
                "token_balance": "1",
                "token_uri": "https://storage.kthulu.io/metadata/1",
                "name": "Emperor Chiu #1",
                "description": "A collection for community members...",
                "image": "https://storage.kthulu.io/image/1.png",
                "external_url": "https://kthulu.io", 
                "attributes": [ ... ],
                "metadata": "{
                    "name": "Emperor Chiu #1",
                    "description": "A collection for community members...",
                    "image": "https://storage.kthulu.io/image/1.png",
                    "external_url": "https://kthulu.io", 
                    "attributes": [ ... ], 
                    ...
                }"
            }
        ]
    }
*/