Token Endpoints

Get top tokens

Changed on Nov 3, 2026

Get top tokens ranked by 24-hour trading volume. Returns established tokens with high market activity. Pass sort_by and sort_direction to order the same set of tokens differently.

get/api/v2/tokens/top

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

Query parameters

limitinteger

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

chainsChainIdentifier[]

Filter by blockchain(s)

[
  "ethereum"
]

Sort field for the token ranking endpoints

Sort field (default: one_day_volume)

sort_direction'asc' | 'desc'

Sort direction (default: desc)

cursorstring

Pagination cursor for next page. A cursor is only valid for the query that produced it: keep sort_by, sort_direction and chains identical across pages, and start a new page-one request when any of them changes.

Response

nextstring nullable

Cursor for the next page of results

Example response

{
  "tokens": [
    {
      "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 property items/ of the query request parameter chains
- breaking
  removed the enum value blast from the property items/ of the query request parameter chains
- 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
- info
  added the new optional query request parameter sort_by
- info
  added the new optional query request parameter sort_direction
- info
  added the enum value stablechain to the property items/ of the query request parameter chains
- 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

Operation history