GlueX token API exposes a single, public GraphQL endpoint that lets you retrieve token metadata across all supported chains with:
  • Fuzzy search on symbol, name and address
  • Category filters (eg: stablecoins, LP tokens)
  • Offset based pagination suitable for stateless clients
Each token record includes it’s contract address, symbol, decimals, economic type, a priority score for sorting and brand assets
Spin up the schema, auto complete queries and inspect live response via the
interactive GraphQL Playground

Endpoint

Method: POST Endpoint: https://tokens.gluex.xyz/graphql Request body
{
  "query": "GraphQL document as a string",
  "variables": {
    /* optional */
  },
  "operationName": "OptionalOperationName"
}
Response
fieldpurpose
tokenAddressCanonical EIPF55 checksum address
symbolTicker (≤ 11 chars)
nameName of the token
decimalsERC20 decimal (6, 8, 18 …)
typeType of the token (tradable, lp, stake, lend, invest, stable)
priorityRelevance score - assigned based on liqudity depth and trade volume
branding.*Brand assets
Launch the fully typed schema explorer, run ad hoc queries and inspect live JSON in the interactive GraphQL Playground — no auth token required

Quick Start

curl -X POST https://tokens.gluex.xyz/graphql \
  -H "content-type: application/json" \
  -d '{
        "query": "query ($chain:String!,$limit:Int!){tokens(chain:$chain,limit:$limit){items{symbol name}}}",
        "variables": { "chain": "ethereum", "limit": 5 }
      }'

Core Queries

All Tokens

query Tokens($chain: String!, $limit: Int = 20, $offset: Int = 0) {
  tokens(chain: $chain, limit: $limit, offset: $offset) {
    items {
      tokenAddress
      symbol
      name
      decimals
      type
      priority
      branding {
        logoUri
      }
    }
    total
    hasMore
  }
}
VariableRequiredDefaultDescriptionPossible Values / Type
chainIdentifier for the chain (eg: “ethereum”, “hyperevm”, “polygon”, …)string
limit20Maximum number of results to return per page (recommended max: 50)integer
offset0Number of items to skip for paginationinteger

Tokens by Type

query TokensByType(
  $chain: String!
  $tokenType: String! # tradable | lp | stake | lend | invest | stable
  $limit: Int = 20
  $offset: Int = 0
) {
  tokensByType(
    chain: $chain
    tokenType: $tokenType
    limit: $limit
    offset: $offset
  ) {
    items {
      tokenAddress
      symbol
      name
    }
    total
    hasMore
  }
}
VariableRequiredDefaultDescriptionPossible Values / Type
chainIdentifier for the chain (eg: “ethereum”, “hyperevm”, “polygon”, …)string
tokenTypeEnum that describes type of tokentradable | lp | stake | lend | invest | stable
limit20Maximum number of results to return per page (recommended max: 50)integer
offset0Number of items to skip for paginationinteger

Search Tokens

query SearchTokens(
  $chain: String!
  $pattern: String! # case insensitive substring
  $limit: Int = 20
  $offset: Int = 0
) {
  searchTokens(
    chain: $chain
    pattern: $pattern
    limit: $limit
    offset: $offset
  ) {
    items {
      tokenAddress
      symbol
      name
    }
    total
    hasMore
  }
}
VariableRequiredDefaultDescriptionType / Possible Values
chainIdentifier for the chain (eg: “ethereum”, “hyperevm”, “polygon”, …)string
patternCase insensitive substring to match against token address, name or symbolstring
limit20Maximum number of results to return per page (recommended max: 50)integer
offset0Number of items to skip for paginationinteger