Cronos ID
  • Welcome to Cronos ID
  • What is Cronos ID?
    • Cronos ID Domains
    • Cronos ID Notifications
      • How Cronos ID Notifications Work?
      • Partner with Cronos ID Notifications
      • Terms & Conditions
    • Cronos ID Messaging
  • Core Utility Modules
  • Tokenomics
  • Domains Pricing Model
  • Roadmap
  • Release Notes
  • Our Partners
  • Get Involved
  • User Guides
    • Getting Started
      • Tokens Needed
      • Bridging Funds to Cronos
      • Connecting Wallet
    • Cronos ID Domains
      • Checking domain availability
      • Checking domain user profile
      • Minting domain
      • Managing domain profile
        • Editing domain profile
        • Adding cryptocurrency addresses
        • Transferring your domain
      • Adding domains to "My Favourite"
      • Claiming domains from direct transfer/NFT marketplace
      • Setting Default Domain
      • Renewing Domain
      • Sub-domain
        • Creating sub-domain
        • Editing controller of sub-domain
        • Managing sub-domain
      • FAQ
    • $CROID Staking Vaults
      • Staking $CROID into Vault
      • Claiming Vault Rewards
      • Staking Additional $CROID into Vaults
      • Upgrading Vaults
      • Unstaking $CROID from Vault
      • FAQ
  • Using Cronos ID on Crypto.com Onchain
    • Crypto.com Onchain Integration
    • For Crypto.com Onchain mobile app users
      • Setting wallet name
      • Sending token
      • Receiving token
      • Sending NFT
      • Receiving NFT
    • For Crypto.com Onchain Extension (Chrome) users
      • Setting wallet name
      • Sending token
      • Receiving token
    • FAQ
  • Fundamentals
    • Team Wallets
    • Tokens Supported
    • Smart Contracts
    • Security
  • Developers Resources
    • Github
    • Domain Integration
      • Use Cases
      • Integrating using ethers.js
      • Integrating using our SDK
    • Notification Integration
      • Submit Your DApp Info
      • Send notifications via our API
      • Integrating using our SDK
    • Metadata Service Guide
  • Extras
    • Protected Domains Policy
    • Community Guidelines
    • Cronos Labs Incubation
    • Risk Disclosure
  • Community Links
    • Twitter
    • Discord
    • Medium
Powered by GitBook
On this page
  • Service Endpoints
  • Contracts
  • NFT Metadata API
  • Request path:
  • Parameters:
  • Response Body:
  • Response Fields:
  • NFT Metadata Image API
  • Request Path:
  • Parameters:
  • Response Body:
  1. Developers Resources

Metadata Service Guide

Cronos ID has a Metadata Service, which allows third party NFT platforms and wallets to integrate and display the information of Cronos IDs.

Service Endpoints

Production Environment https://metadata.cronosid.xyz/

Contracts

  • Testnet, CRORegistrar: 0x8101623b9F430C5A3fa808619456B8d98ba5A894

  • Mainnet, CRORegistrar: 0xf884647Dfa84696d9373F36eE413CCc48093F924

NFT Metadata API

Request path:

/{networkName}/{contractAddress}/{tokenId}

Parameters:

  • Network: Name of the chain to query for (mainnet | testnet)

  • contractAddress: Accepts contractAddress of the NFT which is represented by the tokenId

  • tokenId: Accepts labelhash of Cronos ID domain in both hex and int format

// how to get tokenId for the name 'abcde5.cro' (javascript)
const label = "abcde5".toLowerCase()
ethers.utils.keccak256(ethers.utils.toUtf8Bytes(label))
// or, same
ethers.utils.id(label)

Response Body:

{
  "is_normalized": true,
  "name": "to-the-moon.cro",
  "description": "to-the-moon.cro, an Cronos ID name.",
  "attributes": [
    {
      "trait_type": "Created Date",
      "display_type": "date",
      "value": 1661226007000
    },
    { "trait_type": "Length", "display_type": "number", "value": 11 },
    { "trait_type": "Segment Length", "display_type": "number", "value": 11 },
    {
      "trait_type": "Character Set",
      "display_type": "string",
      "value": "mixed"
    },
    {
      "trait_type": "Registration Date",
      "display_type": "date",
      "value": 1661226007000
    },
    {
      "trait_type": "Expiration Date",
      "display_type": "date",
      "value": 1976795527000
    }
  ],
  "name_length": 11,
  "segment_length": 11,
  "url": "https://cronosid.xyz/name/register/?label=to-the-moon.cro",
  "version": 0,
  "background_image": "https://metadata.cronosid.xyz/testnet/avatar/to-the-moon.cro",
  "image": "https://metadata.cronosid.xyz/testnet/0x8101623b9F430C5A3fa808619456B8d98ba5A894/0x486a8f914586140c471814a37061a30c5fc9585adca7fa5ed0636305c46d73fc/image",
  "image_url": "https://metadata.cronosid.xyz/testnet/0x8101623b9F430C5A3fa808619456B8d98ba5A894/0x486a8f914586140c471814a37061a30c5fc9585adca7fa5ed0636305c46d73fc/image"
}

Response Fields:

Field
Description

name

name of the domain

description

Short description about the name. It contains a warning message if the domain is not comprised of numbers and letters.

is_normalized

attributes

A list of attributes, including: - Created Date - Length - Segment Length - Character Set - Registration Date - Expiration Date

name_length

Character length of the domain

segment_length

Segment length of the domain. Local-sensitive text segmentation obtained by Intl.Segmenter.

url

A URL to the domain's profile page on Cronos ID website

version

Cronos ID NFT version

background_image

Origin URL of the avatar image

image

URL of the domain image to display (recommended)

image_url

URL of the NFT image

NFT Metadata Image API

Request Path:

/{networkName}/{contractAddress}/{tokenId}/image

Parameters:

  • network: Name of the chain to query for (mainnet | testnet)

  • contactAddress: Accepts contractAddress of the NFT which is represented by the tokenId

  • tokenId: Accepts labelhash of Cronos ID domain in both hex and int format

Response Body:

A SVG image file

  • the content-type is ‘image/svg+xml’.

PreviousIntegrating using our SDKNextProtected Domains Policy

Last updated 1 year ago

Whether the domain is normalized. It must follow for normaliztion and validation.

UTS46