Skip to main content

/extended/v2/addresses/{address}/balances/ft REST API Endpoint

Retrieves a paginated list of fungible token (FT) balances for a specific Stacks address

Updated on
Jul 14, 2026

Path Parameters

address
string
REQUIRED

The Stacks address to retrieve fungible token balances for (must be a valid Stacks address starting with 'SP' or 'SM')

Query Parameters

limit
integer

Maximum number of token balances to return per page. Defaults to 20 if not specified.

offset
integer

Number of token balances to skip for pagination. Used with limit to paginate through results.

Returns

ft_balances_response
object

Paginated list of fungible token balances for the specified address

limit
integer

The number of results returned per page, as requested in the query parameters

offset
integer

The number of results skipped, as requested in the query parameters

total
integer

The total number of fungible token balances available for this address

results
array

List of fungible token balances for this address

token
string

The fully qualified identifier of the fungible token in the format: 'contract_address.contract_name::token_name'

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.

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free