NFT 컨트랙트 조회

NFT 컨트랙트 정보를 조회합니다. 조회대상 컨트랙트는 반드시 ERC-721 또는 KIP-17 표준을 지켜야 하며, 올바른 정보 반환을 위해 name(), symbol(), totalSupply() 함수들을 반드시 구현해야합니다.

요청받은 컨트랙트가

  • 존재하지 않을 경우 컨트랙트 주소를 제외한 결과물의 모든 필드는 빈 문자열 또는 0/-1로 채워집니다.
  • ERC-721/KIP-17 표준을 따르지 않을 경우 결과물은 컨트랙트에 따라 다르게 나옵니다.
  • 필수 함수들을 구현하지 않을 경우 해당 함수가 채워주는 결과물의 필드들은 빈 문자열 또는 0/-1로 채워집니다.


주의

NFT 컨트랙트 조회 API는 요청된 주소에 배포된 컨트랙트가 올바른 ERC-721/KIP-17인지 검증하지 않으며, 요청된 주소에 저장된 컨트랙트에 name(), symbol(), totalSupply() 함수를 호출하여 그 결과를 응답으로 돌려줍니다. 이 때문에 NFT 컨트랙트 조회 API에 FT 컨트랙트 주소를 입력할 경우 FT의 name, symbol 등이 반환될 수 있습니다.

Request
Security:
Basic
path Parameters
address
required
string

NFT 컨트랙트 주소

header Parameters
x-chain-id
required
string

Kaia 네트워크 체인 ID (1001 또는 8217)

Responses
200

요청이 성공적입니다.

400

요청이 유효하지 않습니다.

401

자격증명 정보가 유효하지 않습니다.

get/v1/metadata/nft/{address}
Request samples
curl -i -X GET \
  -u <username>:<password> \
  'https://node-api.klaytnapi.com/v1/metadata/nft/{address}' \
  -H 'x-chain-id: string'
Response samples
application/json

요청이 성공적입니다.

{
  • "address": "0x369611bc873b38175b91d6cc8c4018bdd3068b86",
  • "name": "Konnect NFT Certification",
  • "symbol": "KNC",
  • "totalSupply": "0x86"
}