PunkPredictor API Documentation

PunkPredictor: The most accurate AI valuation tool for CryptoPunks. Find deals and make informed decisions.

Welcome to the PunkPredictor API documentation. PunkPredictor is the most accurate AI-powered valuation model for CryptoPunks, providing real-time price predictions, historical valuations, and market analytics for NFT collectors and investors.

Our advanced machine learning algorithms analyze multiple factors including rarity, attributes, historical sales data, and market trends to deliver precise valuations that give you an edge in the CryptoPunk market.

Base URL: https://api.punkpredictor.xyz

Key Features

As the most accurate AI valuation tool for CryptoPunks, PunkPredictor helps you find deals and make informed decisions with these features:

  • Accurate Price Predictions: Get current estimated values for any CryptoPunk with our AI model
  • Historical Valuations: Access historical price data to track value changes over time
  • Market Analytics: Monitor floor price changes and average valuation trends
  • Attribute-Based Analysis: Understand how specific attributes impact punk valuations

Authentication

All API requests require an API key that should be included in the request body. PunkPredictor offers exclusive membership access with limited availability to ensure premium service quality.

To get your API key:

  1. Purchase a subscription to PunkPredictor
  2. Once your payment is confirmed, the site will be unlocked
  3. Click on the key icon located in the bottom right corner of the screen
  4. Your unique API key will be displayed and can be copied for use in your applications

Your API key is automatically generated when you subscribe to our service and can be accessed at any time through the key icon after logging in.

Note: Keep your API key secure and do not share it publicly. All API keys have rate limits to ensure service stability.

Rate Limits

The API is rate limited to 30 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Our rate limits are designed to ensure fair usage and optimal performance for all members. For applications requiring higher limits, please contact our support team.

Response Status Codes

Status Code Description
200 OK Request successful
400 Bad Request Invalid parameters or missing required fields
401 Unauthorized Invalid or missing API key
429 Too Many Requests Rate limit exceeded
500 Server Error Internal server error

API Endpoints

POST

Predict the Price of a Punk Today

/predict_price_of_a_punk_today

Get the current predicted price for a specific CryptoPunk.

Parameters

Parameter Type Description
id_punk Required integer The ID of the CryptoPunk (0-9999)
api_key Required string Your API key for authentication

Python Example

Python 
import requests

# Base URL
BASE_URL = 'https://api.punkpredictor.xyz'
api_key = 'YOUR_API_KEY'

def predict_price_of_punk(id_punk, api_key):
    url = f"{BASE_URL}/predict_price_of_a_punk_today"
    data = {
        "id_punk": id_punk,
        "api_key": api_key
    }
    response = requests.post(url, json=data)
    return response.json()

# Example Usage
result = predict_price_of_punk(1234, api_key)
print(result)

Try it

Response

200 OK
POST

Get Punk Historical Valuations

/get_punk_history

Retrieve historical price valuations for a specific CryptoPunk.

Parameters

Parameter Type Description
punk_id Required integer The ID of the CryptoPunk (0-9999)
api_key Required string Your API key for authentication

Python Example

Python 
import requests

# Base URL
BASE_URL = 'https://api.punkpredictor.xyz'
api_key = 'YOUR_API_KEY'

def get_punk_history(punk_id, api_key):
    url = f"{BASE_URL}/get_punk_history"
    data = {
        "punk_id": punk_id,
        "api_key": api_key
    }
    response = requests.post(url, json=data)
    return response.json()

# Example Usage
result = get_punk_history(1234, api_key)
print(result)

Try it

Response

200 OK
POST

Get All Predictions

/get_all_predictions

Retrieve all available price predictions for CryptoPunks.

Parameters

Parameter Type Description
api_key Required string Your API key for authentication

Python Example

Python 
import requests

def get_all_predictions(api_key):
    url = "https://api.punkpredictor.xyz/get_all_predictions"
    try:
        response = requests.post(
            url,
            json={"api_key": api_key},
            headers={"Content-Type": "application/json"}
        )
        if response.status_code == 200:
            data = response.json()
            return data["predictions"]
        else:
            print(f"Status: Failed")
            print(f"Status code: {response.status_code}")
            print(f"Error message: {response.text}")
    except Exception as e:
        print(f"Error occurred: {str(e)}")

# Example Usage
predictions = get_all_predictions('YOUR_API_KEY')

Try it

Response

200 OK