Skip to content

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).


  • 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 Request and 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.

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)

The SMM API v2 router supports five core actions:

  1. services — Retrieve available reaction services, pricing rates, and quantity limits.
  2. balance — Check your real-time wallet balance in USD.
  3. add — Place a reaction order on a Telegram post.
  4. status — Query single or batch order progress and remaining counts.
  5. cancel — Cancel an active order and trigger automatic proportional refunds.

Returns all currently enabled reaction services.

Parameter Type Required Description
key string Yes Your Supersim API key (supersim_YOUR_API_KEY).
action string Yes Must be services.
Terminal window
curl -s -X POST "https://su-persim.uz/api/v2" \
-d "key=supersim_YOUR_API_KEY" \
-d "action=services"
[
{
"service": 1,
"name": "Telegram Random Premium Reactions",
"type": "Default",
"rate": "2.00",
"min": "10",
"max": "10000"
}
]

Returns your user balance in USD.

Parameter Type Required Description
key string Yes Your Supersim API key.
action string Yes Must be balance.
Terminal window
curl -s -X POST "https://su-persim.uz/api/v2" \
-d "key=supersim_YOUR_API_KEY" \
-d "action=balance"
{
"balance": "45.50",
"currency": "USD"
}

Submits an order to deliver reactions to a specific Telegram post.

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.

You do not need to provide reaction emoji in your request. When an order is placed:

  1. Pre-flight Scan: The system inspects the target channel and the exact post link.
  2. Custom Emoji Discovery: Usable Telegram Premium custom emoji already present on that post are automatically indexed into the order’s verified candidate pool.
  3. Random Dispatch: Active worker sessions shuffle the pool and deliver reactions randomly and evenly across the verified custom emoji.
  4. 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.
Terminal window
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"
{
"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.

Track the delivery status and remaining count of one or multiple orders.

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.
Terminal window
curl -s -X POST "https://su-persim.uz/api/v2" \
-d "key=supersim_YOUR_API_KEY" \
-d "action=status" \
-d "order=58"
{
"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.


To query multiple orders in a single HTTP request, pass comma-separated order IDs using the orders parameter.

Terminal window
curl -s -X POST "https://su-persim.uz/api/v2" \
-d "key=supersim_YOUR_API_KEY" \
-d "action=status" \
-d "orders=58,59,60"
{
"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"
}
}

Requests cancellation of an active or pending reaction order.

  1. Active Order Cancellation: If the order is in Pending or In progress state, the cancellation request halts future reaction dispatches.
  2. Proportional Refund Calculation:
    Refund Amount = (remains / requested_quantity) * charge
    The calculated balance is automatically and immediately credited back to your user balance.
  3. 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.
  4. Already Concluded: Orders that have already reached Completed, Canceled, or Failed status cannot be cancelled.
Terminal window
curl -s -X POST "https://su-persim.uz/api/v2" \
-d "key=supersim_YOUR_API_KEY" \
-d "action=cancel" \
-d "order=58"
{
"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."
}
}

A complete Python script demonstrating service listing, balance check, automated order placement, and polling:

import time
import 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()