Get account information about a given asset.

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

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.

Parameters

formatstringjsonmsgpackquery

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

addressstringrequiredpath

An account public key

asset-idintegerrequiredpath

An asset identifier

Response

200OK

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.

400Bad Request

Malformed address or asset ID

401Unauthorized

Invalid API Token

500Internal Server Error

Internal Error

default

Unknown Error

Get account information about a given asset.

curl -X GET 'https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}'

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}')
data = response.json()

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

const data = await response.json();

const endpoint = "https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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

const data = await response.json();

import requests

response = requests.get('https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo.nownodes.io/v2/accounts/{address}/assets/{asset-id}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

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

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

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}