# Query: tokensBySimilarSymbol

Search for tokens by **partial or full symbol substring**. This performs a **case-insensitive** match on the token's `symbol` field and returns a paginated list of matches.

```graphql
query TokensBySimilarSymbol($symbol: String!, $limit: Int, $offset: Int, $sortBy: String, $sortOrder: String) {
  tokensBySimilarSymbol(symbol: $symbol, limit: $limit, offset: $offset, sortBy: $sortBy, sortOrder: $sortOrder) {
    tokens {
      asset_id
      symbol
      chain
      address
      last_updated
    }
    total_count
  }
}

```

#### Arguments

| Argument    | Type    | Description                                                            |
| ----------- | ------- | ---------------------------------------------------------------------- |
| `symbol`    | String! | Substring to match against token symbols (case-insensitive)            |
| `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:

**`TokenPagination`**

| Field         | Type      | Description                             |
| ------------- | --------- | --------------------------------------- |
| `tokens`      | \[Token!] | List of tokens matching the search      |
| `total_count` | Int       | Total number of matches (before paging) |

***

#### `Token` Object

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xerberus.gitbook.io/documentation/ai-agent-api/tokens/query-tokensbysimilarsymbol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.