AssetDeployment

String!

The deployment ID.

Int!

The network ID the asset is deployed on.

String!

The contract address of the deployment.

String

The token standard (e.g. ERC20, SPL).

String!

The Grid asset ID.

String!

The Grid root ID for the parent organization.

EnhancedToken

The enhanced token this deployment represents. See EnhancedToken

Show Properties

String!

The ID of the token (address:networkId).

String!

The contract address of the token.

Int

The token ID on CoinMarketCap.

Int!

The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).

Boolean

Whether the token has been flagged as a scam.

String

The token name. For example, ApeCoin.

Int!

The network ID the token is deployed on.

String

The token symbol. For example, APE.

Community gathered links for the socials of this token. See SocialLinks

Show Properties

String

TokenInfo

More metadata about the token. See TokenInfo

Show Properties

String!

Uniquely identifies the token.

String!

The contract address of the token.

String

The circulating supply of the token.

Int

The token ID on CoinMarketCap.

String

The Grid asset ID, if this token is linked to a Grid asset.

String

The Grid bluechip rating for this token (e.g. A+, B-).

Boolean

Whether the token has been flagged as a scam.

String

The token name. For example, ApeCoin.

Int!

The network ID the token is deployed on.

String!

The token symbol. For example, APE.

String

The total supply of the token.

String

The thumbhash of the token logo.

String

The thumbnail token logo URL.

String

The small token logo URL.

String

The large token logo URL.

String

The token banner URL.

String

The original URL/URI for the video associated with the token.

String

A description of the token.

String

The Grid asset ID, if this token is linked to a Grid asset.

String

The Grid bluechip rating for this token (e.g. A+, B-).

Organization

The Grid organization associated with this token. See Organization

Show Properties

String!

The organization name.

String

The founding date of the organization.

String

A short description of the organization.

String

A detailed description of the organization.

String

The organization’s tagline.

String

The type of organization (e.g. protocol, company).

String

The sector the organization operates in.

[OrganizationUrl!]!

URLs associated with the organization. See OrganizationUrl

[OrganizationSocial!]!

Social links for the organization. See OrganizationSocial

String

The organization’s logo URL.

String

The organization’s icon URL.

String

String!

The Grid root ID for the organization.

[Asset!]!

Assets managed by this organization. See Asset

Asset

The Grid asset associated with this token. See Asset

Show Properties

String!

The Grid asset ID.

String

The asset name.

String

A description of the asset.

String

The asset ticker symbol.

String

The asset type (e.g. token, stablecoin).

String

The asset status.

String

The asset icon URL.

String!

The Grid root ID for the parent organization.

[AssetDeployment!]!

Deployments of this asset across chains. See AssetDeployment

[Exchange!]

A list of exchanges where the token has been traded. See Exchange

Show Properties

String!

The ID of the exchange (address:id).

String!

The contract address of the exchange.

String

The hex string for the exchange color.

String

The name of the exchange.

String

The version of the exchange, if applicable.

String

The exchange logo URL.

Int!

The network ID the exchange is deployed on.

String

The URL for the exchange.

String

The token creator’s wallet address.

Wallet

The token creator’s wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator. See Wallet

Show Properties

String!

WalletCategory

See WalletCategory

Int

WalletFunding

See WalletFunding

[String!]

Identity labels describing what this wallet is (e.g. CEX, DEX, bridge, team)

String

Resolved profile avatar URL (best available source)

String

A human-readable display name for the wallet

String

Twitter/X numeric ID

String

Twitter/X username

String

Telegram numeric ID

String

Telegram username

String

Website URL

String

Discord numeric ID

String

Discord username

String

GitHub numeric ID

String

GitHub username

String

Farcaster numeric ID

String

Farcaster username

String

A community-contributed description of the wallet

Int

Ethos credibility score (0-2800, higher = more trustworthy)

String

Ethos credibility tier (1-10)

Boolean

Ethos Network verification status

[String!]

Registry entity ids of the apps this wallet trades through — e.g. defined for defined.fi, or axiom. Means “trades through”, never “is owned by”: one routed trade is enough to appear here.

String

Source of identity data (e.g. ethos, manual, polymarket-backfill)

Int

When identity data was last updated (unix timestamp)

WalletPolymarketProfile

Raw Polymarket profile data when this wallet is a Polymarket proxy. Polymarket takes priority over contributed/ethos for resolved displayName, twitterUsername, and avatarUrl. See WalletPolymarketProfile

Int

Total number of tokens created by this wallet across all networks (where the creator is known).

Int

Total number of launchpad tokens migrated (graduated) by this wallet across all networks.

Int

The block height the token was created at.

String

The transaction hash of the token’s creation.

Int

The unix timestamp for the creation of the token.

String

Returns mint authority address if token is mintable. If null, verify against isMintableValid.

String

Returns freeze authority address if token is freezable. If null, verify against isFreezableValid.

Boolean

Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined.

Boolean

Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined.

LaunchpadData

The launchpad data for the token, if applicable. See LaunchpadData

Show Properties

String

The name of the launchpad.

Float

The percentage of the pool that was sold to the public.

String

The address of the pool.

Int

The unix timestamp when the launchpad was completed.

Boolean

Indicates if the launchpad is completed.

Int

The slot number when the launchpad was completed.

Int

The slot number when the launchpad was migrated.

Int

The unix timestamp when the launchpad was migrated.

Boolean

Indicates if the launchpad was migrated.

String

The pool address after the launchpad was migrated.

String

The launchpad protocol.

String

The icon URL of the launchpad.

Boolean

Whether cashback is enabled for this launchpad token (Pump V1/V2 only).

String

The token category assigned by the launchpad. Populated by launchpads that publish a category taxonomy (e.g. Scale/Creator, Eitherway). Values include platform, meme, utility, etc.

String

deprecated

The name of the launchpad.

This field is deprecated. Use launchpadName instead

Float

The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).

Boolean

Whether the token name or symbol contains profanity.

TokenExtrema

All-time high and low price/market cap data for the token. See TokenExtrema

Show Properties

String!

The token ID (address:networkId).

String!

The contract address of the token.

Int!

The network ID the token is deployed on.

String!

The all-time high price in USD.

Int!

The unix timestamp when the all-time high price was reached.

String!

The all-time low price in USD.

Int!

The unix timestamp when the all-time low price was reached.

String!

The all-time high fully diluted market cap.

Int!

The unix timestamp when the all-time high FDV was reached.

String!

The all-time low fully diluted market cap.

Int!

The unix timestamp when the all-time low FDV was reached.

String!

The all-time high circulating market cap.

Int!

The unix timestamp when the all-time high circulating market cap was reached.

String!

The all-time low circulating market cap.

Int!

The unix timestamp when the all-time low circulating market cap was reached.

CoinCommunity

The Coin Community data for the token See CoinCommunity

Show Properties

String!

The id of the coin community

Int!

The unix timestamp for the creation of the coin community.

Int!

The number of posts in the coin community.

Int!

The number of members in the coin community.

Int!

The number of likes in the coin community.

Int

The unix timestamp for the most recent post in the coin community.

TokenExtensions

Token extension metadata, if available. See TokenExtensions

Show Properties

Token2022Extensions

Solana Token-2022 extension metadata. See Token2022Extensions

B20Extensions

Base B20 extension metadata. See B20Extensions

Erc7572CustomInfo

Token-standard-specific custom metadata — currently ERC-7572 contractURI fields, as used by Base B20 tokens. Null for tokens without a recognized token standard. See Erc7572CustomInfo

Show Properties

String!

Token-standard discriminant for this custom data (currently always erc7572).

String

Featured/showcase image URL from the contract metadata.

[String!]

Collaborator wallet addresses listed in the contract metadata.

[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.

String

deprecated

The total supply of the token.

This field is deprecated. Use the TokenInfo type

ExplorerTokenData

deprecated

Information about the token from 3rd party sources. See ExplorerTokenData

This field is deprecated. Use the TokenInfo type

Show Properties

String!

The ID of the token (address:networkId).

Boolean

Whether the token has been verified on CoinGecko.

String

A description of the token.

String

The precision to which the token can be divided.

String

The token price in USD.

String

The token type.

String

deprecated

The thumbnail token logo URL.

This field is deprecated. Use the TokenInfo type

String

deprecated

The small token logo URL.

This field is deprecated. Use the TokenInfo type

String

deprecated

The large token logo URL.

This field is deprecated. Use the TokenInfo type

String

deprecated

The circulating supply of the token.

This field is deprecated. Use the TokenInfo type

String

deprecated

The amount of this token in the pair.

This field is deprecated. Pooled can be found on the pair instead

Used By

Returned by

balances: Returns list of token balances that a wallet has.
categoryTokens: Returns the tokens assigned to a category (including its subcategories), with optional filterTokens-style filters and rankings applied.
filterPairs: Returns a list of pairs based on a variety of filters.
filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
filterTokenWallets: Returns a list of wallets with stats narrowed down to a specific token.
getBars: Returns bar chart data to track price changes over time.
getCommunityNotes: Returns community gathered notes.
getDetailedPairsStats: Returns bucketed stats for a given token within a list of pairs.
getDetailedPairStats: Returns bucketed stats for a given token within a pair.
getTokenBars: Returns aggregated bar chart data to track price changes over time.
holders: Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
listPairsForToken: Returns a list of pairs containing a given token.
listPairsWithMetadataForToken: Returns a list of pair metadata for a token.
onBalanceUpdated: Live-streamed balance updates for a given wallet.
onFilterTokensUpdated: Live-streamed filter token updates for the current filterTokens result set.
onHoldersUpdated: Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.
onLaunchpadTokenEvent: Live-streamed launchpad token event.
onLaunchpadTokenEventBatch: Live-streamed launchpad token events batched (more efficient).
onPairMetadataUpdated: Live-streamed stat updates for a given token within a pair.
pairMetadata: Returns metadata for a pair of tokens.
refreshBalances: Force refreshes the balance for a token in a wallet, persisting the result so subsequent balances queries reflect it. Supports contract tokens (<tokenAddress>:<networkId>, EVM only) and native token balances (native:<networkId>, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring.
token: Returns a single token by its address & network id.
tokens: Returns a list of tokens by their addresses & network id, with pagination.

API Documentation

Queries

Mutations

Subscriptions

Types

AssetDeployment

Used By

​Used By

Used By