Token Endpoints

Get a token group by slug

Changed on Nov 3, 2026

Get detailed information about a specific token group by its slug identifier.

get/api/v2/token-groups/{slug}

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/token-groups/:slug/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

slugstring required

The slug identifier of the token group

Response

Successful response

created_atstring required

ISO 8601 timestamp when the token group was created

descriptionstring nullable

Description of the token group

display_namestring required

Display name of the token group

image_urlstring nullable

URL of the token group's image

opensea_urlstring required

URL to the token group page on OpenSea

slugstring required

Unique slug identifier for the token group

symbolstring nullable

Ticker symbol of the token group

updated_atstring required

ISO 8601 timestamp when the token group was last updated

Example response

{
  "currencies": [
    {
      "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "chain": "ethereum",
      "decimals": 18,
      "name": "Wrapped Ether",
      "symbol": "WETH",
      "usd_price": "2345.67"
    }
  ],
  "display_name": "Ethereum",
  "primary_currency": {
    "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "chain": "ethereum",
    "decimals": 18,
    "name": "Wrapped Ether",
    "symbol": "WETH",
    "usd_price": "2345.67"
  },
  "slug": "eth",
  "symbol": "ETH"
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- 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
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required 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
- 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 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