Skip to main content

getAssetsByOwner RPC Method

Returns the list of assets given an owner address.

Updated on
Jan 17, 2024

getAssetsByOwner RPC Method

Please note that this RPC method requires the Metaplex Digital Asset Standard API add-on enabled on your QuickNode endpoint.

Parameters

ownerAddress
string
REQUIRED
The address of the owner
sortBy
object
Sorting Criteria.
sortBy
string
The criteria to sort by - can be one of "created", "updated", "recentAction", "none"
sortDirection
string
Can be one of "asc", "desc"
limit
integer
The maximum number of assets to retrieve
page
integer
The index of the page to retrieve. The page parameter starts at 1
before
string
Retrieve assets before the specified id
after
string
Retrieve assets after the specified id

Returns

assetList
object
The information about the list of assets:
total
integer
The number of assets returned
limit
integer
The limit specified in the request
items
array of objects
An array of objects containing information about the specified assets:
asset
object
The information about the specified asset:
interface
string
The asset interface. "V1_NFT", "V1_PRINT", "LEGACY_NFT", "V2_NFT", "FungibleAsset", "Custom", "Identity", "Executable", "ProgrammableNFT"
id
string
The asset id
content
object
An object containting the asset content:
$schema
string
The schema of the asset
json_uri
string
The json uri of the asset
files
array of objects
The files related to the asset
uri
string
The uri of the file
mime
string
The mime type of the file
quality
object
The quality of the file
contexts
array of strings
The contexts of the file
metadata
object
The metadata of the asset
name
string
The name of the asset
description
string
The description of the asset
symbol
string
The symbol of the asset
token_standard
string
The token standard of the asset
attributes
array of objects
The attributes of the asset
value
integer/string
The value of the attribute
trait_type
string
The type of attribute
links
object
Links related to the asset
external_url
string
The external url
image
string
The url of the image
authorities
array of objects
The list of authorities
address
string
The address of the authority
scopes
array of strings
The scopes of the authority - "full", "royalty", "metadata", "extension"
compression
object
The compression information for this asset
asset_hash
string
The asset hash of this asset
compressed
boolean
The compression status of this asset
creator_hash
string
The creator hash of this asset
data_hash
string
The data hash of this asset
eligible
boolean
Whether this asset is eligible
leaf_id
integer
The leaf id of this asset
seq
integer
The seq of this asset
tree
string
The tree associated with this asset
grouping
array of objects
The grouping information for this asset
group_key
string
The group key for this asset. "collection"
group_value
string
The group value for this asset
royalty
string
Royalty information about this asset
basis_points
integer
The royalty basis points
locked
boolean
The locked status of the royalty
percent
integer
The royalty percent
primary_sale_happened
boolean
The primary sale status
royalty_model
string
The royalty model for this asset. "creators", "fanout", "single"
target
string | null
The royalty target
creators
array of objects
The list of creators for this asset
address
string
The address of the creator
share
integer
The share of the creator
verified
boolean
Whether the creator is verified
ownership
object
The ownership information of the asset
delegate
string
The delegate of the asset
delegated
boolean
Whether the asset is delegated
frozen
boolean
Whether the asset is frozen
owner
string
The owner of the asset
ownership_model
string
The ownership model of the asset. "single","token"
uses
object
The uses information of the asset
remaining
integer
The remaining uses
total
integer
The total uses
use_method
string
The use method. "burn","multiple","single"
supply
object
The supply information of the asset
edition_nonce
integer
The edition nonce
print_current_supply
integer
The current supply
print_max_supply
integer
The max supply
mutable
boolean
Whether the asset's metadata is mutable
burnt
boolean
Whether the asset is burnt
Request
1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc": "2.0","id": 1,"method": "getAssetsByOwner","params": {"ownerAddress": "E645TckHQnDcavVv92Etc6xSWQaq8zzPtPRGBheviRAk", "limit": 10, "page": 1}}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free