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

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

curl -X 'GET' \
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v2/addresses/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/balances/ft?limit=100&offset=0' \
    -H 'Content-Type: application/json'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free