NFT Metadata API

NFT 메타데이터 조회 API -- 컨트랙트와 토큰 ID에서 이름, 이미지, 속성, 컬렉션 정보를 가져옵니다. Ethereum과 Base를 지원합니다. x402 기반 호출별 과금(Base L2의 USDC) -- API 키 불필요, 가입 불필요, 요청 제한 없음.

klymax402 마켓플레이스의 일부 -- AI 에이전트를 위한 x402 마이크로결제 API 100개, 단일 지갑, Base의 USDC.

빠른 시작 -- MCP

MCP 클라이언트 설정(Claude Desktop, Cursor, ElizaOS 등)에 추가하세요:

{
  "mcpServers": {
    "nft-metadata": {
      "url": "https://nft-metadata.api.klymax402.com/mcp"
    }
  }
}

Related MCP server: nft-floor

빠른 시작 -- HTTP (x402)

curl -X POST "https://nft-metadata.api.klymax402.com/api/metadata" \
  -H "Content-Type: application/json" \
  -d '{"contract":"...","tokenId":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

x402를 인식하는 모든 클라이언트(@x402/fetch, x402-agent-tools, ATXP)는 402 -> 서명 -> 재시도 사이클을 자동으로 처리합니다.

도구

crypto_get_nft_metadata

컨트랙트 주소와 토큰 ID로 특정 NFT의 메타데이터를 조회해야 할 때 사용하세요. NFT의 전체 상세 정보를 JSON으로 반환합니다.

매개변수

반환값

• name -- NFT 토큰 이름

• description -- 토큰 설명 텍스트

• imageUrl -- NFT 이미지/미디어 URL

• attributes -- trait_type 및 value를 포함한 특성 객체 배열

• collection -- 컬렉션 이름과 컨트랙트 정보

• tokenStandard -- ERC-721 또는 ERC-1155

• chain -- NFT가 있는 블록체인

응답 예시:

{"name":"Bored Ape #1234","description":"A unique digital collectible...","imageUrl":"ipfs://Qm...","attributes":[{"trait_type":"Background","value":"Blue"},{"trait_type":"Fur","value":"Gold"}],"collection":"BoredApeYachtClub","tokenStandard":"ERC-721","chain":"ethereum"}

사용 시점: NFT 검증, 표시, 특성 분석. NFT 마켓플레이스 에이전트와 컬렉션 도구에 필수적입니다.

사용하지 않는 용도: 지갑 잔액 조회(wallet_getPortfolio 사용), ENS 조회(crypto_resolve_ens 사용), 토큰 안전성 확인(token_check_safety 사용).

에이전트 프롬프트 예시

• "컨트랙트 주소와 토큰 ID로 특정 NFT의 메타데이터를 조회해 줘"

결제

• 프로토콜: x402 -- HTTP 기본 호출별 과금, 가입 불필요, API키 불필요

• 네트워크: Base L2 (eip155:8453)

• 자산: USDC

• 파실리테이터: Coinbase CDP (기본), PayAI (대체)

• ATXP를 통해서도 접근 가능 (OAuth로 래핑된 x402, RFC 9728 보호 리소스 준비 메타데이터)

klymax402의 일부

AI 에이전트를 위한 x402 마이크로결제 API 100개 with 단일 of wallet, Base의 USDC, 가입 절차 없음.

• 카탈로그: https://klymax402.com/llms.txt

• 전체 API 참조: https://klymax402.com/llms-full.txt

• 실시간 통계: https://klymax402.com/stats

라이선스

MIT