Token Endpoints

Get token details

Changed on Nov 3, 2026

Get detailed information about a specific token by chain and contract address.

get/api/v2/chain/{chain}/token/{address}

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/chain/:chain/token/:address/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

The blockchain on which to filter the results

addressstring required

The contract address of the token

Response

addressstring required

The contract address of the token

chainstring required

The blockchain the token is on

created_atnumber double nullable

When OpenSea first recorded the token

decimalsinteger required

Number of decimal places

descriptionstring nullable

A description of the token

description_generated_atnumber double nullable

When an AI-generated description was generated

description_providerstring nullable

Provider of the token metadata description. Known values: COINGECKO, GECKOTERMINAL, DEXSCREENER. Null for AI-generated descriptions or when the provider is unknown. This is an open enum: new values may be added; clients must tolerate unrecognized values.

description_source'TOKEN_METADATA' | 'AI_GENERATED' | 'null' nullable

Source of the description. TOKEN_METADATA is supplied by token metadata; AI_GENERATED is OpenSea's generated token-page description.

description_sourcesstring[] nullable

Sources used for an AI-generated description

genesis_datenumber double nullable

Earliest known onchain activity for the token

holders_countinteger nullable

Number of token holders

image_urlstring nullable

URL of the token's image

is_verifiedboolean required

Whether OpenSea has verified the token

namestring required

The display name of the token

opensea_urlstring required

URL to the token page on OpenSea

status'OK' | 'WARNING' | 'SPAM' | 'LOW_LIQUIDITY'

Token safety status based on OpenSea's spam-classification rules. OK for tokens that pass all safety checks (the normal case). Categories are intentionally broad and may evolve. Possible values, in decreasing severity: WARNING (flagged as risky/suspicious — caution advised), SPAM (flagged as spam), LOW_LIQUIDITY (insufficient liquidity pool reserves), OK (passes all checks).

symbolstring required

The ticker symbol of the token

usd_pricestring required

Current price in USD

Example response

{
  "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "chain": "ethereum",
  "decimals": 6,
  "name": "USDC",
  "symbol": "USDC",
  "usd_price": "1.0"
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  removed the enum value b3 from the path request parameter chain
- breaking
  removed the enum value blast from the path request parameter chain
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  added the new undefined enum value to the response property for the response status
- info
  added the new enum value stablechain to the path request parameter chain
- info
  added the media type */* for the response with the status
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added subschema #2 to the response property anyOf list for the response status
- info
  added subschema #2 to the response property anyOf list for the response status

Operation history