NFT 조회
개요
조회하고 싶은 블록체인 네트워크만 설정할 수 있습니다. ERC721, ERC1155를 지원합니다.
network와 account를 기재하여 소유자가 소유한 모든 컬렉션에 대한 NFT를 조회할 수 있습니다.
network, account, collection_id를 같이 기재하여 소유자가 소유한 해당 컬렉션에 대한 NFT를 조회할 수 있습니다.
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": [ ... ],
...
}"
}
]
}
*/
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": [ ... ],
...
}"
}
]
}
*/
RequestURL
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": [ ... ],
...
}"
}
]
}
*/
Last updated