> For the complete documentation index, see [llms.txt](https://ai-agent-sdk-docs.crypto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-agent-sdk-docs.crypto.com/crypto.com-developer-platform/on-chain-developer-platform-client-sdk/exchange-module.md).

# Exchange Module

Exchange module handles operations related to exchange data retrieval.

To learn more about how to use the AI Agent SDK to interact with the wallet module, please visit [AI Agent SDK Crypto.com Exchange](/crypto.com-ai-agent-sdk/core-concepts-overview/blockchain-functions/crypto.com-exchange.md).

#### 8.1 Get All Tickers

Retrieves all available tickers from the Crypto.com Exchange (Chain agnostic).

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_all_tickers
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```python
  from crypto_com_developer_platform_client import Exchange

  tickers = Exchange.get_all_tickers()
  print(tickers)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  A list of all available tickers and their information.
  ```
* Errors

  ```python
  ValueError: If the Exchange class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': [{'instrumentName': 'example-intrument-name', 'high': example-high, 'low': example-low, 'lastPrice': example-last-price, 'volume': example-volume, 'volumeValue': example-volume-value, 'priceChange': example-price-change, 'bestBid': example-best-bid, 'bestAsk': example-best-ask, 'openInterest': example-open-interest, 'timestamp': example-timestamp}, ...]}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getAllTickers
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```typescript
  import { Exchange } from '@crypto.com/developer-platform-client';

  try {
    const tickers = await Exchange.getAllTickers();
    console.log(tickers);
  }
    catch(err) {
    console.log(err);
  }
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<TickerResponse>>}: A promise that resolves to all available tickers.
  ```
* Errors

  ```typescript
  {Error}: Throws an error if the request fails.
  ```
* Example Return

  ```typescript
  {
    status: 'Success',
    data: [
      {
        instrumentName: example-name,
        high: example-high,
        low: example-low,
        lastPrice: example-last-price,
        volume: example-volume,
        volumeValue: example-volume-value,
        priceChange: example-price-change,
        bestBid: example-best-bit,
        bestAsk: example-best-ask,
        openInterest: example-open-interest,
        timestamp: example-timestamp
      }
      ...
    ]
  }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 8.2 Get Ticker By Instrument

Retrieves ticker information for a specific trading instrument from the Crypto.com Exchange (Chain agnostic).

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_ticker_by_instrument
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```python
  instrument_name (str): The name of the instrument to get ticker information for.
  ```
* Example Code

  ```python
  from crypto_com_developer_platform_client import Exchange

  ticker = Exchange.get_ticker_by_instrument('example-instrument')
  print(ticker)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  Ticker information for the specified instrument.
  ```
* Errors

  ```python
  ValueError: If instrument_name is None or empty.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'instrumentName': 'example-intrument-name', 'high': example-high, 'low': example-low, 'lastPrice': example-last-price, 'volume': example-volume, 'volumeValue': example-volume-value, 'priceChange': example-price-change, 'bestBid': example-best-bid, 'bestAsk': example-best-ask, 'openInterest': example-open-interest, 'timestamp': example-timestamp}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getTickerByInstrument
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```typescript
  {string} instrumentName: The name of the trading instrument (e.g., 'BTC_USDT')
  ```
* Example Code

  ```typescript
  import { Exchange } from '@crypto.com/developer-platform-client';

  try {
    const btcTicker = await Exchange.getTickerByInstrument('BTC_USDT');
    console.log(btcTicker);
  }
    catch(err) {
    console.log(err);
  }
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<TickerData>>}: A promise that resolves to the ticker information.
  ```
* Errors

  ```typescript
  {Error}: Throws an error if the request fails.
  ```
* Example Return

  ```typescript
  {
    status: 'Success',
    data: {
      instrumentName: example-name,
      high: example-high,
      low: example-low,
      lastPrice: example-last-price,
      volume: example-volume,
      volumeValue: example-volume-value,
      priceChange: example-price-change,
      bestBid: example-best-bid,
      bestAsk: example-best-ask,
      openInterest: example-open-interest,
      timestamp: example-timestamp
    }
  }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}