NFT 조회

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

Last updated 1 year ago

개요

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

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

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

Parameters

이름

타입

설명

참조

Response

이름

타입

설명

value (array of object)

이름

타입

설명

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

Response

value (array of object)

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

Parameters

Response

value (array of object)

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