OpenSea · Schema

TokenBaseResponse

Common token identity fields shared across token responses

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

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opensea.io/schemas/TokenBaseResponse",
  "title": "TokenBaseResponse",
  "type": "object",
  "description": "Common token identity fields shared across token responses",
  "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"
    }
  },
  "required": [
    "address",
    "chain",
    "decimals",
    "name",
    "opensea_url",
    "symbol",
    "usd_price"
  ]
}