Search NFT Contract Metadata By Keyword

post https://web3.nodit.io/v1/{protocol}/{network}/nft/searchNftContractMetadataByKeyword

NFT 컨트랙트의 name 혹은 symbol과 일치하는 컨트랙트 목록을 조회합니다.

🚧
429 에러가 발생했나요? 구독 중인 플랜을 확인하세요!
429 에러는 구독 중인 플랜의 Throughput 제한을 초과했을 때 발생할 수 있습니다.
예를 들어, 무료 플랜은 초당 200CU의 제한이 있기 때문에, 무료 플랜을 사용할 경우 CU 소비량이 350인 API를 호출하면 429 오류가 발생할 수 있습니다.
Compute Unit Costs 페이지에서 사용 중인 API의 CU 소비량을 확인하고, 더 많은 Throughput이 필요하다면 상위 플랜으로 업그레이드하는 것을 고려하세요!
👉 Compute Unit Costs 페이지로 이동하기

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

protocol

string

required

Defaults to polygon

조회 대상 체인의 프로토콜을 지정하기 위한 파라미터입니다.

network

string

required

Defaults to mainnet

조회 대상 체인의 네트워크를 지정하기 위한 파라미터입니다. 프로토콜에 따라 지원되는 네트워크가 다를 수 있습니다.

Body Params

keyword

string

required

Defaults to BAYC

조회하고자 하는 토큰의 name 혹은 symbol을 지정하는 파라미터입니다.

page

integer

page 파라미터는 조회하려는 데이터 페이지를 지정하는 데 사용됩니다. 이 파라미터는 100 이하의 값을 받으며, 100을 초과하는 페이지가 필요한 경우 cursor 페이지네이션 방식을 사용해야 합니다.

page 파라미터와 cursor 파라미터는 동시에 사용할 수 없습니다. page와 cursor에 모두 빈 값을 입력한 경우, cursor 페이지네이션을 사용하는 것으로 간주합니다.

rpp

integer

rpp는 results per page의 약자로, 한 페이지의 사이즈를 지정하는 파라미터입니다. 0보다 크고 1000 이하의 숫자를 지정할 수 있습니다.

cursor

string

cursor 파라미터는 페이지네이션을 위한 파라미터로, 이전 페이지와 다음 페이지 간의 데이터 이동을 지원합니다. 이전 페이지에서 얻은 cursor 값을 다음 요청에 제공하면 다음 페이지의 데이터를 로드할 수 있습니다.

withCount

boolean

Defaults to false

응답에 count 필드의 포함 여부를 지정하는 파라미터이며, count 필드는 요청한 데이터의 총 개수를 나타냅니다. 이 파라미터에 true를 입력한 경우, 응답에 count 필드가 포함되며 응답속도가 느려질 수 있습니다.

Responses

Response body

object

page

integer

page 파라미터에 지정된 페이지 번호를 나타내는 필드입니다. 이 필드는 page 파라미터에 0보다 큰 값을 입력한 경우에만 응답에 포함됩니다.

rpp

integer

rpp 파라미터에 지정된 페이지당 결과 수를 나타내는 필드입니다.

cursor

string

cursor 페이지네이션을 위한 필드로, 다음 페이지의 데이터를 로드하기 위해 다음 요청에 제공해야 하는 값입니다.

count

integer

요청한 데이터의 총 개수를 나타내는 필드입니다. 이 필드는 withCount 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.

items

array of objects

required

조회된 데이터의 목록을 나타내는 필드입니다.

items*

object

address

string

required

컨트랙트 주소를 나타내는 필드입니다.

deployedTransactionHash

string

required

컨트랙트가 배포된 트랜잭션의 해시를 나타내는 필드입니다.

deployedAt

string

required

컨트랙트가 배포된 시간을 나타내는 필드입니다. 이 필드는 ISO 8601 형식의 날짜와 시간으로 제공됩니다.

deployerAddress

string

required

컨트랙트를 배포한 주소를 나타내는 필드입니다.

logoUrl

string

required

Defaults to null

컨트랙트의 로고 URL을 나타내는 필드입니다. 이 URL은 컨트랙트를 시각적으로 식별하는 데 사용될 수 있습니다.

[참고]

모든 컨트랙트의 로고 이미지가 제공되는 것은 아닙니다. 컨트랙트 로고가 없는 경우, 이 필드는 null로 제공됩니다.

type

string

required

컨트랙트의 타입을 나타내는 필드입니다. 컨트랙트 타입은 표준 규격의 이름이 표기됩니다. (e.g., ERC721, ERC1155, ERC20, ERC721, ERC1155, ERC20)

name

string

required

컨트랙트의 이름을 나타내는 필드입니다. 표준을 따르지 않거나, 컨트랙트 생성 단계에서 name을 입력하지 않은 경우 빈 문자열을 반환합니다.

symbol

string

required

컨트랙트의 심볼을 나타내는 필드입니다. 표준을 따르지 않거나, 컨트랙트 생성 단계에서 symbol을 입력하지 않은 경우 빈 문자열을 반환합니다.

totalSupply

string

컨트랙트의 총 공급량을 나타내는 필드입니다. 이 값은 토큰의 총 발행량을 의미하며, 10진수 문자열 형태로 제공됩니다. 컨트랙트 타입이 ERC20인 경우에만 응답에 포함됩니다.

decimals

integer

컨트랙트의 소수점 자리수를 나타내는 필드입니다. 컨트랙트 타입이 ERC20 또는 ERC1155인 경우에만 응답에 포함됩니다.

xxxxxxxxxx
curl --request POST \
     --url https://web3.nodit.io/v1/polygon/mainnet/nft/searchNftContractMetadataByKeyword \
     --header 'X-API-KEY: nodit-demo' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "keyword": "BAYC",
  "withCount": false
}
'

200Successful Response

400Bad Request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests