Get CAT Circulating Supply

This endpoint allows you to fetch the current circulating supply of a Chia Asset Token (CAT). Monitor the actual number of tokens actively circulating in the market, excluding locked, reserved, or unvested tokens. This data is essential for accurate market cap calculations, liquidity analysis, and understanding the true market dynamics of CAT tokens.

Endpoint

Mainnet

GET https://api.spacescan.io/token/circulating-supply/{asset_id}

Testnet

GET https://api-testnet11.spacescan.io/token/circulating-supply/{asset_id}

Parameters

Parameter	Type	Description
asset_id	string	The unique identifier (TAIL hash) 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/circulating-supply/{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/circulating-supply/b8edcc6a7cf3738a3806fdbadb1bbcfc2540ec37f6732ab3a6a4bbcd2dbec105"

Testnet

curl -X GET "https://api-testnet11.spacescan.io/token/circulating-supply/b8edcc6a7cf3738a3806fdbadb1bbcfc2540ec37f6732ab3a6a4bbcd2dbec105"

Python

Mainnet

import requests
asset_id = "b8edcc6a7cf3738a3806fdbadb1bbcfc2540ec37f6732ab3a6a4bbcd2dbec105"
url = f"https://api.spacescan.io/token/circulating-supply/{asset_id}"
response = requests.get(url)
data = response.json()
print(data)

Testnet

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

JavaScript

Mainnet

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

Testnet

const assetId = "b8edcc6a7cf3738a3806fdbadb1bbcfc2540ec37f6732ab3a6a4bbcd2dbec105";
const url = https://api-testnet11.spacescan.io/token/circulating-supply/${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
circulating_supply	number	The current circulating supply of the CAT token

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