refreshBalances

Returns

Balance

[Balance!]!

See Balance

Show Properties

walletId

String!

The ID of the wallet (walletAddress:networkId).

tokenId

String!

The ID of the token (tokenAddress:networkId).

address

String!

The wallet address.

networkId

Int!

The wallet network.

tokenAddress

String!

The contract address of the token.

balance

String!

The balance held by the wallet.

shiftedBalance

Float!

The balance held by the wallet, adjusted by the number of decimals in the token.

uiBalance

Float

The wallet balance expressed for UI display. Defaults to shiftedBalance. When uiAmountMode is RAW, Token-2022 balances are divided by the active UI amount multiplier when available.

balanceUsd

String

The balance held by the wallet in USD.

tokenPriceUsd

String

The token price in USD.

firstHeldTimestamp

Int

The time that this address first held a token.

token

EnhancedToken

Metadata for the token. See EnhancedToken

liquidityUsd

String

The liquidity of the token in USD.

tokenLastTradedTimestamp

Int

Unix timestamp (seconds) of the token’s most recent trade/market event across all pools we track. Token-level (not specific to this wallet). Useful for filtering out dead/worthless tokens, e.g. no activity in months.

wallet

Wallet

Identity and profile metadata for the wallet holding this balance. Not always available. See Wallet

Arguments

input

[RefreshBalancesInput!]!

required

See RefreshBalancesInput

Show Properties

walletId

String!

required

The wallet address(es) in question

tokenId

String!

required

The token to check balance of

Example

Test this query in the Explorer →

mutation {
  refreshBalances(
    input: [
      {
        walletId: "0xADDRESS:1"
        tokenId: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1"
      }
    ]
  ) {
    walletId
    tokenId
    balance
    shiftedBalance
    balanceUsd
    tokenPriceUsd
    token {
      name
      symbol
    }
  }
}

Usage Guidelines

This mutation is EVM only
walletId is formatted as walletAddress:networkId and tokenId as tokenAddress:networkId
input accepts a list, so you can refresh multiple wallet/token balances in a single call

​Returns

​Arguments

​Example

​Usage Guidelines

Returns

Arguments

Example

Usage Guidelines