Get Token Activities

This endpoint allows you to fetch activity history for a specific CAT (Chia Asset Token), including transfers, mints, burns, and melts.

Endpoint

Mainnet

GET https://api.spacescan.io/token/activity

Testnet

GET https://api-testnet11.spacescan.io/token/activity

Parameters

Parameter	Type	Required	Default	Description
asset_id	string	No	-	Filter activities by CAT asset ID
type	string	No	transfer	Activity type (transfer/mint/burn/melt)
count	number	No	100	Number of records to return (max: 100)
page	number	No	1	Page number for pagination

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/activity?asset_id=YOUR_asset_id&type=transfer" \
     -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/token/activity?asset_id=8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365&type=transfer&count=10&page=1"

Testnet

curl -X GET "https://api-testnet11.spacescan.io/token/activity?asset_id=8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365&type=transfer&count=10&page=1"

Python

Mainnet

import requests
params = {
"asset_id": "8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365",
"type": "transfer",
"count": 10,
"page": 1
}
url = "https://api.spacescan.io/token/activity"
response = requests.get(url, params=params)
data = response.json()
print(data)

Testnet

import requests
params = {
"asset_id": "8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365",
"type": "transfer",
"count": 10,
"page": 1
}
url = "https://api-testnet11.spacescan.io/token/activity"
response = requests.get(url, params=params)
data = response.json()
print(data)

JavaScript

Mainnet

const params = new URLSearchParams( {
asset_id: "8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365",
type: "transfer",
count: 10,
page: 1
});
const url = https://api.spacescan.io/token/activity?${params};
fetch(url)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Testnet

const params = new URLSearchParams( {
asset_id: "8c77de1427156b98fb15cce77d908f79bd69f6b4b8e3a60d8e051dac481b5365",
type: "transfer",
count: 10,
page: 1
});
const url = https://api-testnet11.spacescan.io/token/activity?${params};
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 token activities

Token Activity Object

Field	Type	Description
coin_id	string	Unique identifier for the coin
time	string	Timestamp of the activity
height	number	Block height of the transaction
amount	string	Amount of tokens involved in the activity
from	string	Source address
to	string	Destination address
cat_id	string	CAT asset identifier

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