Token Endpoints

Get token groups

Changed on Nov 3, 2026

Get a paginated list of token groups sorted by market cap descending. Token groups represent equivalent currencies across different blockchains (e.g., ETH on Ethereum, Base, and Arbitrum are all in the "eth" token group).

get/api/v2/token-groups

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

Query parameters

limitinteger

Number of results to return (default: 50, max: 100)

cursorstring

Pagination cursor for next page

Response

Successful response

nextstring nullable

Cursor for the next page of results

Example response

{
  "token_groups": [
    {
      "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 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 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