v1 · REST API

D2 SMM Reseller API

Place orders, check balances, list services, and track delivery — all from your own panel, bot, or website. Compatible with the standard SMM panel API spec used by most reseller scripts.

Base URL
https://your-site.com/api/public/v1

Authentication

Every request requires your API key. Get it from your reseller panel. Pass it as a query string ?key=YOUR_KEY, in the body as key, or as a header X-API-Key.

# Header authentication
curl -H "X-API-Key: YOUR_KEY" "https://your-site.com/api/public/v1/balance"
bash

Endpoints

GET
/balance

Return current wallet balance and currency.

Response
{ "balance": 42.50, "currency": "USD" }
json
GET
/services

List all available services with prices.

Response
{ "services": [{ "service": "uuid", "name": "...", "category": "Instagram", "rate": 0.50, "min": 100, "max": 100000, "type": "Default" }] }
json
POST
/add

Place a new order. Wallet is auto-debited.

Request body
{ "key":"YOUR_KEY", "service":"SERVICE_UUID", "link":"https://...", "quantity": 1000 }
json
Response
{ "order": "uuid", "charge": 0.50, "status": "pending" }
json
GET
/status?order=UUID

Get order status and remaining count.

Response
{ "order":"uuid", "status":"in_progress", "charge":0.50, "quantity":1000, "start_count":1234, "remains":500 }
json

Code Examples

curl -X POST "https://your-site.com/api/public/v1/add" \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_KEY","service":"SERVICE_UUID","link":"https://instagram.com/foo","quantity":1000}'
bash

Error Handling

Errors return JSON { "error": "message" } with a meaningful HTTP status.

CodeMeaning
400Invalid parameters (missing/wrong fields, bad quantity range)
401Missing or invalid API key
402Insufficient wallet balance
404Service or order not found
502Upstream provider rejected the order — auto-refunded
503Provider temporarily offline

Integration Tutorial

  1. Top up your wallet — orders are charged against your balance.
  2. Grab your API key from the Reseller API page.
  3. Connect to your panel — most reseller scripts (SMM Panel, GoldenPanel, NextPanel) ask for: API URL https://your-site.com/api/public/v1/add and your API key. The endpoint matches the Perfect Panel spec.
  4. Sync services by hitting /services and mapping them in your reseller panel.
  5. Place test order with a small quantity to verify everything works end-to-end.