SDK

Token Management

Get token lists, check balances, and manage token approvals.

Get Token List

Call the Token List API to get all available tokens on your chosen blockchain.

  • Method: GET
  • URL: https://open-api.openocean.finance/v3/:chain/tokenList
ParameterTypeExampleDescription
chainstringavaxThe chain name

Using SDK

Terminal
JS
1
async getTokenList() {
2
let { data } = await api.getTokenList({ chain: 'bsc' })
3
this.inToken = data.find(item => item.symbol == 'USDC')
4
this.outToken = data.find(item => item.symbol == 'BUSD')
5
}

Example Response

Terminal
{}
1
{
2
"code": 200,
3
"data": [
4
{
5
"id": 2377,
6
"code": "grove",
7
"name": "GroveCoin",
8
"address": "0xf33893de6eb6ae9a67442e066ae9abd228f5290c",
9
"decimals": 8,
10
"symbol": "GRV",
11
"icon": "https://s3.openocean.finance/token_logos/logos/...",
12
"chain": "bsc",
13
"usd": "0.948606"
14
}
15
]
16
}

Get Balance

Check token balances once your wallet is connected.

Using Wallet API

Terminal
JS
1
const { sdk } = myWallet;
2
const contract = new sdk.eth.Contract(ERC20_abi, inToken);
3
balance = await contract.methods.balanceOf(result.address).call();

Using Open API

Terminal
JS
1
getBalance() {
2
if (this.address) {
3
let params = {
4
chain: 'bsc',
5
chainId: 56,
6
account: 'your wallet address',
7
inTokenAddress: `${previousTokenAddress},${nextTokenAddress}`
8
};
9
axios.get(`https://open-api.openocean.finance/v3/${params.chain}/getBalance`, { params })
10
.then(res => {
11
const { data } = res.data
12
const previousBalance = data[0].balance
13
const nextBalance = data[1].balance
14
})
15
}
16
}

Using SDK

Terminal
JS
1
async getBalance() {
2
if (!this.myWallet) {
3
alert('Please connect the wallet.')
4
return
5
}
6
7
let inBalance = await swapSdk.getBalance({
8
account: this.myWallet.address,
9
chain: this.chainName,
10
tokenAddressOrSymbol: this.inToken.address,
11
decimals: this.inToken.decimals,
12
})
13
this.inTokenBalance = inBalance.short
14
15
let outBalance = await swapSdk.getBalance({
16
account: this.myWallet.address,
17
chain: this.chainName,
18
tokenAddressOrSymbol: this.outToken.address,
19
decimals: this.outToken.decimals,
20
})
21
this.outTokenBalance = outBalance.short
22
}

Next Steps