White API Documentation

Complete guide to integrating with our unified API for Telegram gifts and stickers market data

📚
Version BETA
🔄
Last updated November 2025
Status Active

🚀 Quick Start Guide

Get up and running in 5 minutes with our step-by-step guide

1
🤖

Get Your API Key

Start a conversation with our Telegram bot to receive your unique API key.

# Message the bot on Telegram https://t.me/WhiteAPIBot
2
💻

Make Your First API Call

Use this simple request to get floor prices for any gift

# Example API request WhiteAPI.get_floor_gift(name = "Plush Pepe")
3
📊

Get Instant Results

Receive comprehensive market data across all platforms

# Response example { "status": "success", "result": { "Plush Pepe": { "mrkt": 6380.6, "portals": 5200.0, "tonnel": 6150.0 } } }

🎁 Gift Endpoints

Real-time pricing and analytics for Telegram gifts

🖼️ Sticker Endpoints

Sticker market pricing and supply data

🛠️ Sticker Tools API

Advanced analytics and stats for sticker collections

⚠️ Error Handling

Common error responses and troubleshooting

401 Unauthorized

Authentication

Invalid or missing API key

{
  "status": "error",
  "message": "API key is required"
}

How to Fix

  • Check that your API key is correct

400 Bad Request

Client Error

Invalid request parameters or missing required fields

{
  "status": "error",
  "message": "Name parameter is required"
}

How to Fix

  • Check required parameters
  • Ensure Content-Type is application/json

429 Too Many Requests

Rate Limit

API rate limit exceeded for your plan

{
  "status": "error",
  "message": "Rate limit exceeded"
}

How to Fix

  • Check your current usage
  • Implement request throttling