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