> For the complete documentation index, see [llms.txt](https://cryptoquote.gitbook.io/cryptoquote/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cryptoquote.gitbook.io/cryptoquote/apis/analytics-apis/markets/range-up-down.md).

# Range Up / Down

<mark style="color:orange;">**Description**</mark>

Range Up / Down API ranks securities by the highest range up or down. This shows the difference between the highest and lowest prices of an asset over a given period of time. The range can be a useful tool for identifying potential support and resistance levels, as well as for setting entry and exit points for trades. You may also use the range to help determine the overall volatility of an asset.&#x20;

Range Up is a situation where the difference between the highest and lowest prices of a security over a given period of time becomes larger vice versa for Range Down. If the range of an asset over the past week was $10 and the range over the past month was $50, the range has increased over the past month. An increase in the range can be a sign of increased volatility in the market or in the asset being traded. It can also indicate that there is a greater degree of uncertainty or indecision among market participants. You can use an increase in the range as a signal to adjust strategies.

* Exchanges

* Range Direction&#x20;

  * Up
  * Down

* Limit Records&#x20;

{% embed url="<https://www.youtube.com/watch?index=54&list=PLog30vtb4ZA76-tBWML69sR_RuKNn1kaB&v=Q2j2KIKiELM>" %}

<mark style="color:orange;">**End Point**</mark>&#x20;

<figure><img src="/files/2TGedtQMmagDl55IZG5p" alt=""><figcaption></figcaption></figure>

<mark style="color:orange;">**Example**</mark>

Show Top 10 securities with Range UP direction on Gemini cryptocurrency exchange

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

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

<mark style="color:orange;">**Use Cases**</mark>

**Active Trader:**&#x20;

* Identify securities with the highest Range UP or DOWN.&#x20;

**Exchange or Brokerage**&#x20;

* Personalize your client engagement by issuing an alert when a security in a client’s watchlist or portfolio is included in the returned results&#x20;

## [Click here for a Free API key](https://www.cryptoquote.io/register) then [**Test the API yourself!**](https://www.cryptoquote.io/api_doc?code=range_up_down\&page=api_analytics)&#x20;


---

# 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, and the optional `goal` query parameter:

```
GET https://cryptoquote.gitbook.io/cryptoquote/apis/analytics-apis/markets/range-up-down.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.