NFT 조회

개요

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

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

Parameters

이름

타입

설명

참조

network

Array

네트워크

required

account

Array

계정

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": [ ... ], 
                    ...
                }"
            }
        ]
    }
*/

Parameters

이름

타입

설명

참조

network

Array

네트워크

required

account

Array

계정

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": [ ... ], 
                    ...
                }"
            }
        ]
    }
*/

RequestURL

메소드

설명

post

Parameters

이름

타입

설명

참조

network

Array

네트워크

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": [ ... ], 
                    ...
                }"
            }
        ]
    }
*/

PreviousNFT 다중민트 (발행)NextNFT 거래내역

Last updated 1 year ago