SMM Panel API Documentation

What is an SMM panel API?

An SMM panel API lets a program get the service list, place orders and check order status and balance without going through the website. 4SNS PLUS supports the standard SMM panel API v2 format used by many panels and bots, so code you already connected to another panel works right away once you change the URL and key.

API prices and balance are the same as on the website. The rate in the services response equals the price per 1,000 (US dollars) in the price list, and orders placed with add are taken from your balance exactly like web orders and also appear in the order history in your dashboard. Amounts returned from canceled or partial orders go back to the same balance.

Basics

Request example

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

How do I get an API key?

Once your first top up is credited to your balance, you can create an API key from the API key menu in your dashboard. The key is shown only once when you create it, so store it somewhere safe. Creating a new key disables the previous key immediately.

The key is separate from your account token. Put only the API key in your bot or server, never your account token. If you think your key was exposed, simply create a new one on the API key screen.

Service list (services)

Returns every service you can order. rate is the price per 1,000 (USD), and when type is Package it is the price of one package. When type is Custom Comments, you send a list of comments instead of a quantity. category is the platform name plus the group name.

Response example

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Add an order (add)

Places an order and takes the amount from your balance. The amount is the price per 1,000 times the quantity; for Package it is the package price, and for Custom Comments the number of comment lines is the quantity. Orders are available on accounts whose first top up is credited. The order in the response is your order ID.

Response example

{
  "order": 31877
}

Order status (status)

The status of one order. charge is the actual amount paid after refunds (USD, 6 decimals), start_count is the count when the order started, and remains is the quantity not yet delivered.

Response example

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Multiple order status (status, orders)

Checks up to 100 orders at once, with order IDs joined by commas. IDs that do not exist or are not on your account get an error in their place.

Response example

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Request a refill (refill)

For an order of a service with a refill period that ended as Completed or Partial, request within the refill period counted from when it ended. Each order can have one open request, with 24 hours between requests.

Response example

{
  "refill": 512
}

Refill status (refill_status)

The status of one refill request.

Response example

{
  "status": "Completed"
}

Balance (balance)

Your balance (USD, 6 decimals).

Response example

{
  "balance": "84.120000",
  "currency": "USD"
}

Order status values

Refill status values

Error messages

Errors come as JSON with an error field in an HTTP 200 response. In your code, check for the error field first.

{
  "error": "Not enough funds on balance"
}

How do I connect an SMM panel API to a Telegram bot?