📖
Xerberus
xerberus.io
  • APIs
    • Getting Started
    • Risk Ratings API
      • Index Ratings
      • Cardano
      • Ethereum
      • Polygon
      • API Response Signature Headers
  • AI Agent API
    • Introduction
    • Tokens
      • Query: tokens
      • Query: tokensBySimilarSymbol
      • Query: tokensBySimilarAddress
    • Metrics
      • Query: metrics
    • Chains
  • SIREN API
Powered by GitBook
On this page
  1. AI Agent API
  2. Tokens

Query: tokens

Retrieves a paginated, sortable, and filterable list of tokens tracked by Xerberus. Each token represents a cryptocurrency with metadata including its symbol, chain, and address.


Example Query

query Tokens($chain: [String], $limit: Int, $offset: Int, $sortBy: String, $sortOrder: String) {
  tokens(chain: $chain, limit: $limit, offset: $offset, sortBy: $sortBy, sortOrder: $sortOrder) {
    tokens {
      asset_id
      symbol
      chain
      address
      last_updated
    }
    total_count
  }
}

Arguments

Argument
Type
Description

chain

[String]

(Optional) Filter tokens by one or more blockchain networks

limit

Int

(Default: 10) Maximum number of tokens to return

offset

Int

(Default: 0) Number of records to skip (for pagination)

sortBy

String

(Default: "symbol") Field to sort by (e.g., symbol, chain, etc.)

sortOrder

String

(Default: "ASC") Sorting order, either ASC (ascending) or DESC


Returns

Returns a TokenPagination object with the following fields:

TokenPagination

Field
Type
Description

tokens

[Token!]

List of tokens matching the filters and sorting

total_count

Int

Total number of matching tokens (before paging)


Token Object

Represents an on-chain token with essential metadata:

Field
Type
Description

asset_id

ID!

Unique internal identifier for the token

symbol

String!

Token symbol (e.g., USDC, ETH)

chain

String!

Blockchain network name (e.g., ETHEREUM, POLYGON)

address

String!

Smart contract address of the token

last_updated

String!

ISO 8601 timestamp of the last metadata update

PreviousTokensNextQuery: tokensBySimilarSymbol

Last updated 1 month ago