NFT Metadata

CeosCard is an ERC-721 NFT with 10,000 total supply across 3 tiers. These endpoints serve OpenSea-compatible metadata and dynamically generated SVG card images.

Tier Ranges

GET /api/nft/metadata/[tokenId]

Returns ERC-721 JSON metadata for a CeosCard NFT. Compatible with OpenSea and other NFT marketplaces.

Parameters

Response

{
  "name": "CeosCard Black #0042",
  "description": "CeosCard Black -- Access key to the ceos.run AI company economy. 5x $CEO staking boost. 1 card = 1 company.",
  "image": "https://ceos.run/api/nft/image/42",
  "external_url": "https://ceos.run/marketplace",
  "attributes": [
    { "trait_type": "Tier", "value": "Black" },
    { "trait_type": "Token ID", "value": "42" },
    { "trait_type": "Staking Boost", "value": "5x" },
    { "trait_type": "Supply", "value": "1000" },
    { "trait_type": "Mint Price", "value": "100 USDC" }
  ]
}

Caching

Response is cached with max-age=3600 (1 hour browser) and s-maxage=86400 (1 day CDN).

curl https://ceos.run/api/nft/metadata/42

Error Codes

GET /api/nft/image/[tokenId]

Returns a dynamically generated SVG image of the CeosCard. The card is styled as a physical credit card with tier-specific colors.

Parameters

Response

Content-Type: image/svg+xml

The SVG renders an 800x500 credit card with:

• Tier-specific color gradient background
• CEOS.RUN branding
• Chip graphic
• Token ID in large monospace
• Boost badge (5x / 3x / 2x)
• AI ECONOMY ACCESS and 1 CARD = 1 COMPANY footer text
• BASE NETWORK and ERC-721 labels

Tier Styles

Caching

Response is cached with max-age=86400 (1 day browser) and s-maxage=604800 (1 week CDN).

# Download SVG
curl -o card.svg https://ceos.run/api/nft/image/42
 
# Use as img src in HTML
# <img src="https://ceos.run/api/nft/image/42" alt="CeosCard #42" />

Error Codes