# Crypto.com Exchange

The AI Agent SDK offers comprehensive Exchange-related features by retrieving information about all available trading pairs and their current market data from the Crypto.com Exchange. It also supports fetching real-time market data for a specified trading instrument, providing developers with valuable insights for building trading and analytics applications.

To learn more about the underlying Developer Platform functionalities, please visit [Developer Platform Client SDK Exchange Module](https://ai-agent-sdk-docs.crypto.com/crypto.com-developer-platform/on-chain-developer-platform-client-sdk/exchange-module).

#### 7.1 Get all tickers

Retrieve information about all available trading pairs and their current market data from the Crypto.com Exchange.

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

* Example Query

  ```
  "Get all tickers"
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  str: A formatted string containing information about all available tickers.
  ```
* Example Response

  <pre><code>Here are some of the current tickers available:

  <strong>1. &#x3C;example-pair>
  </strong>   - Last Price: &#x3C;example-price>
     - High: &#x3C;example-high-price>
     - Low: &#x3C;example-low-price>
     - Volume: &#x3C;example-volume>
  2. &#x3C;example-pair>
  ...

  This is just a selection of available tickers. If you would like more details or specific information regarding other tickers, please let me know!
  </code></pre>

{% endtab %}
{% endtabs %}

Example Code

```python
from crypto_com_agent_client import Agent

agent = Agent.init(
    llm_config={
        "provider": "OpenAI",
        "model": "gpt-4",
        "provider-api-key": "sk-proj-example-key",
        "temperature": "float-controlling-output-randomness",
        "transfer-limit": -1,  # -1 means no limit (unlimited), 0 disables transfers completely, any positive number (e.g. 5) allows exactly that transfer amount
    },
    blockchain_config={
        "api-key": "your-crypto.com-developer-platform-api-key",
        "private-key": "your-private-key",
        "sso-wallet-url": "your-sso-wallet-url",
        "timeout": "timeout-in-seconds-for-API-calls-default-20s")
    },
)
response = agent.interact("Get all tickers")
print(response)
```

#### 7.2 Get ticker by instrument&#x20;

Retrieve current market data for a specified trading instrument from the Crypto.com Exchange.

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

* Arguments

  ```python
  instrument_name (str): The name of the trading instrument (e.g., "BTC_USDT").
  ```
* Example Query

  ```
  "What's the ticker information of <example-instrument>"
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  str: A formatted string containing the ticker information for the specified instrument.
  ```
* Errors

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

  ```
  Here is the ticker information for the <example-instrument> trading pair:

  - Instrument Name: <example-instrument>
  - High Price: <example-high-price>
  - Low Price: <example-low-price>
  - Last Price: <example-last-price>
  - 24h Volume: <example-volume>
  - 24h Volume Value: <example-volume-value>
  - Price Change: <example-price-change> (approximately <example-percentage>)
  - Best Bid: <example-best-bid-price>
  - Best Ask: <example-best-ask-price>
  - Open Interest: <example-open-interest>
  - Timestamp: <example-timestamp>

  If you need further information, feel free to ask!
  ```

{% endtab %}
{% endtabs %}

Example Code

```python
from crypto_com_agent_client import Agent

agent = Agent.init(
    llm_config={
        "provider": "OpenAI",
        "model": "gpt-4",
        "provider-api-key": "sk-proj-example-key",
        "temperature": "float-controlling-output-randomness",
        "transfer-limit": -1,  # -1 means no limit (unlimited), 0 disables transfers completely, any positive number (e.g. 5) allows exactly that transfer amount
    },
    blockchain_config={
        "api-key": "your-crypto.com-developer-platform-api-key",
        "private-key": "your-private-key",
        "sso-wallet-url": "your-sso-wallet-url",
        "timeout": "timeout-in-seconds-for-API-calls-default-20s")
    },
)

response = agent.interact("What's the ticker information of <example-instrument>")
print(response)
```