Skip to main content

NFT Metadata

Overview​

The Metadata API is a small, public, read-only service for looking up a CollectorCrypt NFT's metadata and images by its on-chain mint address. There is nothing to sign and no authentication — every route is a plain GET keyed by the Solana mint address.

It's handy whenever you have a mint and want a stable URL for the item's JSON metadata or its front/back image without going through the marketplace API or resolving the on-chain URI yourself.

  • Solana only. The path parameter is the NFT's mint address (base58), i.e. the nftAddress returned by the Marketplace API.
  • Cached. Every response sets Cache-Control: public, max-age=300 and is served through CloudFront.
  • Always resolvable images. Image routes redirect to the CDN-hosted copy of the image; if a card has no stored image the route falls back to the CollectorCrypt placeholder rather than failing.
  • Sized images. /front and /back return the image 1024 px wide by default. Add ?width= for another width, or ?width=full for the original. See Image sizes.

Base URL​

EnvironmentBase URL
Productionhttps://nft.collectorcrypt.com
Devnethttps://nft-dev.collectorcrypt.com

All routes below are relative to the base URL.

Endpoints​

1. Get metadata — GET /metadata/{address}​

Returns the item's metadata as JSON, in the standard Metaplex shape (name, image, properties.files, external_url, attributes). The image and properties.files URIs usually point to the CloudFront copies of the card images; some older items point to Arweave. attributes mirror the traits minted on-chain.

curl "https://nft.collectorcrypt.com/metadata/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6"

Response — application/json:

{
"name": "2025 #018 Tashigi PSA 10 Japanese EB03-Extra Booster - Heroines Edition- One Piece",
"image": "https://d1xpxki1g4htqu.cloudfront.net/1dJtD3nR4WoI8We6-hCMPIrDTRvLF7E2u4gf-F1bhlU",
"properties": {
"files": [
{ "uri": "https://d1xpxki1g4htqu.cloudfront.net/1dJtD3nR4WoI8We6-hCMPIrDTRvLF7E2u4gf-F1bhlU" },
{ "uri": "https://d1xpxki1g4htqu.cloudfront.net/NdS28T_85-hPRWoyGWzpHLyUURX2CyzoVe43-7BkjDw" }
]
},
"external_url": "https://collectorcrypt.com/assets/solana/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6",
"attributes": [
{ "trait_type": "Collector Crypt ID", "value": "2026042313C122221" },
{ "trait_type": "Type", "value": "Card" },
{ "trait_type": "Category", "value": "One Piece" },
{ "trait_type": "Year", "value": "2025" },
{ "trait_type": "Grading Company", "value": "PSA" },
{ "trait_type": "The Grade", "value": "GEM-MT 10" },
{ "trait_type": "Grading ID", "value": "140597679" },
{ "trait_type": "Insured Value", "value": "$258.00" }
]
}
FieldDescription
nameThe item name.
imageURL of the full-size front image (the canonical preview). For a smaller one, see Image sizes.
properties.filesFront and back image URLs (files[0] = front, files[1] = back). Present only when the card has a back image.
external_urlThe item's page on collectorcrypt.com.
attributesArray of { trait_type, value } — grading, category, vault, and catalog traits, matching what was minted on-chain.

Error responses

  • 404: No NFT found for that mint address.

2. Get the front image — GET /front/{address}​

Redirects (302) to the front image, 1024 px wide. Follow the redirect to fetch the image bytes.

curl -L "https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6"
HTTP/2 302
location: https://nft.collectorcrypt.com/img/1024/cc/1dJtD3nR4WoI8We6-hCMPIrDTRvLF7E2u4gf-F1bhlU
cache-control: public, max-age=300

Query parameters

  • width (optional, alias w): the width in pixels, or full for the original upload. Default 1024. See Image sizes.
curl -L "https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=512"
curl -L "https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=full"

Error responses

  • 400: width is neither a whole number nor full.
  • 404: No NFT found for that mint address.

3. Get the back image — GET /back/{address}​

Redirects (302) to the back image, exactly like /front for the reverse face. Takes the same width parameter.

curl -L "https://nft.collectorcrypt.com/back/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6"
HTTP/2 302
location: https://d1xpxki1g4htqu.cloudfront.net/NdS28T_85-hPRWoyGWzpHLyUURX2CyzoVe43-7BkjDw
cache-control: public, max-age=300

Error responses

  • 404: No NFT found for that mint address.

Image sizes​

The full image is the original upload, usually 1–4 MB and sometimes larger (the example card's is 3.7 MB). /front and /back therefore return a 1024-px-wide copy unless you ask otherwise.

Add width to /front or /back:

<img src="https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=512" alt="" />
widthExample cardSize
128128 × 2149 KB
256256 × 42731 KB
384384 × 64064 KB
512512 × 854109 KB
768768 × 1280240 KB
1024 (default)1024 × 1707453 KB
15361536 × 25601.0 MB
20482048 × 34131.6 MB
full2591 × 43183.7 MB
  • Any other number rounds up to the next width in the table, so the image is never narrower than you asked for. Above 2048 you get the full image, as with full.
  • Height follows the aspect ratio. The image is never enlarged: a source narrower than width comes back at its own width.
  • Resized images are WebP.
  • The route redirects (302) to the resized image. Link to the /front or /back URL, not to the URL it redirects to; that one may change. The redirect is cached for 5 minutes, so a replaced card photo shows up within 5 minutes.
  • Animated images, SVGs, and images not stored on CollectorCrypt's CDN are not resized, whatever width says; you get the full image. That includes older cards whose image is stored on Arweave (https://arweave.net/...).
  • The metadata's image and properties.files always give the full image.

For responsive pages, let the browser pick:

<img
src="https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=512"
srcset="https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=256 256w,
https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=512 512w,
https://nft.collectorcrypt.com/front/9CCwLhpeZhX4Ekqiv3aEwreMbxsAhh9BXqgtT2B1EpH6?width=1024 1024w"
sizes="(max-width: 600px) 50vw, 256px"
alt=""
/>

Notes​

  • Image fallback. When a card has no stored image (rare), the image routes and the metadata image field fall back to the CollectorCrypt placeholder so links never break. A card with no back image omits properties.files from its metadata.
  • Direct image links. The /front and /back routes return a 302 redirect to the CDN rather than streaming the bytes, so most clients (browsers, <img> tags, social-card scrapers) follow them transparently. The metadata's image and properties.files hold the full-size URLs directly.