Get Token Balance

This endpoint allows you to fetch the token (CAT) balances for a given address.

Endpoint

Mainnet

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

Testnet

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

Parameters

Parameter	Type	Description
address	string	The XCH address to fetch token 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/token-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/token-balance/xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8"

Testnet

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

Python

Mainnet

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

Testnet

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

JavaScript

Mainnet

const address = "xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8";
const url = https://api.spacescan.io/address/token-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/token-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 token balances
balance[].asset_id	string	The asset ID of the token
balance[].token_id	string	The token ID in tkn format
balance[].balance	number	The token balance amount
balance[].name	string	The name of the token (null if not available)
balance[].symbol	string	The symbol of the token (null if not available)