List All CATs

This endpoint allows you to fetch a comprehensive list of all Chia Asset Tokens (CATs) in the Chia ecosystem.

Endpoint

Mainnet

GET https://api.spacescan.io/cats

Testnet

GET https://api-testnet11.spacescan.io/cats

Parameters

Parameter	Type	Required	Default	Description
include_price	boolean	No	false	Include price information
currency	string	No	USD	Currency for price conversion (e.g., USD, EUR)

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/cats?include_price=true&currency=USD" \
     -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/cats"

Testnet

curl -X GET "https://api-testnet11.spacescan.io/cats"

Python

Mainnet

import requests
url = "https://api.spacescan.io/cats"
response = requests.get(url)
data = response.json()
print(data)

Testnet

import requests
url = "https://api-testnet11.spacescan.io/cats"
response = requests.get(url)
data = response.json()
print(data)

JavaScript

Mainnet

const url = "https://api.spacescan.io/cats";
fetch(url)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Testnet

const url = "https://api-testnet11.spacescan.io/cats";
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
cats	array	Array of CAT objects

CAT Object Fields

Field	Type	Description
asset_id	string	The unique identifier of the CAT
token_id	string	Token ID in tkn format
name	string	The name of the CAT
description	string	Description of the CAT
symbol	string	Trading symbol of the CAT
preview_url	string	URL to the CAT's logo image
tags	array	Array of category tags
twitter	string	Twitter profile URL (null if not set)
discord	string	Discord server URL (null if not set)
website	string	Official website URL (null if not set)
price_xch	number	Price in XCH (only if include_price=true)
price_[currency]	number	Price in specified currency (only if include_price=true)

Example Response

{
  "status": "success",
  "cats": [
    {
      "asset_id": "a628c1c2c6fcb74d53746157e438e108eab5c0bb3e5c80ff9b1910b3e4832913",
      "token_id": "tkn1c2c6fcb74d53746157e438e108eab5c0bb3e5c80ff9b1910b3e4832913",
      "name": "Example Token",
      "description": "An example CAT token",
      "symbol": "EXT",
      "preview_url": "https://assets.spacescan.io/cat/example-token.png",
      "tags": ["defi", "gaming"],
      "twitter": "https://twitter.com/exampletoken",
      "discord": "https://discord.gg/exampletoken",
      "website": "https://example.com",
      "price_xch": 0.5,
      "price_usd": 25.50
    }
  ]
}

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