> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Management

> Request all available tokens and their balances, manage token approvals and more.

## Get available tokens

### `getTokens`

Retrieves a list of all available tokens on specified chains.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `params` (`TokensRequest`, optional): Configuration for the requested tokens.
  * `chains` (`(ChainId | ChainKey)[]`, optional): List of chain IDs or keys. If not specified, returns tokens on all available chains.
  * `chainTypes` (`ChainType[]`, optional): List of chain types.
  * `extended` (`boolean`, optional): When `true`, returns `TokensExtendedResponse` with additional token data. Default: `false`.
  * `minPriceUSD` (`number`, optional): Minimum USD price filter for returned tokens.
  * `orderBy` (`TokensSortOrder`, optional): Sort order for the token list.
  * `limit` (`number`, optional): Maximum number of tokens to return.
  * `search` (`string`, optional): Search query to filter tokens by name or symbol.
  * `tags` (`TokenTag[]`, optional): Filter tokens by tags.
* `options` (`RequestOptions`, optional): Additional request options.

**Returns**

A Promise that resolves to `TokensResponse`, or `TokensExtendedResponse` when `extended: true` is set.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { ChainType, getTokens } from '@lifi/sdk';

const client = createClient({
  integrator: 'Your dApp/company name',
});

try {
  const tokens = await getTokens(client, {
    chainTypes: [ChainType.EVM, ChainType.SVM],
  });
  console.log(tokens);
} catch (error) {
  console.error(error);
}
```

### `getToken`

Fetches details about a specific token on a specified chain.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `chain` (`ChainKey | ChainId`): ID or key of the chain that contains the token.
* `token` (`string`): Address or symbol of the token on the requested chain.
* `options` (`RequestOptions`, optional): Additional request options.

**Returns**

A Promise that resolves to a `TokenExtended` object.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { getToken } from '@lifi/sdk';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const chainId = 1;
const tokenAddress = '0x0000000000000000000000000000000000000000';

try {
  const token = await getToken(client, chainId, tokenAddress);
  console.log(token);
} catch (error) {
  console.error(error);
}
```

## Get token balance

Please ensure that you configure the SDK with EVM/Solana providers first. They are required to use this functionality. Additionally, it is recommended to provide your private RPC URLs, as public ones are used by default and may rate limit you for multiple requests, such as getting the balance of multiple tokens at once.

Read more [Configure SDK Providers](/sdk/configure-sdk-providers).

### `getTokenBalance`

Returns the balance of a specific token a wallet holds.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `walletAddress` (`string`): A wallet address.
* `token` (`Token`): A Token object.

**Returns**

A Promise that resolves to a `TokenAmount` or `null`.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { getToken, getTokenBalance } from '@lifi/sdk';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const chainId = 1;
const tokenAddress = '0x0000000000000000000000000000000000000000';
const walletAddress = '0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0';

try {
  const token = await getToken(client, chainId, tokenAddress);
  const tokenBalance = await getTokenBalance(client, walletAddress, token);
  console.log(tokenBalance);
} catch (error) {
  console.error(error);
}
```

### `getTokenBalances`

Returns the balances for a list of tokens a wallet holds.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `walletAddress` (`string`): A wallet address.
* `tokens` (`Token[]`): A list of Token objects.

**Returns**

A Promise that resolves to a list of `TokenAmount` objects.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { ChainId, getTokenBalances, getTokens } from '@lifi/sdk';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const walletAddress = '0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0';

try {
  const tokensResponse = await getTokens(client);
  const optimismTokens = tokensResponse.tokens[ChainId.OPT];
  const tokenBalances = await getTokenBalances(client, walletAddress, optimismTokens);
  console.log(tokenBalances);
} catch (error) {
  console.error(error);
}
```

### `getTokenBalancesByChain`

Queries the balances of tokens for a specific list of chains for a given wallet.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `walletAddress` (`string`): A wallet address.
* `tokensByChain` (`[chainId: number]: Token[]`): A list of Token objects organized by chain IDs.

**Returns**

A Promise that resolves to an object containing the tokens and their amounts on different chains.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { getTokenBalancesByChain } from '@lifi/sdk';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const walletAddress = '0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0';
const tokensByChain = {
  1: [
    {
      chainId: 1,
      address: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
      symbol: 'DAI',
      name: 'DAI Stablecoin',
      decimals: 18,
      priceUSD: '0.9999',
    },
  ],
  10: [
    {
      chainId: 10,
      address: '0x4200000000000000000000000000000000000042',
      symbol: 'OP',
      name: 'Optimism',
      decimals: 18,
      priceUSD: '1.9644',
    },
  ],
};

try {
  const balances = await getTokenBalancesByChain(client, walletAddress, tokensByChain);
  console.log(balances);
} catch (error) {
  console.error(error);
}
```

### `getWalletBalances`

Returns the balances of tokens a wallet holds across EVM chains using the LI.FI API.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `walletAddress` (`string`): A wallet address.
* `options` (`RequestOptions`, optional): Additional request options.

**Returns**

A Promise that resolves to `Record<number, WalletTokenExtended[]>` — token balances organized by chain ID.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { getWalletBalances } from '@lifi/sdk';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const walletAddress = '0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0';

try {
  const balances = await getWalletBalances(client, walletAddress);
  console.log(balances);
} catch (error) {
  console.error(error);
}
```

## Managing token allowance

Token allowance and approval functionalities are specific to EVM (Ethereum Virtual Machine) chains. It allows smart contracts to interact with ERC-20 tokens by approving a certain amount of tokens that a contract can spend from the user's wallet.

Please ensure that you configure the SDK with the EVM provider. It is required to use this functionality.

Read more [Configure SDK Providers](/sdk/configure-sdk-providers).

<Note>
  Token allowance functions are exported from `@lifi/sdk-provider-ethereum` package. Make sure to install and import from the correct package.
</Note>

### `getTokenAllowance`

Fetches the current allowance for a specific token.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `token` (`BaseToken`): The token for which to check the allowance.
* `ownerAddress` (`string`): The owner of the token.
* `spenderAddress` (`string`): The spender address that was approved.

**Returns**

A Promise that resolves to a `bigint` representing the allowance or undefined if the token is a native token.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { getTokenAllowance } from '@lifi/sdk-provider-ethereum';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const token = {
  address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  chainId: 1,
};

const ownerAddress = '0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0';
const spenderAddress = '0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE';

try {
  const allowance = await getTokenAllowance(client, token, ownerAddress, spenderAddress);
  console.log('Allowance:', allowance);
} catch (error) {
  console.error('Error:', error);
}
```

### `getTokenAllowanceMulticall`

Fetches the current allowance for a list of token/spender address pairs.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `ownerAddress` (`string`): The owner of the tokens.
* `tokens` (`TokenSpender[]`): A list of token and spender address pairs.

**Returns**

A Promise that resolves to an array of `TokenAllowance` objects.

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { getTokenAllowanceMulticall } from '@lifi/sdk-provider-ethereum';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const ownerAddress = '0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0';
const tokens = [
  {
    token: {
      address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
      chainId: 1,
    },
    spenderAddress: '0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE',
  },
  {
    token: {
      address: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
      chainId: 1,
    },
    spenderAddress: '0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE',
  },
];

try {
  const allowances = await getTokenAllowanceMulticall(client, ownerAddress, tokens);
  console.log('Allowances:', allowances);
} catch (error) {
  console.error('Error:', error);
}
```

### `setTokenAllowance`

Sets the token allowance for a specific token and spender address.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `request` (`ApproveTokenRequest`): The approval request.
  * `walletClient` (`Client`): The Viem client used to send the transaction.
  * `token` (`BaseToken`): The token for which to set the allowance.
  * `spenderAddress` (`string`): The address of the spender.
  * `amount` (`bigint`): The amount of tokens to approve.

**Returns**

A Promise that resolves to a `Hash` representing the transaction hash or `void` if no transaction is needed (e.g., for native tokens).

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { setTokenAllowance } from '@lifi/sdk-provider-ethereum';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const approvalRequest = {
  walletClient: walletClient, // Viem wallet client
  token: {
    address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
    chainId: 1,
  },
  spenderAddress: '0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE',
  amount: 100000000n,
};

try {
  const txHash = await setTokenAllowance(client, approvalRequest);
  console.log('Transaction Hash:', txHash);
} catch (error) {
  console.error('Error:', error);
}
```

### `revokeTokenApproval`

Revokes the token approval for a specific token and spender address.

**Parameters**

* `client` (`SDKClient`): The SDK client instance.
* `request` (`RevokeApprovalRequest`): The revoke request.
  * `walletClient` (`Client`): The Viem client used to send the transaction.
  * `token` (`BaseToken`): The token for which to revoke the allowance.
  * `spenderAddress` (`string`): The address of the spender.

**Returns**

A Promise that resolves to a `Hash` representing the transaction hash or `void` if no transaction is needed (e.g., for native tokens).

```typescript Example theme={"system"}
import { createClient } from '@lifi/sdk';
import { revokeTokenApproval } from '@lifi/sdk-provider-ethereum';

const client = createClient({
  integrator: 'Your dApp/company name',
});

const revokeRequest = {
  walletClient: walletClient, // Viem wallet client
  token: {
    address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
    chainId: 1,
  },
  spenderAddress: '0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE',
};

try {
  const txHash = await revokeTokenApproval(client, revokeRequest);
  console.log('Transaction Hash:', txHash);
} catch (error) {
  console.error('Error:', error);
}
```