## Parameters

| Parameter      | Description                                                                                                                                                                          | Required |
|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| **baseApiUrl** | Base api url for the relay api, defaults to [https://api.relay.link](https://api.relay.link/) but can also be configured to [https://api.testnets.relay.link](https://api.testnets.relay.link/) | ❌       |
| **options**    | Query parameters that map directly to the [currencies api](https://docs.relay.link/references/api/get-currencies-v2)                                                                 | ❌       |
| **queryOptions** | Tanstack query options. Refer to the [Tanstack](https://tanstack.com/query/latest/docs/framework/react/guides/query-options) docs.                                                 | ❌       |

## Return Data

The hook returns an object with the base [Tanstack Query response](https://tanstack.com/query/v5/docs/framework/react/reference/useQuery). The data property maps to the object returned in the aforementioned [currencies api](https://docs.relay.link/references/api/get-currencies-v2).

## Usage

```
import { useTokenList } from '@relayprotocol/relay-kit-hooks'

const { data: suggestedTokens } = useTokenList(
  "https://api.relay.link",
  {
    limit: 20,
    term: "usdc"
  }
)
```

## Query Function

```
import { queryTokenList } from '@relayprotocol/relay-kit-hooks'

queryTokenList(
  "https://api.relay.link",
  {
    limit: 20,
    term: "usdc"
  }
)
```