1. Ownership
  2. Get token balances
GET

/v1/balances

chainId*
address*
nfts
contractAddresses
fetchNftMetadata
forceRefresh
curl --request GET \
     --url https://api.bitski.com/v1/balances \
     --header 'Content-Type: application/json' \
     --data '{
 "balances": array of object,
 "error": 
}'

Token balances will return the assets of a given wallet for the following types of primitives:

  • fungible (ERC20)
  • semi-fungible (ERC1155)
  • non-fungible (ERC721)

Right now only EVM chains, Ethereum and Polygon, are supported.

Query Parameters

chainIdRequiredDefault: 1
integer

Set the network to get data from. For EVM chains, see a list of available chains here.

addressRequired
string

The wallet address to fetch.

nfts
boolean

If true, will fetch NFT (ERC721 and ERC1155) balances. If false, will only fetch ERC20 assets.

contractAddresses
array of string

The contract addresses to get NFTs from (up to a max of 20 contracts). If used, only the NFTs that were minted from the addresses will be returned. Only used if nfts=true is passed in as well. Values should be passed as a comma separated list, e.g. contractAddresses=0xabc,0x123

fetchNftMetadata
boolean

If true, will fetch metadata for NFTs. Only used if nfts=true is passed in as well.

forceRefresh
boolean

If true, the cache for the asset will be cleared and set by the next request.

Response

balancesRequired
array of object
errorRequired
object