Skip to main content

/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens REST API Endpoint

Get token relationships info for an account

Updated on
Aug 23, 2024

/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Path Parameters

idOrAliasOrEvmAddress
string
REQUIRED
The account alias or account id or evm address

Query Parameters

limit
integer
The maximum number of items to return
order
string
The order in which items are listed (asc or desc)
spender.id
string
The ID of the spender to return information for
token.id
string
The ID of the token to return information for

Returns

tokens
array
An array of objects, each representing details about a token associated with the account
automatic_association
boolean
A boolean indicating if the token is automatically associated with the account
balance
integer
The balance of the token in the account
created_timestamp
string
The timestamp when the token was created
decimals
integer
The number of decimal places the token uses
token_id
string
The unique identifier of the token
freeze_status
string
The freeze status of the token for the account. It can have values such as 'FROZEN', 'UNFROZEN', or 'NOT_APPLICABLE'
kyc_status
string
The KYC (Know Your Customer) status of the token for the account. It can have values such as 'GRANTED', 'REVOKED', or 'NOT_APPLICABLE'
links
object
An object containing pagination links
next
string
A URL to fetch the next set of transactions, if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/accounts/0.0.6294/tokens'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free