Rogue Socials API

Overview

The API is a small REST interface. All endpoints live under https://roguesocials.com/api/v1, accept and return JSON, and require an API key. Successful responses are wrapped in a data field; errors return { "error": "..." } with an appropriate HTTP status.

Authentication

Generate a key from Settings → API Access. The full secret is shown once — store it safely. Send it as a Bearer token on every request (or use the X-API-Key header):

Authorization: Bearer rogue_xxxxxxxxxxxxxxxxxxxxxxxx

Keys are tied to your account and wallet. Revoke a key anytime from the same page — revoked keys stop working immediately.

Pricing & billing

There is no subscription or access fee. You pay per order, deducted from your Rogue wallet balance in NGN. Top up your wallet from the dashboard (card, bank transfer, or crypto).

Each service has a rate per 1,000 units. Your reseller rate is the supplier cost plus a fixed markup % set by Rogue — so it is always profitable for both sides. Your effective charge is:

charge = rate_per_1000 × (quantity / 1000)

rate_per_1000         = your reseller rate (supplier cost + markup%)
website_rate_per_1000 = the public website price (for reference)

The rate and the active markup_percent are returned by the /services endpoint, so you can always add your own margin on top when reselling.

List services

curl https://roguesocials.com/api/v1/services \
  -H "Authorization: Bearer rogue_xxx"

Response

{
  "data": [
    {
      "service": 123,
      "name": "Instagram Followers — Premium",
      "category": "Instagram",
      "type": "Default",
      "min": "10",
      "max": "100000",
      "refill": true,
      "cancel": false,
      "currency": "NGN",
      "rate_per_1000": 1300.00,
      "website_rate_per_1000": 1800.00,
      "markup_percent": 30
    }
  ],
  "count": 1
}

Place an order

curl -X POST https://roguesocials.com/api/v1/orders \
  -H "Authorization: Bearer rogue_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "service": 123,
    "link": "https://instagram.com/yourhandle",
    "quantity": 1000
  }'

Response

{
  "data": {
    "id": "b1f3...",
    "external_order_id": 884512,
    "charge": "1300.00",
    "currency": "NGN",
    "markup_percent": 30,
    "status": "processing"
  }
}

Order status

curl https://roguesocials.com/api/v1/orders/b1f3... \
  -H "Authorization: Bearer rogue_xxx"

Response

{
  "data": {
    "id": "b1f3...",
    "service": 123,
    "service_name": "Instagram Followers — Premium",
    "link": "https://instagram.com/yourhandle",
    "quantity": 1000,
    "charge": "1300.00",
    "currency": "NGN",
    "status": "completed",
    "external_status": "Completed",
    "start_count": "5120",
    "remains": "0"
  }
}

Balance

curl https://roguesocials.com/api/v1/balance \
  -H "Authorization: Bearer rogue_xxx"

{ "data": { "balance": "15400.00", "currency": "NGN" } }

Errors

Need help? Reach us on Telegram.