> For the complete documentation index, see [llms.txt](https://sol-bangers-only.gitbook.io/sol-bangers-only/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sol-bangers-only.gitbook.io/sol-bangers-only/how-to-get-started/main-menu/query-management/add-query.md).

# Add Query

The Add Query workflow allows you create a new query from the default values. &#x20;

You may configure as many or as few filters to create a Query.  Select the various metrics you would like applied to your token feed and when you’re ready to save the Query, press “Confirm Query”.  You will be presented with a summary of the settings you created.  Please verify these are correct and if they are, click “Commit”.

After clicking “Commit” you’ll be asked to name your Query.  This name will be included in the token reports your private feed, so choosing a name that reflects what type of tokens the Query is intended to capture will help you remember when they populate your feed.

A few reminders:

* The metrics you want applied must by "On" or Green for them to be applied.  If you enter a value, the metric light must be turned to Green (by clicking the metric name) for it to be included in the Query.
* The more metrics you include in your Query, the more specific the token must be to meet all of the criteria (this may or may not be your intention).
* Tokens must meet ALL of the filter criteria you set in a Query.  Think of these like AND criteria.

<figure><img src="/files/EnlP9B4FTGUNV63C2F6W" alt=""><figcaption><p>The Metric Filter Grid.  Click Confirm Query to advance.</p></figcaption></figure>

Once you're set with your Query, click Confirm Query.  This will bring up the confirmation message that allows you to confirm what you entered.  Metrics that were "red" are "OFF" even if a value was entered for them.  If you'd forgot to turn them "ON", select Modify Further to be taken back to the Filter Grid. &#x20;

For any further modifications to your Query, select "Modify Further" to be taken back to the Filter Grid.  Your settings will be populated and can continue to make further changes.  Once satisfied, click Confirm Query again to be taken to this menu for confirmation.

<figure><img src="/files/H7ym09LvbGIlXUOCi1JC" alt=""><figcaption></figcaption></figure>

When you're ready to save your Query, click "Commit" and you'll be prompted to name your Query.

<figure><img src="/files/MA9mbMMo8Z5NEjtORFI1" alt=""><figcaption><p>Name Query Message</p></figcaption></figure>

Naming your Query must meet a few conditions.  We do not allow special characters and names must be 20 characters or less.  Simply enter your desired Query name.  If you have reached your Query limit, may [modify an existing Query](/sol-bangers-only/how-to-get-started/main-menu/query-management/view-modify-query.md) or you may [delete a query](/sol-bangers-only/how-to-get-started/main-menu/query-management/delete-query.md) to make room for a new one.

When the Query has been successfully saved, you will receive this message.  The Query has been saved in an Active state by default and you can view it from the [Query Management Menu](/sol-bangers-only/how-to-get-started/main-menu/query-management.md).

<figure><img src="/files/oDovIHUK72WWDgKBgyOH" alt=""><figcaption><p>Successfully Saved Your Query</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://sol-bangers-only.gitbook.io/sol-bangers-only/how-to-get-started/main-menu/query-management/add-query.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.
