Skip to main content

/extended/v3/principals/{principal}/balances/ft REST API Endpoint

Get a principal's fungible-token balances, sorted by balance descending.

Updated on
Aug 18, 2026

Path Parameters

principal
string
REQUIRED

Stacks account or contract principal.

Query Parameters

limit
integer

Number of results per page

cursor
string

(Optional) Cursor for paginating FT balances (sorted by balance, descending). Format: balance:asset_identifier

Returns

total
integer

Total number of matching records.

limit
integer

Number of results per page

cursor
object

Cursor metadata for this page of results.

next
string | null

Cursor for the next page, or null when there is no next page.

previous
string | null

Cursor for the previous page, or null when there is no previous page.

current
string

Cursor identifying the current page.

results
array

Items returned for the current page.

asset_identifier
string

Fungible token asset identifier

balance
string

The principal's balance of this token, as a string-quoted integer in base units

Request
Response
1
{
2
"total": 0,
3
"limit": 1,
4
"cursor": {
5
"next": null,
6
"previous": null,
7
"current": null
8
},
9
"results": []
10
}
1
{
2
"total": 0,
3
"limit": 1,
4
"cursor": {
5
"next": null,
6
"previous": null,
7
"current": null
8
},
9
"results": []
10
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free