# MysticSMM — Full Context Reference (llms-full.txt)

> MysticSMM is a premium SMM reseller panel and REST API. Automated social media growth for Instagram, TikTok, YouTube, Twitter/X, Facebook, Discord (OAuth2 real members), and Robux (Roblox). Pay-as-you-go, crypto payments, VIP discounts, 10% referral commissions.

**Last Updated:** May 2026  
**API Endpoint:** `POST https://mysticsmm.com/api/v2`  
**Support:** support@mysticsmm.com  
**Company:** Mystic Lilium LLC, Wilmington, Delaware, USA

---

## Platform Overview

MysticSMM operates on a pay-as-you-go model — no monthly subscriptions. Users deposit funds (minimum $1) via cryptocurrency (Bitcoin, Ethereum, USDT, Litecoin, and 100+ coins via NowPayments) and spend their balance on services. The platform targets:

- **Influencers** — growing personal accounts organically
- **Social media agencies** — managing multiple client accounts at scale
- **Resellers** — white-labeling MysticSMM services via the API into their own panels
- **Developers** — automating social media workflows via REST API v2

### Key Differentiators

1. **Discord Real Members (flagship):** Users join via OAuth2 — they authenticate with their real Discord account. This means members appear organic, are not bots, and re-join automatically when the server is nuked or migrated to a new invite link.

2. **Drip-feed campaigns:** Instead of delivering all ordered units at once, drip-feed distributes delivery over time. Example: order 10,000 Instagram followers delivered at 500/day for 20 days to look organic.

3. **Auto-subscriptions:** Monitor an Instagram or TikTok account and automatically place a new order every time a new post is detected — hands-free growth automation.

4. **VIP tier discounts:** Automatically applied based on cumulative spending. Higher tiers receive larger percentage discounts on all services.

5. **Referral program:** 10% of every order placed by a referred user is credited to the referrer's wallet permanently — no expiration, no cap.

---

## Services Catalog

### Social Media Platforms Supported
- Instagram: Followers, likes, video views, story views, comments, saves, shares, profile visits
- TikTok: Followers, likes, video views, comments, shares
- YouTube: Subscribers, views, watch hours, likes, comments
- Twitter/X: Followers, likes, retweets, impressions
- Facebook: Page likes, followers, post likes, video views
- Spotify: Streams, followers, playlist plays
- Telegram: Channel members, post views

### Specialty Services
- **Discord Real Members:** OAuth2-verified real accounts. High retention, auto-rejoin on server migration. Configurable delivery speed.
- [YouTube Growth](https://mysticsmm.com/buy-youtube-views): Views, watch hours, subscribers, likes for YouTube
- [Robux Store](https://mysticsmm.com/dashboard/robux-store): Instant Robux delivery via Gamepass or VIP Server at $7.00 per 1,000 Robux

## Guides & Blog

- [Discord Real Members Guide](https://mysticsmm.com/blog/discord-real-members-guide): Deep dive into OAuth2-verified members and how to protect servers from being nuked.
- [Robux Store Guide](https://mysticsmm.com/blog/how-robux-store-works): How to safely purchase and receive Roblox Robux via VIP Servers/Gamepass.
- [Virtual Numbers Guide](https://mysticsmm.com/blog/virtual-numbers-sandbox-guide): Sandbox usage for bypassing OTP testing and debugging flows.

## API Documentation

- **SMS/OTP Activations:** Virtual phone numbers for 200+ online services (WhatsApp, Telegram, Google, Instagram, etc.) in 50+ countries. Powered by HeroSMS. Pricing in USD with 40% platform margin over provider cost.

### Service Properties
Every service in the catalog has these fields:
- `service` (int): Unique service ID for API ordering
- `name` (string): Descriptive name including speed, retention, and guarantee notes
- `category` (string): Platform and type grouping
- `rate` (float): Price per 1,000 units in USD
- `min` (int): Minimum order quantity
- `max` (int): Maximum order quantity
- `refill` (bool): Whether automatic drop refills are available
- `cancel` (bool): Whether mid-delivery cancellation is supported
- `dripfeed` (bool): Whether drip-feed scheduling is available

---

## REST API v2 — Complete Reference

**Endpoint:** `POST https://mysticsmm.com/api/v2`  
**Content-Type:** `application/json`  
**Rate Limit:** 1 request per second per API key (HTTP 429 on violation)  
**Authentication:** API key in request body (`"key"` field)

### Action: services — List Service Catalog

**Request:**
```json
{
  "key": "YOUR_API_KEY",
  "action": "services"
}
```

**Response (array):**
```json
[
  {
    "service": 101,
    "name": "Instagram Followers - Premium High-Retention [30 Days Refill]",
    "category": "Instagram - Followers",
    "rate": 1.45,
    "min": 100,
    "max": 50000,
    "refill": true,
    "cancel": false,
    "dripfeed": false,
    "currency": "USD"
  }
]
```

### Action: add — Place Order

**Request:**
```json
{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 101,
  "link": "https://instagram.com/username",
  "quantity": 2500
}
```

**Success Response (HTTP 201):**
```json
{ "order": 987654 }
```

**Order Processing Flow:**
1. Wallet balance is checked atomically with `SELECT FOR UPDATE` (race-condition safe)
2. Price = `(rate / 1000) * quantity`
3. If referred user: 10% commission auto-credited to referrer's wallet
4. If provider fails: automatic rollback, full refund to wallet

### Action: status — Check Order Status

**Request:**
```json
{
  "key": "YOUR_API_KEY",
  "action": "status",
  "order": 987654
}
```

**Response:**
```json
{
  "charge": 3.625,
  "status": "COMPLETED",
  "currency": "USD"
}
```

**Status Values:**
- `PENDING` — Queued, awaiting processing
- `IN_PROGRESS` — Delivery active
- `PROCESSING` — Upstream verification
- `COMPLETED` — All units delivered
- `PARTIAL` — Partial delivery; undelivered portion auto-refunded to wallet
- `CANCELLED` — Cancelled; full refund issued

### Action: balance — Check Wallet Balance

**Request:**
```json
{
  "key": "YOUR_API_KEY",
  "action": "balance"
}
```

**Response:**
```json
{
  "balance": "854.3750",
  "currency": "USD"
}
```

---

## Error Reference

| HTTP Status | JSON Error Field | Cause |
|-------------|-----------------|-------|
| 400 | `"Quantity must be a valid integer between..."` | Out of min/max bounds |
| 400 | `"Insufficient balance in wallet."` | Not enough funds |
| 401 | `"Invalid API key"` | Wrong or revoked API key |
| 403 | `"Wallet not found or is inactive"` | Account locked |
| 429 | `"Too many requests. Please slow down."` | Rate limit exceeded (1 req/sec) |
| 500 | `"Service not found or unauthorized"` | Invalid service ID |
| 502 | `"Provider network failure. Refund has..."` | Upstream failure; wallet auto-refunded |

---

## Integration Code Examples

### Node.js / TypeScript
```typescript
const API_URL = 'https://mysticsmm.com/api/v2';

export class MysticSMMClient {
  constructor(private apiKey: string) {}

  private async request<T>(action: string, body: Record<string, any> = {}): Promise<T> {
    const response = await fetch(API_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ key: this.apiKey, action, ...body }),
    });
    const data = await response.json();
    if (!response.ok) throw new Error(data.error || `API Error ${response.status}`);
    return data as T;
  }

  getServices() { return this.request<any[]>('services'); }
  placeOrder(service: number, link: string, quantity: number) {
    return this.request<{ order: number }>('add', { service, link, quantity });
  }
  getOrderStatus(orderId: number) { return this.request<any>('status', { order: orderId }); }
  getBalance() { return this.request<{ balance: string; currency: string }>('balance'); }
}
```

### Python 3
```python
import requests

class MysticSMMClient:
    API_URL = "https://mysticsmm.com/api/v2"

    def __init__(self, api_key: str):
        self.api_key = api_key

    def _request(self, action: str, **kwargs):
        payload = {"key": self.api_key, "action": action, **kwargs}
        r = requests.post(self.API_URL, json=payload)
        r.raise_for_status()
        return r.json()

    def get_services(self): return self._request("services")
    def place_order(self, service: int, link: str, quantity: int):
        return self._request("add", service=service, link=link, quantity=quantity)
    def get_status(self, order_id: int): return self._request("status", order=order_id)
    def get_balance(self): return self._request("balance")
```

### PHP
```php
<?php
class MysticSMMClient {
    private $apiUrl = 'https://mysticsmm.com/api/v2';
    private $apiKey;

    public function __construct($apiKey) { $this->apiKey = $apiKey; }

    private function request($action, $params = []) {
        $payload = array_merge(['key' => $this->apiKey, 'action' => $action], $params);
        $ch = curl_init($this->apiUrl);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
            CURLOPT_POSTFIELDS => json_encode($payload),
        ]);
        $response = json_decode(curl_exec($ch), true);
        curl_close($ch);
        return $response;
    }

    public function getServices() { return $this->request('services'); }
    public function placeOrder($serviceId, $link, $quantity) {
        return $this->request('add', ['service'=>(int)$serviceId,'link'=>$link,'quantity'=>(int)$quantity]);
    }
    public function getStatus($orderId) { return $this->request('status', ['order'=>(int)$orderId]); }
    public function getBalance() { return $this->request('balance'); }
}
```

### cURL
```bash
# Check balance
curl -X POST https://mysticsmm.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"balance"}'

# List services
curl -X POST https://mysticsmm.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"services"}'

# Place order
curl -X POST https://mysticsmm.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"add","service":101,"link":"https://instagram.com/username","quantity":1000}'

# Check order status
curl -X POST https://mysticsmm.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"status","order":987654}'
```

---

## Integration Best Practices

1. **Cache the service catalog** — Fetch once every 6–12 hours. Cache in Redis or a local DB. Never request it on each page load.
2. **Rate limit compliance** — Space requests at minimum 1.1 seconds apart. Implement exponential backoff on HTTP 429.
3. **Validate locally first** — Check `min`/`max` against user input before calling the API to reduce overhead.
4. **Handle PARTIAL status** — Always check for `PARTIAL` status and sync your customer's balance with the auto-refund.
5. **Never expose API keys** — Run a server-side proxy. Never include API keys in frontend JavaScript or mobile apps.
6. **Use idempotent retries** — On network timeout (not HTTP 4xx/5xx), retry with the same payload. Check order status before retrying to avoid duplicates.

---

## Business Model & Pricing

- **Wallet system:** Pre-paid balance in USD. Deposits via cryptocurrency only.
- **Minimum deposit:** $1.00
- **Service pricing:** Per 1,000 units in USD. Rates shown in the services catalog.
- **VIP discounts:** Tiered discounts (5%–25%) applied automatically based on cumulative spending. Managed by platform admin.
- **Referral:** 10% of every referred user's order credited to referrer permanently.
- **Robux rate:** $7.00 per 1,000 Robux (Gamepass or VIP Server delivery).
- **SMS activations:** Dynamic pricing = provider cost × 1.4 (40% platform margin).

---

## Platform Policies Summary

### Refund Policy
- Wallet deposits: **non-refundable**
- Orders: automatic partial/full credit refunds for failed or partial deliveries
- Chargebacks: result in **permanent account ban**

### Prohibited Actions
- Chargebacks or payment disputes
- API abuse (automated scraping beyond rate limits)
- Multiple accounts per user
- Reselling without disclosing platform origin (white-label is allowed)

### SLA
- 99.9% platform uptime
- >90% of orders begin delivery within 30 minutes
- Support response: within 24 hours via ticket system

### Data & Privacy
- Passwords hashed with bcrypt
- No data sold to third parties
- GDPR-compliant data deletion upon request
- Cookies: essential + optional analytics (Microsoft Clarity)

---

## Contact & Support

- **Support tickets:** Available inside the dashboard 24/7
- **Email:** support@mysticsmm.com
- **Admin:** admin@mysticsmm.com
- **Company:** Mystic Lilium LLC, Wilmington, Delaware, United States
- **Website:** https://mysticsmm.com
- **Sign up:** https://mysticsmm.com/sign-up (free, no credit card required)