Get CAT Holders

This endpoint allows you to fetch the list of holders for a specific CAT (Chia Asset Token).

Endpoint

Mainnet

GET https://api.spacescan.io/cat/holders/{asset_id}

Testnet

GET https://api-testnet11.spacescan.io/cat/holders/{asset_id}

Parameters

Parameter	Type	Description
asset_id	string	The unique identifier of the CAT

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/cat/holders/{asset_id}" \
     -H "x-api-key: YOUR_API_KEY"

Live API Test

Mainnet

🚀 Test API in Browser

Testnet

🚀 Test API in Browser

Request Example

cURL

Mainnet

curl -X GET "https://api.spacescan.io/cat/holders/6d95dae356e32a71db5ddcb42224754a02524c615c5fc35f568c2af04774e589"

Testnet

curl -X GET "https://api-testnet11.spacescan.io/cat/holders/6d95dae356e32a71db5ddcb42224754a02524c615c5fc35f568c2af04774e589"

Python

Mainnet

import requests
asset_id = "6d95dae356e32a71db5ddcb42224754a02524c615c5fc35f568c2af04774e589"
url = f"https://api.spacescan.io/cat/holders/{asset_id}"
response = requests.get(url)
data = response.json()
print(data)

Testnet

import requests
asset_id = "6d95dae356e32a71db5ddcb42224754a02524c615c5fc35f568c2af04774e589"
url = f"https://api-testnet11.spacescan.io/cat/holders/{asset_id}"
response = requests.get(url)
data = response.json()
print(data)

JavaScript

Mainnet

const assetId = "6d95dae356e32a71db5ddcb42224754a02524c615c5fc35f568c2af04774e589";
const url = https://api.spacescan.io/cat/holders/${assetId};
fetch(url)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Testnet

const assetId = "6d95dae356e32a71db5ddcb42224754a02524c615c5fc35f568c2af04774e589";
const url = https://api-testnet11.spacescan.io/cat/holders/${assetId};
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	The status of the API request
holders	array	List of CAT holders
total_holders	number	Total number of unique holders
total_supply	string	Total supply of the CAT

Holder Object

Each holder in the holders array contains:

Field	Type	Description
address	string	The holder's address
balance	string	The amount of CAT tokens held
percentage	number	Percentage of total supply held by this address
last_updated	string	Timestamp of last balance update

Error Responses

HTTP Status Code	Meaning
400	Bad Request -- Your request is invalid.
404	Not Found -- The specified CAT could not be found.
429	Too Many Requests -- You're requesting too many times! Slow down!
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.