Get Token Balance

Get details of a list of wallet addresses, including their explorer Url & balance

Get Token Balance API

This endpoint returns the balance of a specific token for the provided address.

Typescript (SDK)

const balance = await rango.tokenBalance({
    walletAddress: "0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88",
    blockchain: "BSC", 
    symbol: "BNB",
    address: null,
})

Node.js (Axios)

const response = await axios.get('https://api.rango.exchange/basic/token-balance', {
  params: {
    'walletAddress': '0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88',
    'blockchain': 'BSC',
    'symbol': 'BNB',
    'address': null,
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32'
  }
});

Bash (cURL)

curl --request GET \
     --url 'https://api.rango.exchange/basic/token-balance?walletAddress=0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88&blockchain=BSC&symbol=BNB&apiKey=c6381a79-2817-4602-83bf-6a641a409e32'

Token Balancerango-exchange

Token Balance Swagger

Token Balance Request

API Definition

• blockchain* String

  • Description: The blockchain which this token belongs to.

  • Example: BSC

• symbol* String

  • Description: The token symbol.

  • Example: BNB

• address String

  • Description: Smart contract address of token, null for native tokens.

  • Example: null

• walletAddress* String

  • Description: User wallet address for the desired blockchain.

SDK Models (Typescript)

export type TokenBalanceRequest = {
  blockchain: string
  symbol: string
  address: string | null
  walletAddress: string
}

Token Balance Response

API Definition

• balance

  • Description: balance amount

  • Example: 46077752529840023

• error

  • Description: Error message if there was any problem

• errorCode

  • Description: Error code if there was any problem

• traceId

  • Description: Trace id help Rango support to resolve the issue

SDK Models (Typescript)

export type TokenBalanceResponse = {
  balance: string | null
  error: string | null
  errorCode: number | null
  traceId: number | null
}

Sample Response

{
  "balance": "46077752529840023",
  "error": null,
  "errorCode": null,
  "traceId": null
}