Telegram growth, delivered at provider speed.

action=servicesService list

Returns every active service with its rate and limits — the same rows your panel imports. A key is optional: with your key the rates shown are exactly the rates you are charged; without one you get the public catalogue.

requestcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=services"

response[{"service":1,"name":"Telegram Post Views ⚡ Fast","type":"Default",
  "category":"Telegram","brand":"Telegram","rate":"0.0022","min":"100","max":"1000000",
  "refill":false,"cancel":false,"dripfeed":false,"desc":"..."}]

action=addPlace an order

Charges the balance immediately and returns the order ID. Dripfeed splits delivery into runs spaced interval minutes apart, each run delivering quantity units. Which extra fields apply depends on the service type — see service types.

request · Defaultcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=add&service=1&link=https://t.me/yourchannel/123&quantity=1000"

request · drip-feedcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=add&service=1&link=https://t.me/yourchannel/123&quantity=500&runs=10&interval=30"

request · Custom Commentscurl -X POST https://tgtorch.com/api/v2 \
  --data-urlencode "key=YOUR_KEY" --data-urlencode "action=add" --data-urlencode "service=7" \
  --data-urlencode "link=https://t.me/yourchannel/123" \
  --data-urlencode $'comments=Great post!\nThanks for sharing\nLove this'

response{"order": 9000123}

Service types

The type field of each service uses the Perfect Panel / JAP names, so a panel that imports our list knows which order form to show. Every service in the catalogue is a Telegram service; types we do not offer (Subscriptions, Web Traffic, SEO) never appear.

action=statusOrder status

One order with order=, or up to 100 with orders= (comma-separated). The multi form returns an object keyed by order ID; an unknown ID gets its own error entry and never fails the whole call. remains counts down as delivery progresses; charge is the final amount after any refund.

requestcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=status&order=9000123"

curl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=status&orders=9000123,9000124,9000125"

response · single{"charge":"0.00300","start_count":"5210","status":"In progress",
 "remains":"400","currency":"USD"}

response · multi{"9000123":{"charge":"0.00300","start_count":"5210","status":"Completed","remains":"0","currency":"USD"},
 "9000124":{"charge":"0.00150","start_count":"0","status":"Pending","remains":"500","currency":"USD"},
 "9000125":{"error":"Incorrect order ID"}}

action=cancelCancel

Requests cancellation for up to 100 orders (orders=, comma-separated; order= works for one), on services marked cancel: true. The reply means the request was accepted — poll status for the outcome. An order that has not been sent to our servers yet is canceled and refunded immediately; otherwise delivery may already be under way and cannot always be stopped — poll status: if it stops, the order ends Canceled or Partial with the undelivered part refunded; if it does not, it runs to the end and anything not delivered is refunded then. You are never charged and refunded for the same units.

requestcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=cancel&orders=9000123,9000124"

response[{"order":9000123,"cancel":1},
 {"order":9000124,"cancel":{"error":"Incorrect order ID"}},
 {"order":9000125,"cancel":{"error":"Cancel is not available"}}]

action=refillRefill · refill_status

For services marked refill: true, on a Completed or Partial order inside the refill window. Returns a refill ID you can poll with refill_status. Both accept one ID (order= / refill=) or up to 100 (orders= / refills=). Refill statuses: Pending, In progress, Completed, Rejected, Error.

requestcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=refill&order=9000123"

curl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=refill&orders=9000123,9000124"

curl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=refill_status&refill=100001"

curl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=refill_status&refills=100001,100002"

responses{"refill":100001}
[{"order":9000123,"refill":100001},{"order":9000124,"refill":{"error":"Refill is not available"}}]
{"status":"Completed"}
[{"refill":100001,"status":"Completed"},{"refill":100002,"status":{"error":"Incorrect refill ID"}}]

action=balanceBalance

requestcurl -X POST https://tgtorch.com/api/v2 \
  -d "key=YOUR_KEY&action=balance"

response{"balance":"100.8429","currency":"USD"}

Order statuses

Final states lock: once an order is Completed, Partial, Canceled or Fail it never changes and is never refunded twice.

Errors

Always HTTP 200 with an error string — exactly what Perfect Panel expects to show your customers. Batch calls never fail as a whole: a bad ID only errors its own entry.

# request / key
{"error":"Incorrect request"}          {"error":"Invalid API key"}
{"error":"Account is suspended"}       {"error":"IP not allowed"}
{"error":"Too many requests"}          # wait a second and retry
{"error":"Internal error"}             # nothing was saved or charged — retry
# add
{"error":"Incorrect service ID"}       {"error":"Incorrect comments"}
# a bad, empty or over-500-character link is not an error: you get an order ID, canceled at once, charge 0
{"error":"The quantity must be between 100 and 1000000"}
{"error":"Dripfeed is not available for this service"}
{"error":"Incorrect dripfeed parameters"}
{"error":"Not enough funds on balance"}
# status / cancel / refill (per item in batch calls)
{"error":"Incorrect order ID"}         {"error":"Incorrect order IDs"}
{"error":"Incorrect order status"}     {"error":"Cancel is not available"}
{"error":"Refill is not available"}    {"error":"Refill already requested"}
{"error":"Refill period expired"}      {"error":"Refill limit reached for this order"}
{"error":"Refill was requested recently, try again later"}
{"error":"Incorrect refill ID"}        {"error":"Incorrect refill IDs"}