Asset object

Overview

Every DAS method that returns assets uses the same asset object. Fields that do not apply to an asset are omitted. For example, token_info appears only on token-backed assets and plugins only on MPL Core assets.

Example

A programmable NFT from the Mad Lads collection:

{
  "interface": "ProgrammableNFT",
  "id": "JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC",
  "content": {
    "$schema": "https://schema.metaplex.com/nft1.0.json",
    "json_uri": "https://madlads.s3.us-west-2.amazonaws.com/json/6867.json",
    "files": [
      {
        "uri": "https://madlads.s3.us-west-2.amazonaws.com/images/6867.png",
        "mime": "image/png"
      }
    ],
    "metadata": {
      "attributes": [
        { "value": "Male", "trait_type": "Gender" },
        { "value": "Galaxy", "trait_type": "Type" }
      ],
      "description": "Fock it.",
      "name": "Mad Lads #6867",
      "symbol": "MAD",
      "token_standard": "ProgrammableNonFungible"
    },
    "links": {
      "image": "https://madlads.s3.us-west-2.amazonaws.com/images/6867.png",
      "external_url": "https://madlads.com"
    },
    "category": "image"
  },
  "authorities": [
    { "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW", "scopes": ["full"] }
  ],
  "compression": {
    "eligible": false,
    "compressed": false,
    "data_hash": "",
    "creator_hash": "",
    "asset_hash": "",
    "tree": "",
    "seq": 0,
    "leaf_id": 0
  },
  "grouping": [
    { "group_key": "collection", "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w" }
  ],
  "royalty": {
    "royalty_model": "creators",
    "target": null,
    "percent": 0.042,
    "basis_points": 420,
    "primary_sale_happened": true,
    "locked": false
  },
  "creators": [
    { "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv", "share": 0, "verified": true },
    { "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW", "share": 100, "verified": true }
  ],
  "ownership": {
    "frozen": true,
    "delegated": true,
    "delegate": "FARqKAafAbgT25QcgiX5d1g6xpadgG7xymu5N6gSmp4x",
    "ownership_model": "single",
    "owner": "CxBhuJwhVgNMc7yjnRx3XFAsTnnbYDc2bhAGSaLBjNqZ"
  },
  "supply": {
    "print_max_supply": 0,
    "print_current_supply": 0,
    "edition_nonce": 254
  },
  "mutable": true,
  "burnt": false,
  "token_info": {
    "supply": 1,
    "decimals": 0,
    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "associated_token_address": "J4z9rkXuQFVFYEcE4FnbZrT677Eh6WU3f125wyaDyQXg"
  }
}

Fields

string

The asset’s standard. One of V1_NFT, V1_PRINT, LEGACY_NFT, V2_NFT, ProgrammableNFT, FungibleAsset, FungibleToken, MplCoreAsset, MplCoreCollection, MplCoreGroup, MplBubblegumV2, Identity, Executable or Custom.

string

The asset ID. For token-based assets this is the mint address. For compressed NFTs it is the asset ID derived from the tree and leaf index. For MPL Core it is the asset account address.

number

The most recent slot the index had processed when the response was built. Present on single-asset responses and at the top level of list responses.

object

Off-chain metadata and links.

Show content fields

string

Metadata schema URL.

string

URI of the off-chain JSON metadata.

array

Files listed in the metadata. Each has uri and mime, and may have quality and contexts.

object

name, symbol, description, attributes and token_standard. json_name holds the name from the off-chain JSON.

object

Convenience links such as image, animation_url and external_url.

string

Media category from the metadata, such as image or video.

array

Addresses with authority over the asset. Each entry has address and scopes (full, royalty, metadata or extension).

object

Compression state. For uncompressed assets compressed is false and the other fields are empty.

Show compression fields

boolean

Whether the asset is a compressed NFT.

boolean

Whether the asset could be compressed.

string

Merkle tree address.

number

Leaf index in the tree.

number

Sequence number of the last change to the leaf.

string

Hash of the asset metadata.

string

Hash of the creators array.

string

Hash of the leaf.

string

Bubblegum v2 only. Hash of the collection.

string

Bubblegum v2 only. Hash of the asset data.

number

Bubblegum v2 only. Leaf flags.

array

Groups the asset belongs to. Each entry has group_key (usually collection) and group_value (the collection address). Unverified collections appear only with showUnverifiedCollections, and then carry verified: false. collection_metadata appears with showCollectionMetadata.

object

royalty_model (creators, fanout or single), target, percent, basis_points, primary_sale_happened and locked.

array

Creators with address, share (percent of royalties) and verified.

object

Show ownership fields

string

Current owner. Empty for fungible tokens, which have many holders.

string

single for NFTs, token for fungible tokens.

boolean

Whether the asset is frozen.

boolean

Whether a delegate is set.

string | null

Delegate address, if any.

boolean

Present when the asset cannot be transferred.

object | null

Edition supply: print_max_supply, print_current_supply and edition_nonce. Prints also have edition_number and master_edition_mint.

boolean

Whether the metadata can still be changed.

boolean

Whether the asset has been burned.

object

Token details for token-backed assets.

Show token_info fields

number

Total supply in base units.

number

Mint decimals.

string

SPL Token or Token-2022 program ID.

string

Mint authority, if set.

string

Freeze authority, if set.

number

Balance held by the queried owner, in base units.

string

The owner’s associated token account for this mint.

string

Token symbol. Present when a price is available.

object

USD price: price_per_token, total_price (for the owner’s balance) and currency. Present for fungible tokens with a known price.

object

Token-2022 mint extensions, such as metadata pointer, transfer fee and permanent delegate.

object

Token inscription data. Returned with showInscription.

object

MPL Core plugins. external_plugins, unknown_plugins and unknown_external_plugins hold the other plugin types.

object

MPL Core details: num_minted, current_size and plugins_json_version.

object

Legacy Token Metadata uses: use_method, remaining and total.

Get Started

Agents

Products

Solutions

Fetching Data

DAS API

RPC

Data Streaming

Apex

Trading APIs

Overview

Example

Fields

​Overview

​Example

​Fields

Overview

Example

Fields