categories

Returns the list of token categories: curated groupings such as DeFi, L1s, stablecoins, AI, and memes. Use the status argument to scope the list; only ACTIVE categories are returned by default. Use this query to populate category pickers and navigation, then fetch a single category with category or list its tokens with categoryTokens. To filter or exclude categories directly on token discovery queries, use the categories filter (TokenCategoryFilter) on filterTokens.

Returns

[Category!]!

See Category

Show Properties

String!

The category id — a stable slug (also the value stored on tokens).

String!

The display name. For example, Artificial Intelligence.

String

An optional short name/abbreviation for compact surfaces (pills, badges). For example, AI. Null when unset — the API does not fall back to name; clients decide whether to.

String!

The URL slug (same value as id).

String

A short description of the category.

CategoryType!

Whether the category is canonical or narrative. See CategoryType

CategoryStatus!

The lifecycle status of the category. See CategoryStatus

String

The parent category id, for hierarchical categories.

Int

The number of tokens currently assigned to the category. Null when the count has not been computed yet.

String

deprecated

The category icon URL.

This field is deprecated. Categories no longer carry imagery. Will be null.

String

deprecated

The category banner image URL.

This field is deprecated. Categories no longer carry imagery. Will be null.

Arguments

CategoryType

Filter by category kind. See CategoryType

Show Properties

enum

Objective, long-lived groupings (DeFi, L1, stablecoins).

enum

Trend-driven groupings (AI, RWA, memes).

CategoryStatus

Filter by lifecycle status. Defaults to ACTIVE. See CategoryStatus

Show Properties

enum

Example

Test this query in the Explorer →

{
  categories(status: ACTIVE) {
    id
    name
    shortName
    description
    status
    parentId
  }
}

Usage Guidelines

This is a lightweight call. Fetch once and cache client-side; category membership changes slowly.
shortName is optional and does not fall back to name. Use it for compact surfaces (pills, badges) and fall back to name yourself when it is null.

API Documentation

Queries

Mutations

Subscriptions

Types

Returns

Arguments

Example

Usage Guidelines

​Returns

​Arguments

​Example

​Usage Guidelines

Returns

Arguments

Example

Usage Guidelines