# getRecommendedTokens

## Description

The `getRecommendedTokens` function retrieves an array of recommended tokens for a specified blockchain by making an HTTP GET request to a server. 

If the server returns a successful response, the function returns the `recommendedTokens` array from the response data. 

In case of an unsuccessful response, the function returns an object with a `code` property set to 0 and a `msg` property set to the error message from the response data.

## Parameters

| Name         | Type   | Description                                                         |
| ------------ | ------ | ------------------------------------------------------------------- |
| `blockchain` | string | The name of the blockchain for which to retrieve recommended tokens |

## Response

| Name                | Type  | Description                                                 |
| ------------------- | ----- | ----------------------------------------------------------- |
| `recommendedTokens` | array | An array of recommended tokens for the specified blockchain |

## Example Request and Response

### Prerequisites

Before making requests with Volary SDK, you must have it installed.

You can install Volary SDK using either **`npm`** or **`yarn`**. Use the following commands to install Volary SDK:

```jsx
npm install @nest25/xy-finance-lib
OR
yarn add @nest25/xy-finance-lib
```

### Request

Here is an example of how to make a `getRecommendedTokens` request using the Volary SDK:

```javascript
// import Nest SDK library
const { xySwap } = require('@nest25/xy-finance-lib');

// create xySwap instance
const swap = new xySwap();

async function main() {
  // get recommended tokens
  const result = await swap.getRecommendedTokens('klaytn');
  console.log(result);
}
// run main function
main();

```

### Response

```jsx
 [
      {
        address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
        symbol: 'KLAY',
        name: 'KLAY',
        chainId: '8217',
        decimals: 18,
        logoURI: 'https://assets.coingecko.com/coins/images/9672/small/klaytn.jpeg?1642775250'
      },
      {
        address: '0xCF87f94fD8F6B6f0b479771F10dF672f99eADa63',
        symbol: 'CLA',
        name: 'CLA',
        chainId: '8217',
        decimals: 18,
        logoURI: 'https://assets.coingecko.com/coins/images/24677/small/9pbkueWn_400x400.jpg?1648558565'
      },
      {
        address: '0x5c74070FDeA071359b86082bd9f9b3dEaafbe32b',
        symbol: 'KDAI',
        name: 'KDAI',
        chainId: '8217',
        decimals: 18,
        logoURI: 'https://assets.coingecko.com/coins/images/9956/small/4943.png?1636636734'
      }
    ]
```

## Use Cases

* **Token trading:** The `getRecommendedTokens` function can be used by decentralized exchanges to retrieve a list of recommended tokens for a specific blockchain network. This enables users to easily trade a variety of tokens on the decentralized exchange.
* **Token staking:** Some blockchain networks allow users to stake their tokens to earn rewards. The `getRecommendedTokens` function can be used to retrieve a list of recommended tokens for staking on a specific blockchain network.
* **Wallet integration:** Wallet applications can use the `getRecommendedTokens` function to suggest new tokens to their users for addition to their wallet. This enhances the user experience by providing easy access to popular tokens.


---

# 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://docs.volary.io/sdks-guide/blockchain-sdks/xy-finance-sdk/getrecommendedtokens.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.