Skip to main content

/extended/v2/addresses/{address}/balances/ft/token API Method

Retrieves the balance of a specific fungible token (FT) for a given Stacks address

Updated on
Jun 13, 2025

/extended/v2/addresses/{address}/balances/ft/token API Method

Path Parameters

address
string
REQUIRED
The Stacks address to retrieve the fungible token balance for (must be a valid Stacks address starting with 'SP' or 'SM')
token
string
REQUIRED
The fully qualified identifier of the fungible token in the format: 'contract_address.contract_name::token_name' or just a string to represent a token

Returns

ft_balance_response
object
Balance information for the specified fungible token
balance
string
The token balance amount, represented as a string to preserve precision for large numbers. This value is denominated in the smallest unit of the token according to its decimals. Returns '0' if the address does not own any of the specified token.
Request
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free