Assets

Get account information about a given asset.

get

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.

Authorizations

Path parameters

addressstringRequired

An account public key

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

asset-idintegerRequired

An asset identifier

Query parameters

formatstring · enumOptional

Configures whether the response object is JSON or MessagePack encoded. If not provided, defaults to JSON.

Possible values:

Responses

200

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.

application/jsonapplication/msgpack

400

Malformed address or asset ID

application/jsonapplication/msgpack

401

Invalid API Token

application/jsonapplication/msgpack

500

Internal Error

application/jsonapplication/msgpack

default

Unknown Error

get

HTTPcURLJavaScriptPython

GET /v2/accounts/{address}/assets/{asset-id} HTTP/1.1
Host: algo.nownodes.io
X-Algo-API-Token: YOUR_API_KEY
Accept: */*

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