OpenSea · Schema

TokenResponse

A token with summary market data

NFTMarketplaceWeb3BlockchainTradingDigital Assets

Properties

Name Type Description
address string The contract address of the token
chain string The blockchain the token is on
name string The display name of the token
symbol string The ticker symbol of the token
image_url string URL of the token's image
usd_price string Current price in USD
decimals integer Number of decimal places
opensea_url string URL to the token page on OpenSea
market_cap_usd number Market capitalization in USD
volume_24h number 24-hour trading volume in USD
price_change_24h number Price change percentage over the last 24 hours
View JSON Schema on GitHub

JSON Schema

TokenResponse.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opensea.io/schemas/TokenResponse",
  "title": "TokenResponse",
  "type": "object",
  "description": "A token with summary market data",
  "properties": {
    "address": {
      "type": "string",
      "description": "The contract address of the token",
      "example": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
    },
    "chain": {
      "type": "string",
      "description": "The blockchain the token is on",
      "example": "ethereum"
    },
    "name": {
      "type": "string",
      "description": "The display name of the token",
      "example": "USD Coin"
    },
    "symbol": {
      "type": "string",
      "description": "The ticker symbol of the token",
      "example": "USDC"
    },
    "image_url": {
      "type": "string",
      "description": "URL of the token's image"
    },
    "usd_price": {
      "type": "string",
      "description": "Current price in USD",
      "example": 1
    },
    "decimals": {
      "type": "integer",
      "format": "int32",
      "description": "Number of decimal places",
      "example": 6
    },
    "opensea_url": {
      "type": "string",
      "description": "URL to the token page on OpenSea"
    },
    "market_cap_usd": {
      "type": "number",
      "format": "double",
      "description": "Market capitalization in USD"
    },
    "volume_24h": {
      "type": "number",
      "format": "double",
      "description": "24-hour trading volume in USD"
    },
    "price_change_24h": {
      "type": "number",
      "format": "double",
      "description": "Price change percentage over the last 24 hours"
    }
  },
  "required": [
    "address",
    "chain",
    "decimals",
    "name",
    "opensea_url",
    "symbol",
    "usd_price"
  ]
}