SMMWave API reference

Returns every active service available to the provider account. Numeric values use strings so they can be consumed safely by older panel software.

[
  {
    "service": "1000",
    "name": "Telegram Channel Members",
    "type": "Default",
    "category": "Telegram",
    "rate": "4.250000",
    "min": "10",
    "max": "10000",
    "refill": "0",
    "cancel": "1",
    "dripfeed": "0",
    "desc": "Channel members"
  }
]

Returns the provider balance with six decimal places and its configured currency.

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

Creates a new order and returns a numeric order ID. Save this value: it is used for status checks and cancellation.

curl https://your-domain.example/api/v2 \
  -X POST \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1000" \
  --data-urlencode "link=https://t.me/example" \
  -d "quantity=500"

Create up to 100 orders in one request. Each row is validated and charged independently. A rejected row leaves the other accepted orders in place.

curl https://smm.lat/api/v2 \
  -X POST \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: batch-example-01' \
  -d '{
    "key": "YOUR_API_KEY",
    "action": "add_bulk",
    "orders": [
      {"service": 1000, "link": "https://t.me/example_a", "quantity": 500},
      {"service": 1000, "link": "https://t.me/example_b", "quantity": 0}
    ]
  }'

{
  "data": [
    {"index": 0, "order": 891518433422477},
    {"index": 1, "error": "Incorrect quantity"}
  ],
  "count": 2,
  "succeeded": 1,
  "failed": 1
}

One service, multiple links

Choose this input when all links use the same service and quantity. Each link receives its own order ID and result.

{
  "key": "YOUR_API_KEY",
  "action": "add_bulk",
  "idempotency_key": "links-example-01",
  "service": 1000,
  "quantity": 500,
  "links": ["https://t.me/example_a", "https://t.me/example_b"]
}

Text rows

Send one order per line in lines. URL-encode the field so private invite links keep their + character.

curl https://smm.lat/api/v2 \
  -X POST \
  -d 'key=YOUR_API_KEY' \
  -d 'action=add_bulk' \
  -H 'Idempotency-Key: lines-example-01' \
  --data-urlencode 'lines=1000|https://t.me/example_a|500
1000|https://t.me/+Abcd_1234|250'

Endpoint shortcuts

You can also POST the same body to either URL below. Both use the same authentication, limits and response. The action field is optional on these paths.

• https://smm.lat/api/v2/orders/batch
• https://smm.lat/api/v2/orders/bulk

Retry safely

Send a unique batch key before your first attempt. Repeating the same key with the same rows returns the existing orders without a second charge. Changing the rows, their order or the batch size with that key returns an error.

A row key takes precedence over its generated batch key. Keep row keys attached to the same orders when moving them between batches. Without replay keys, resubmitting can create new orders and charges.

Rows may be processed concurrently. If your balance covers only part of a batch, some rows can be accepted and the rest return Not enough funds. After a connection timeout, retry the same payload with its original keys.

After an explicit rejection, fix the problem and resubmit only the rejected rows with new keys. Keep the order IDs from accepted rows.

Returns the current delivery state for one order. The remaining quantity is calculated from the latest recorded progress.

{
  "charge": "2.125000",
  "start_count": "521",
  "status": "In progress",
  "remains": "250",
  "currency": "USD"
}

Checks up to 100 orders in one request. Supply comma-separated IDs or a JSON array in orders. Each response entry is keyed by the requested order ID.

The action names multistatus and orders are aliases for this batch status check. Requests over 100 IDs are rejected as a whole.

{
  "891518433422477": {
    "charge": "4.250000",
    "start_count": "521",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "999999": {
    "error": "Incorrect order ID"
  }
}

Requests cancellation for one or more pending or running orders. The response is always an array, including single-order requests.

[
  {
    "order": "891518433422477",
    "cancel": 1
  },
  {
    "order": "260731849605218",
    "cancel": {
      "error": "Order cannot be canceled"
    }
  }
]