FT 컨트랙트 조회

FT 컨트랙트 정보를 조회합니다. ERC-20 또는 KIP-7 표준을 지키는 컨트랙트만 조회 가능합니다. 올바른 정보 반환을 위해서는 name(), symbol(), decimals() 함수들을 반드시 구현해야 합니다.

요청받은 컨트랙트가

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


주의

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

Request
Security:
path Parameters
address
required
string

FT 컨트랙트 주소입니다.

header Parameters
x-chain-id
required
string

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

Responses
200

요청이 성공적입니다.

400

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

401

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

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

요청이 성공적입니다.

{
  • "address": "0x3b3b30a76d169f72a0a38ae01b0d6e0fbee3cc2e",
  • "decimals": 18,
  • "name": "TEMCO",
  • "symbol": "TEMCO",
  • "totalSupply": "0x1363156bbee3016d70000000"
}