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
nftAddressreturned by the Marketplace API. - Cached. Every response sets
Cache-Control: public, max-age=300and 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.
/frontand/backreturn the image 1024 px wide by default. Add?width=for another width, or?width=fullfor the original. See Image sizes.
Base URL
| Environment | Base URL |
|---|---|
| Production | https://nft.collectorcrypt.com |
| Devnet | https://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" }
]
}
| Field | Description |
|---|---|
name | The item name. |
image | URL of the full-size front image (the canonical preview). For a smaller one, see Image sizes. |
properties.files | Front and back image URLs (files[0] = front, files[1] = back). Present only when the card has a back image. |
external_url | The item's page on collectorcrypt.com. |
attributes | Array 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, aliasw): the width in pixels, orfullfor the original upload. Default1024. 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:widthis neither a whole number norfull.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="" />
width | Example card | Size |
|---|---|---|
128 | 128 × 214 | 9 KB |
256 | 256 × 427 | 31 KB |
384 | 384 × 640 | 64 KB |
512 | 512 × 854 | 109 KB |
768 | 768 × 1280 | 240 KB |
1024 (default) | 1024 × 1707 | 453 KB |
1536 | 1536 × 2560 | 1.0 MB |
2048 | 2048 × 3413 | 1.6 MB |
full | 2591 × 4318 | 3.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
2048you get the full image, as withfull. - Height follows the aspect ratio. The image is never enlarged: a source narrower than
widthcomes back at its own width. - Resized images are WebP.
- The route redirects (
302) to the resized image. Link to the/frontor/backURL, 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
widthsays; you get the full image. That includes older cards whose image is stored on Arweave (https://arweave.net/...). - The metadata's
imageandproperties.filesalways 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
imagefield fall back to the CollectorCrypt placeholder so links never break. A card with no back image omitsproperties.filesfrom its metadata. - Direct image links. The
/frontand/backroutes return a302redirect to the CDN rather than streaming the bytes, so most clients (browsers,<img>tags, social-card scrapers) follow them transparently. The metadata'simageandproperties.fileshold the full-size URLs directly.