curl https://catchbackcards.com/api/partner-nfts/metadata/196/81264573985362058461377125337283195667
{
"name": "Charizard ex 199/165 (PSA 10)",
"description": "A physical collectible held in the CatchBack vault. Burn this token to sell it back or have it shipped.",
"image": "https://...",
"external_url": "https://catchbackcards.com",
"attributes": [
{ "trait_type": "Category", "value": "pokemon" },
{ "trait_type": "Grade", "value": "PSA 10" },
{ "trait_type": "Status", "value": "Vaulted" }
]
}
Tokens & sell-back
Token metadata
A token’s standard NFT metadata, which wallets and marketplaces read with no key. No prices.
GET
/
api
/
partner-nfts
/
metadata
/
{chainId}
/
{tokenId}
curl https://catchbackcards.com/api/partner-nfts/metadata/196/81264573985362058461377125337283195667
{
"name": "Charizard ex 199/165 (PSA 10)",
"description": "A physical collectible held in the CatchBack vault. Burn this token to sell it back or have it shipped.",
"image": "https://...",
"external_url": "https://catchbackcards.com",
"attributes": [
{ "trait_type": "Category", "value": "pokemon" },
{ "trait_type": "Grade", "value": "PSA 10" },
{ "trait_type": "Status", "value": "Vaulted" }
]
}
No key · No scope
Every token carries a standard metadata URL that wallets and marketplaces read without a key, from anywhere. On EVM it is the token’s
tokenURI; on Solana it is the asset’s uri.
| Mint chain | URL |
|---|---|
| EVM | https://catchbackcards.com/api/partner-nfts/metadata/{chainId}/{tokenId} |
| Solana | https://catchbackcards.com/api/partner-nfts/metadata/{id} (our id for the asset) |
- It never includes a price or value of any kind.
- It is cached for a few minutes.
- A token whose mint hasn’t been sent yet answers
404. - A trailing
.jsonon the last path segment is accepted.
Response
{ "trait_type", "value" } pairs: Category, Set, Year, Number, Grade, Cert, Language, Brand, Size and Condition where the item has them, and Status (Vaulted, or Redeemed once burned).Errors
| Status | When |
|---|---|
404 | No such token, or its mint hasn’t been sent yet ("error": "Unknown token") |
503 | Briefly unavailable; retry shortly |
curl https://catchbackcards.com/api/partner-nfts/metadata/196/81264573985362058461377125337283195667
{
"name": "Charizard ex 199/165 (PSA 10)",
"description": "A physical collectible held in the CatchBack vault. Burn this token to sell it back or have it shipped.",
"image": "https://...",
"external_url": "https://catchbackcards.com",
"attributes": [
{ "trait_type": "Category", "value": "pokemon" },
{ "trait_type": "Grade", "value": "PSA 10" },
{ "trait_type": "Status", "value": "Vaulted" }
]
}

