Convert To NFT ID

This endpoint allows you to convert a puzzle hash to an NFT ID.

Endpoint

Mainnet

GET https://api.spacescan.io/tools/convert_to_nft/{hash}

Testnet

GET https://api-testnet11.spacescan.io/tools/convert_to_nft/{hash}

Parameters

Parameter	Type	Required	Default	Description
hash	string	Yes	-	Puzzle hash (with or without 0x prefix)

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/tools/convert_to_nft/0x7ff8b187e156c030bdc857a12dcb3910bfcb17be923720b59a9d01dfd8243d8c" \
     -H "x-api-key: YOUR_API_KEY"

Live API Test

Mainnet

🚀 Test API in Browser

Request Examples

cURL

curl -X GET "https://api.spacescan.io/tools/convert_to_nft/0x7ff8b187e156c030bdc857a12dcb3910bfcb17be923720b59a9d01dfd8243d8c"

Python

import requests

hash = "0x7ff8b187e156c030bdc857a12dcb3910bfcb17be923720b59a9d01dfd8243d8c"
url = f"https://api.spacescan.io/tools/convert_to_nft/{hash}"

response = requests.get(url)
data = response.json()
print(data)

JavaScript

const hash = "0x7ff8b187e156c030bdc857a12dcb3910bfcb17be923720b59a9d01dfd8243d8c";
const url = `https://api.spacescan.io/tools/convert_to_nft/${hash}`;

fetch(url)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Response Schema

Field	Type	Description
status	string	Status of the request (success/failure)
data	string	The converted NFT ID

Example Response

{
  "status": "success",
  "data": "nft10lutrplp2mqrp0wg27sjmjeezzluk9a7jgmjpdv6n5qalkpy8kxqrkqag7"
}

Error Responses

HTTP Status Code	Meaning
400	Bad Request -- Invalid puzzle hash format
429	Too Many Requests -- You're requesting too many times
500	Internal Server Error -- We had a problem with our server
503	Service Unavailable -- We're temporarily offline for maintenance