Telegram Premium Reactions (SMM v2)
Supersim provides a high-throughput, automated Telegram Premium Reaction delivery system accessible via the industry-standard SMM Compatibility API (v2).
Key Features
Section titled “Key Features”- Single Shared API Key: Use the exact same API key (
supersim_YOUR_API_KEY) provided by the Telegram Bot for both Account purchases and Reactions. No separate credentials required. - Automated Random Distribution: The customer does not need to choose individual emojis. The engine automatically scans the target post, detects verified Telegram Premium / custom emoji already present or supported on the post, and distributes deliveries randomly across that verified pool.
- Pre-Flight Post Verification: Every order undergoes automatic target-post verification before charging your account balance. If the post is inaccessible or has no usable premium reactions, the request is rejected with
400 Bad Requestand no funds are deducted. - Atomic Idempotent Refunds: Cancelled or partially fulfilled orders automatically calculate undelivered items and credit the refund back to your balance immediately.
Endpoint & Protocols
Section titled “Endpoint & Protocols”| Property | Value |
|---|---|
| Endpoint URL | https://su-persim.uz/api/v2 |
| HTTP Methods | POST (recommended) or GET |
| Content-Type | application/x-www-form-urlencoded, application/json, or Query String |
| Authentication | Parameter key (or api_key / apiKey) |
Supported Actions
Section titled “Supported Actions”The SMM API v2 router supports five core actions:
services— Retrieve available reaction services, pricing rates, and quantity limits.balance— Check your real-time wallet balance in USD.add— Place a reaction order on a Telegram post.status— Query single or batch order progress and remaining counts.cancel— Cancel an active order and trigger automatic proportional refunds.
1. List Services (action=services)
Section titled “1. List Services (action=services)”Returns all currently enabled reaction services.
Request Parameters
Section titled “Request Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
key |
string |
Yes | Your Supersim API key (supersim_YOUR_API_KEY). |
action |
string |
Yes | Must be services. |
curl -s -X POST "https://su-persim.uz/api/v2" \ -d "key=supersim_YOUR_API_KEY" \ -d "action=services"import requests
resp = requests.post( "https://su-persim.uz/api/v2", data={"key": "supersim_YOUR_API_KEY", "action": "services"},)print(resp.json())const response = await fetch("https://su-persim.uz/api/v2", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ key: "supersim_YOUR_API_KEY", action: "services", }),});const data = await response.json();console.log(data);Example Response (200 OK)
Section titled “Example Response (200 OK)”[ { "service": 1, "name": "Telegram Random Premium Reactions", "type": "Default", "rate": "2.00", "min": "10", "max": "10000" }]2. Check Balance (action=balance)
Section titled “2. Check Balance (action=balance)”Returns your user balance in USD.
Request Parameters
Section titled “Request Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
key |
string |
Yes | Your Supersim API key. |
action |
string |
Yes | Must be balance. |
curl -s -X POST "https://su-persim.uz/api/v2" \ -d "key=supersim_YOUR_API_KEY" \ -d "action=balance"import requests
resp = requests.post( "https://su-persim.uz/api/v2", data={"key": "supersim_YOUR_API_KEY", "action": "balance"},)print(resp.json())const response = await fetch("https://su-persim.uz/api/v2", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ key: "supersim_YOUR_API_KEY", action: "balance", }),});const data = await response.json();console.log(data);Example Response (200 OK)
Section titled “Example Response (200 OK)”{ "balance": "45.50", "currency": "USD"}3. Create Reaction Order (action=add)
Section titled “3. Create Reaction Order (action=add)”Submits an order to deliver reactions to a specific Telegram post.
Request Parameters
Section titled “Request Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
key |
string |
Yes | Your Supersim API key. |
action |
string |
Yes | Must be add. |
service |
integer |
Yes | Service ID (e.g. 1 for Telegram Random Premium Reactions). |
link |
string |
Yes | Canonical public Telegram post URL (e.g. https://t.me/channel_name/123). |
quantity |
integer |
Yes | Number of reactions to deliver (must be within min and max). |
reactions |
string |
Optional | Legacy/compatibility parameter. Omit for normal usage. When omitted, random distribution across verified post reactions is applied automatically. |
How Random Premium Reactions Work
Section titled “How Random Premium Reactions Work”You do not need to provide reaction emoji in your request. When an order is placed:
- Pre-flight Scan: The system inspects the target channel and the exact post
link. - Custom Emoji Discovery: Usable Telegram Premium custom emoji already present on that post are automatically indexed into the order’s verified candidate pool.
- Random Dispatch: Active worker sessions shuffle the pool and deliver reactions randomly and evenly across the verified custom emoji.
- Error Rejection: If the target post contains no usable premium/custom reactions or is private/inaccessible, the API rejects the request before charging your balance.
curl -s -X POST "https://su-persim.uz/api/v2" \ -d "key=supersim_YOUR_API_KEY" \ -d "action=add" \ -d "service=1" \ -d "link=https://t.me/durov/342" \ -d "quantity=100"import requests
payload = { "key": "supersim_YOUR_API_KEY", "action": "add", "service": 1, "link": "https://t.me/durov/342", "quantity": 100,}
resp = requests.post("https://su-persim.uz/api/v2", data=payload)print(resp.json())const payload = new URLSearchParams({ key: "supersim_YOUR_API_KEY", action: "add", service: "1", link: "https://t.me/durov/342", quantity: "100",});
const response = await fetch("https://su-persim.uz/api/v2", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: payload,});const data = await response.json();console.log(data);Successful Response (200 OK)
Section titled “Successful Response (200 OK)”{ "order": 58}Pre-Validation & Error Responses (400 Bad Request)
Section titled “Pre-Validation & Error Responses (400 Bad Request)”| Error Message | Cause / Solution |
|---|---|
{"error": "Missing service parameter"} |
The service field was omitted. |
{"error": "Missing link parameter"} |
The link field was omitted. |
{"error": "Invalid Telegram post URL..."} |
Link format is invalid. Must match https://t.me/username/post_id. |
{"error": "Target channel 'xyz' not found."} |
Channel username does not exist or is private. |
{"error": "Reactions are disabled for this channel/post"} |
Post or channel settings have reactions turned off. |
{"error": "No usable premium/custom reactions found on target post."} |
Post has no custom/premium reactions available to replicate. |
{"error": "Insufficient balance..."} |
Your wallet balance is less than the calculated charge. |
4. Order Status (action=status)
Section titled “4. Order Status (action=status)”Track the delivery status and remaining count of one or multiple orders.
Status Values
Section titled “Status Values”| SMM Status | Meaning |
|---|---|
Pending |
Order received and queued; waiting for worker assignment. |
In progress |
Reaction sessions are actively delivering reactions to the target post. |
Completed |
All requested reactions have been successfully placed. |
Partial |
Order concluded or stopped before reaching 100%; undelivered portion was refunded. |
Canceled |
Order was cancelled before delivery; full charge was refunded. |
Failed |
Delivery could not proceed (e.g. post became inaccessible); undelivered reactions refunded. |
Single Order Status
Section titled “Single Order Status”curl -s -X POST "https://su-persim.uz/api/v2" \ -d "key=supersim_YOUR_API_KEY" \ -d "action=status" \ -d "order=58"import requests
resp = requests.post( "https://su-persim.uz/api/v2", data={"key": "supersim_YOUR_API_KEY", "action": "status", "order": 58},)print(resp.json())const response = await fetch("https://su-persim.uz/api/v2", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ key: "supersim_YOUR_API_KEY", action: "status", order: "58", }),});console.log(await response.json());Single Status Response (200 OK)
Section titled “Single Status Response (200 OK)”{ "charge": "0.20", "start_count": "0", "status": "In progress", "remains": "35", "currency": "USD"}Note: remains indicates the exact number of reactions still remaining to be delivered.
Batch Order Status (orders=id1,id2,id3)
Section titled “Batch Order Status (orders=id1,id2,id3)”To query multiple orders in a single HTTP request, pass comma-separated order IDs using the orders parameter.
curl -s -X POST "https://su-persim.uz/api/v2" \ -d "key=supersim_YOUR_API_KEY" \ -d "action=status" \ -d "orders=58,59,60"import requests
resp = requests.post( "https://su-persim.uz/api/v2", data={"key": "supersim_YOUR_API_KEY", "action": "status", "orders": "58,59,60"},)print(resp.json())const response = await fetch("https://su-persim.uz/api/v2", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ key: "supersim_YOUR_API_KEY", action: "status", orders: "58,59,60", }),});console.log(await response.json());Batch Status Response (200 OK)
Section titled “Batch Status Response (200 OK)”{ "58": { "charge": "0.20", "start_count": "0", "status": "Completed", "remains": "0", "currency": "USD" }, "59": { "charge": "0.50", "start_count": "0", "status": "Partial", "remains": "120", "currency": "USD" }, "60": { "error": "Incorrect order ID" }}5. Cancel Order (action=cancel)
Section titled “5. Cancel Order (action=cancel)”Requests cancellation of an active or pending reaction order.
Cancellation & Refund Rules
Section titled “Cancellation & Refund Rules”- Active Order Cancellation: If the order is in
PendingorIn progressstate, the cancellation request halts future reaction dispatches. - Proportional Refund Calculation:
The calculated balance is automatically and immediately credited back to your user balance.Refund Amount = (remains / requested_quantity) * charge
- Status Outcome:
- If zero reactions were delivered prior to cancellation, the order status transitions to
Canceled. - If some reactions were delivered prior to cancellation, the order status transitions to
Partial.
- If zero reactions were delivered prior to cancellation, the order status transitions to
- Already Concluded: Orders that have already reached
Completed,Canceled, orFailedstatus cannot be cancelled.
Single Cancel Request
Section titled “Single Cancel Request”curl -s -X POST "https://su-persim.uz/api/v2" \ -d "key=supersim_YOUR_API_KEY" \ -d "action=cancel" \ -d "order=58"import requests
resp = requests.post( "https://su-persim.uz/api/v2", data={"key": "supersim_YOUR_API_KEY", "action": "cancel", "order": 58},)print(resp.json())const response = await fetch("https://su-persim.uz/api/v2", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ key: "supersim_YOUR_API_KEY", action: "cancel", order: "58", }),});console.log(await response.json());Single Cancel Response (200 OK)
Section titled “Single Cancel Response (200 OK)”{ "order": 58, "cancel": "ok"}If the order cannot be cancelled (e.g. already finished):
{ "order": 58, "cancel": { "error": "Order #58 cannot be cancelled because it is already completed." }}Complete Integration Example (Python)
Section titled “Complete Integration Example (Python)”A complete Python script demonstrating service listing, balance check, automated order placement, and polling:
import timeimport requests
BASE_URL = "https://su-persim.uz/api/v2"API_KEY = "supersim_YOUR_API_KEY"
def main(): session = requests.Session()
# 1. Check current balance bal_res = session.post(BASE_URL, data={"key": API_KEY, "action": "balance"}).json() print(f"Current Balance: ${bal_res.get('balance')} {bal_res.get('currency')}")
# 2. List available services services = session.post(BASE_URL, data={"key": API_KEY, "action": "services"}).json() service_id = services[0]["service"] print(f"Using Service #{service_id}: {services[0]['name']} (Rate: ${services[0]['rate']}/1k)")
# 3. Submit automated random premium reaction order order_res = session.post(BASE_URL, data={ "key": API_KEY, "action": "add", "service": service_id, "link": "https://t.me/telegram/360", "quantity": 50, }).json()
if "error" in order_res: print(f"Order failed: {order_res['error']}") return
order_id = order_res["order"] print(f"Order placed successfully! Order ID: #{order_id}")
# 4. Poll order status until complete while True: status_res = session.post(BASE_URL, data={ "key": API_KEY, "action": "status", "order": order_id }).json()
status = status_res.get("status") remains = status_res.get("remains") print(f"Order #{order_id} -> Status: {status} | Remains: {remains}")
if status in ("Completed", "Partial", "Canceled", "Failed"): print("Order finished.") break
time.sleep(15)
if __name__ == "__main__": main()