Assets

Get account information about a given asset.

Given a specific account public key and asset ID, this call returns the account's asset holding and asset parameters (if either exist). Asset parameters will only be returned if the provided address is the asset's creator.

GEThttps://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}

Path parameters

address*string

An account public key

Pattern: [A-Z0-9]{58}

asset-id*integer

An asset identifier

Query parameters

Response

200400401500default

AccountAssetResponse describes the account's asset holding and asset parameters (if either exist) for a specific asset ID. Asset parameters will only be returned if the provided address is the asset's creator.

Body

application/jsonapplication/msgpack

asset-holdingAssetHolding (object)

Describes an asset held by an account.

Definition: data/basics/userBalance.go : AssetHolding

created-assetAssetParams (object)

AssetParams specifies the parameters for an asset.

[apar] when part of an AssetConfig transaction.

Definition: data/transactions/asset.go : AssetParams

round*integer

The round for which this information is relevant.

Request

JavaScriptCurlPython

const response = await fetch('https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401500

{
  "asset-holding": {
    "amount": 0,
    "asset-id": 0,
    "is-frozen": false
  },
  "created-asset": {
    "clawback": "text",
    "creator": "text",
    "decimals": 0,
    "default-frozen": false,
    "freeze": "text",
    "manager": "text",
    "metadata-hash": "Ynl0ZXM=",
    "name": "text",
    "name-b64": "Ynl0ZXM=",
    "reserve": "text",
    "total": 0,
    "unit-name": "text",
    "unit-name-b64": "Ynl0ZXM=",
    "url": "text",
    "url-b64": "Ynl0ZXM="
  },
  "round": 0
}