Get NFT Balance

This endpoint allows you to fetch the NFT balances for a given address.

Endpoint

Mainnet

GET https://api.spacescan.io/address/nft-balance/{address}

Testnet

GET https://api-testnet11.spacescan.io/address/nft-balance/{address}

Parameters

Parameter	Type	Description
address	string	The XCH address to fetch NFT balances for

Free API

Use api.spacescan.io for free tier access. See our API Plans for rate limits and features.

Pro API

Use pro-api.spacescan.io with your API key in the x-api-key header. See our API Plans for details.

curl -X GET "https://pro-api.spacescan.io/address/nft-balance/{address}" \
     -H "x-api-key: YOUR_API_KEY"

Live API Test

Mainnet

🚀 Test API in Browser

Testnet

🚀 Test API in Browser

Request Examples

cURL

Mainnet

curl -X GET "https://api.spacescan.io/address/nft-balance/xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8"

Testnet

curl -X GET "https://api-testnet11.spacescan.io/address/nft-balance/xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8"

Python

Mainnet

import requests
address = "xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8"
url = f"https://api.spacescan.io/address/nft-balance/{address}"
response = requests.get(url)
data = response.json()
print(data)

Testnet

import requests
address = "xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8"
url = f"https://api-testnet11.spacescan.io/address/nft-balance/{address}"
response = requests.get(url)
data = response.json()
print(data)

JavaScript

Mainnet

const address = "xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8";
const url = https://api.spacescan.io/address/nft-balance/${address};
fetch(url)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Testnet

const address = "xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8";
const url = https://api-testnet11.spacescan.io/address/nft-balance/${address};
fetch(url)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Response

Mainnet

Failed to load API response. Please try again later.

Testnet

Failed to load API response. Please try again later.

Response Schema

Field	Type	Description
status	string	Success or failure status
balance	array	List of NFT balances
balance[].nft_id	string	The unique identifier of the NFT
balance[].name	string	The name of the NFT (null if not available)
balance[].collection_id	string	The collection ID the NFT belongs to
balance[].preview_url	string	URL to the NFT preview image (null if not available)