Cardano · Schema

Asset

BlockchainCryptocurrencyProof-of-StakeSmart ContractsWeb3

Properties

Name Type Description
asset string Hex-encoded asset full name
policy_id string Policy ID of the asset
asset_name string Hex-encoded asset name of the asset
fingerprint string CIP14 based user-facing fingerprint
quantity string Current asset quantity
initial_mint_tx_hash string ID of the initial minting transaction
mint_or_burn_count integer Count of mint and burn transactions
onchain_metadata object On-chain metadata which SHOULD adhere to the valid standards, based on which we perform the look up and display the asset (best effort)
onchain_metadata_standard string If on-chain metadata passes validation, we display the standard under which it is valid
onchain_metadata_extra string Arbitrary plutus data (CIP68).
metadata object Off-chain metadata fetched from GitHub based on network. Mainnet: https://github.com/cardano-foundation/cardano-token-registry/ Testnet: https://github.com/input-output-hk/metadata-registry-testnet/
View JSON Schema on GitHub

JSON Schema

asset.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://cardano.blockfrost.io/schema/asset",
  "title": "Asset",
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "example": "b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e",
      "description": "Hex-encoded asset full name"
    },
    "policy_id": {
      "type": "string",
      "example": "b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7",
      "description": "Policy ID of the asset"
    },
    "asset_name": {
      "type": "string",
      "nullable": true,
      "example": "6e7574636f696e",
      "description": "Hex-encoded asset name of the asset"
    },
    "fingerprint": {
      "type": "string",
      "example": "asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w",
      "description": "CIP14 based user-facing fingerprint"
    },
    "quantity": {
      "type": "string",
      "example": "12000",
      "description": "Current asset quantity"
    },
    "initial_mint_tx_hash": {
      "type": "string",
      "example": "6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad",
      "description": "ID of the initial minting transaction"
    },
    "mint_or_burn_count": {
      "type": "integer",
      "example": 1,
      "description": "Count of mint and burn transactions"
    },
    "onchain_metadata": {
      "type": "object",
      "nullable": true,
      "additionalProperties": true,
      "description": "On-chain metadata which SHOULD adhere to the valid standards,\nbased on which we perform the look up and display the asset\n(best effort)\n"
    },
    "onchain_metadata_standard": {
      "type": "string",
      "nullable": true,
      "enum": [
        "CIP25v1",
        "CIP25v2",
        "CIP68v1",
        "CIP68v2",
        "CIP68v3"
      ],
      "description": "If on-chain metadata passes validation, we display the standard\nunder which it is valid\n"
    },
    "onchain_metadata_extra": {
      "type": "string",
      "nullable": true,
      "description": "Arbitrary plutus data (CIP68).\n"
    },
    "metadata": {
      "type": "object",
      "nullable": true,
      "description": "Off-chain metadata fetched from GitHub based on network.\nMainnet: https://github.com/cardano-foundation/cardano-token-registry/\nTestnet: https://github.com/input-output-hk/metadata-registry-testnet/\n",
      "properties": {
        "name": {
          "type": "string",
          "example": "nutcoin",
          "description": "Asset name"
        },
        "description": {
          "type": "string",
          "example": "The Nut Coin",
          "description": "Asset description"
        },
        "ticker": {
          "type": "string",
          "nullable": true,
          "example": "nutc"
        },
        "url": {
          "type": "string",
          "nullable": true,
          "example": "https://www.stakenuts.com/",
          "description": "Asset website"
        },
        "logo": {
          "type": "string",
          "nullable": true,
          "example": "iVBORw0KGgoAAAANSUhEUgAAADAAAAAoCAYAAAC4h3lxAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH5QITCDUPjqwFHwAAB9xJREFUWMPVWXtsU9cZ/8499/r6dZ3E9rUdO7ZDEgglFWO8KaOsJW0pCLRKrN1AqqYVkqoqrYo0ja7bpElru1WairStFKY9WzaE1E1tx+jokKqwtqFNyhKahEJJyJNgJ37E9r1+3HvO/sFR4vhx7SBtfH/F3/l93/f7ne/4PBxEKYU72dj/ZfH772v1TU+HtqbTaX8wOO01GPQpRVH7JEm+vGHDuq6z7/8jUSoHKtaBKkEUFUXdajDy1hUrmrs6zn/wWS7m7pZVjMUirKGUTnzc+e9xLcTrPPVfZzDz06Sc2lyQGEIyAPzT7Xa+dvE/3e+XLaCxoflHsVj8MAAYs74aa/WHoenwvpkZKeFy2Z5NJlOPUkqXZccFwSSrKjlyffjLH+TL6XTUGTGL/6hklD3ldIrj2M5MRmkLBMcvaRLQ1Nj88sxM/HCBfMP+eu/OYGDqe6l0WmpoqJ/88upgrU7HrQNA/cFg6MlkKiLlBtVUO40cx54BgHvLIT/HJLvdeqh/4NKxogKWN7fsCoUi7xTLxLJ4vLq6ak//wKVOrdXtttrTDMPsqJA8AAAwDErdu3VL3alTf5ma9eWCpoKhn5dKpCiqJxicPucQPVu0FHaInn35yHMcKwPAa4SQ3QCwFgDWUko3qSr5vqqSgTypuEg4Mo/zvA74/Y0rZSnZU8akSHV17k2fXfy0txjI5224kEym1s/1EUI7LBbztweHrkzkizn49LP6U6feepFSeggAQK/n04SQZ8bGrxdeQjZrbRvGzLH5hcibRqOhPplMfS1fIY5jz4xPDBdcGggho2h3z9sOLRazdG3wqp9SMgUlzGZ17SSEPsRx7J8CwfGu3PF57WhqqjfN/VxVJUxKUrIdITAXKpDJKFscosdfaFy0u+/K9aXTmXe0kAcAmA5Nng5Hbj6Tj/wCAYFAcN7uEY3GXGazMSHLqVVFapgBoMPna9yqhRAAgCTJMa3YUjZPgNFkSlWYx5eUkx+0tKx83V3rF+cVYJjruWCe133DIXqMmrNrFSDabRcWkywYmG5XFOW6aHcfb9324CoAgMmbo9MIoXkneCajiAihV/c/8eSiBSw4BxyiZxQA6m7H7FBKT2CMn2MY5jFFUX6ZO+5w2j8aHZ7YH40FByrJD5DnHGAY5uTtIA8AgBDaR4F2Yxb3WizCgmtA4ObUPSazodduqz3Suu0hf0U1cjvgdNSJ1dWWveFwdDUAtAiC2Uopdcdi8c9Zlh3GmDGl05mtAKAvo47EcdwThJCjqqpWFxALlNITomg73tff21GRAJez7iVK4WGGYfoJIQduBsbm7UrLm1ueCoUiv65kpiilw1ZbzcFoZOYoIcRTAn6eYZgXJm+Oni+Vd3YJbdyweSch9HlK6SpVVfcyDDq7Yf3m2XPBIXraKyV/a4b9UkLawbLsZgB4rwR8CyGkw13r+5fX27BckwBAEJ47oKpk8+DgUIdod7fV1vqOAMDrlZLPmqKoB+rrvXIgOP6w0WjYy3Ls5RL4bUk52bVm9fqnCk7M3CXU2ND8+MxM7BcIIftiyRYyntcdHh0bmr0wfmXl6p2SJB2KRmP3l4j7zejYUFtRAQAAgslm1Bv4nyGEDpYiIwjmjw0G/RjP866JiclNqqqWfKLq9fyZkdHBBXcnl9O71GDgD8bj0ncRQqZ8sRgzL9yYHH2pqICsOUTPLgA4CXNeZFmzWIS/YhYfjUZmvqPjuceSckrz25pS2h2cmlhbaBwhzr6kfsnL8Xhif55YYFl23Y3Jkdl7EVMoUSA4/q6qqNsBIPd11e52u45FwtG3CSH7yiEPAGC1Vt9dXGBmanDoygFLlbAjtzZCCMyC6VeaOpA1l9N7l1kwtauKaozHE28YTQaQpeR7+TqjxXheR0fHhhgt2CX1S3clEtKC16HL5djYe+niBU0CcmYA2W21/Qih5ZqDcoxlMZ24MaJJAABA87IVJ8Lh6N65Pr1B/+LIyLUfAhRZQvnM6ah7ZDHkAQB0vK6/HHxNTc2ruT5Zkldn/y5LACFk+2LIAwAwCGl6yGSt88KHXbmrBCHkqEgAz+vWLFZALJb4qNwYhFDhCSknkSwnQ4sVgDFeWg7+gQe2r1tAmkGTFQlACHWVg89nhJA9ot3dphV/eeCLp/Pw6K5IQP0S39uLFXCLwDG7zf1cKZxD9LSlUunHc/12u/2t2Vzl/rzu8zb8PZlM7bwdQgDgPK/nX2nddt+53//ht3LW2dS0fF0iLj2vquojuQFmwXRucPBKa8UCmpe1iOFwpAsAfLdJBFBKwVIlXJ2JxqKCxbwyHkvoCkAlv9/71U+7Oq+UJWDZ0hViJBL1cRynbNq0sSeeiPl6ei4NqIqq6TSmlB7X6bjuTEY5pgWfzwxGPZhMpt39/b3vzvWXFGCzulZjjM/DrauDwcAr8bjcgzGjZUuVBMH8k2uDX7wCAFDr8n2LEPI7SqmhTP6SzVbz6MDlz0/nDpT8EmOM22HOvUeWU2wp8iyLgRL6hk7Hrc2SBwC4MTlykmXZRozxn00mbVcphNA5jJmV+chr6oDd5l6jN/A/TqfSuwEAGITGMIsvGo3GTwTB3Dc2NjGSxdZYq4VIOOoNBANnKE0XPXE3brjHOTQ08k2MmVZOxzVJCbkFIQSCYEphzPaFQuGzTpfjb319PZ8UFXin/5OvrHPg/9HueAH/BSUqOuNZm4fyAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTE5VDA4OjUyOjI1KzAwOjAwCmFGlgAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0xOVQwODo1MjoyMyswMDowMBjsyxAAAAAASUVORK5CYII=",
          "description": "Base64 encoded logo of the asset"
        },
        "decimals": {
          "type": "integer",
          "nullable": true,
          "maximum": 255,
          "example": 6,
          "description": "Number of decimal places of the asset unit"
        }
      },
      "required": [
        "name",
        "description",
        "ticker",
        "url",
        "logo",
        "decimals"
      ]
    }
  },
  "required": [
    "asset",
    "policy_id",
    "asset_name",
    "fingerprint",
    "quantity",
    "initial_mint_tx_hash",
    "mint_or_burn_count",
    "metadata",
    "onchain_metadata"
  ]
}