Get Token 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/token/holders/{asset_id}

Testnet

GET https://api-testnet11.spacescan.io/token/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/token/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/token/holders/8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365"

Testnet

curl -X GET "https://api-testnet11.spacescan.io/token/holders/8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365"

Python

Mainnet

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

Testnet

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

JavaScript

Mainnet

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

Testnet

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

Response

Failed to load API response. Please try again later.

Response Schema

Field	Type	Description
status	string	The status of the API request
tokens	array	List of CAT holders
next_cursor	number	Pagination cursor for the next page
total_count	string	Total holders count

Holder Object

Each holder in the tokens array contains:

Field	Type	Description
address	string	The holder's address
amount	string	The amount of CAT tokens held

Error Responses

HTTP Status Code	Meaning
400	Bad Request -- Invalid parameters
429	Too Many Requests -- Rate limit exceeded
500	Internal Server Error
503	Service Unavailable