API Documentation

Introduction

The StrikeProxy Reseller API gives you programmatic control over the same proxy infrastructure exposed in the dashboard. Read your balance, list the catalog, place orders, pull live credentials for every service you have provisioned, and add bandwidth or extend time without touching the UI.

No SDKs, no proprietary client to install. Drop a curl command into your stack and you are running. Python and Node.js examples are inline on every endpoint below.

Authentication

Every request must include your token in the Authorization header. For POST requests also send Content-Type: application/json. Tokens are issued from the reseller dashboard after your account is approved.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://strikeproxy.net/api/balance

Getting a token

POST your credentials to /api/auth/login. The returned token is valid for 30 days. You can also copy it from the Dashboard → Settings page.

curl -X POST https://strikeproxy.net/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "your_username", "password": "your_password"}'

{
  "token": "a3f8c2e1b4d79f3a8c2e1b4d7...",
  "username": "acme_reseller"
}

Base URL

All endpoints are relative to:

https://strikeproxy.net

Reseller pricing

Resellers get custom per-account price overrides set by the admin team after approval. Without an override you pay the standard retail rate. Call GET /api/reseller/me to see your exact prices, or GET /api/reseller/catalog for a side-by-side of retail vs your effective rate on every plan.

Returns the full plan catalog with your effective reseller prices. If custom price overrides have been set on your account, they appear in reseller_price. Otherwise the default reseller rate applies.

curl -X GET \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/reseller/catalog"

{
  "is_reseller": true,
  "catalog": [
    {
      "plan_key": "residential",
      "name": "Residential",
      "description": "High-quality IPs for web scraping & automation.",
      "pricing_type": "pergb",
      "unit": "GB",
      "min_units": 1,
      "retail_price": 0.75,
      "reseller_price": 0.45
    },
    {
      "plan_key": "unlimited",
      "name": "Unlimited Residential",
      "description": "Unlimited access to residential IPs, billed by duration.",
      "pricing_type": "duration",
      "unit": "duration",
      "min_units": 1,
      "tiers": {
        "hr":    { "duration_hours": 1,   "retail_price": 4,    "reseller_price": 3.5  },
        "day":   { "duration_hours": 24,  "retail_price": 96,   "reseller_price": 84   },
        "week":  { "duration_hours": 168, "retail_price": 672,  "reseller_price": 588  },
        "month": { "duration_hours": 720, "retail_price": 2168, "reseller_price": 1890 }
      }
    }
  ]
}

Returns every active service on your account with live credentials, status, and remaining bandwidth pulled from the upstream network. Use this to hand fresh credentials to downstream customers or to poll for top-up triggers.

curl -X GET \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/reseller/services"

{
  "services": [
    {
      "id": 1042,
      "plan_type": "residential",
      "proxy_username": "proxy_abc123",
      "proxy_password": "mysecretpass",
      "proxy_host": "beta.strikeproxy.net",
      "proxy_port": 8080,
      "proxy_url": "http://proxy_abc123:[email protected]:8080",
      "status": "active",
      "unit": "GB",
      "purchased_gb": 25.00,
      "used_gb": 4.23,
      "max_gb": 25.00,
      "remaining_gb": 20.77
    },
    {
      "id": 1043,
      "plan_type": "unlimited",
      "proxy_username": "proxy_def456",
      "proxy_password": "anotherpass",
      "proxy_host": "unlim.strikeproxy.net",
      "proxy_port": 8080,
      "proxy_url": "http://proxy_def456:[email protected]:8080",
      "status": "active",
      "unit": "hours",
      "purchased_hours": 24,
      "expires_at": "2026-07-30T10:00:00Z",
      "time_remaining": "18h 42m remaining"
    }
  ]
}

Provisions a new proxy service against your balance and returns credentials immediately. Balance-only - no crypto redirect. Designed for resellers automating customer order fulfilment.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "residential", "quantity": 25}' \
  "https://strikeproxy.net/api/reseller/order"

{
  "ok": true,
  "track_id": "res_a8f3c2e1b4d7...",
  "service": {
    "plan_type": "residential",
    "proxy_username": "proxy_abc123",
    "proxy_password": "mysecretpass",
    "proxy_host": "beta.strikeproxy.net",
    "proxy_port": 8080,
    "proxy_url": "http://proxy_abc123:[email protected]:8080",
    "unit": "GB",
    "quantity": 25
  },
  "cost": 11.25,
  "balance_after": 131.25
}

Duration plan example

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "unlimited", "quantity": 1, "tier": "day"}' \
  "https://strikeproxy.net/api/reseller/order"

Returns the list of countries (and optionally states + cities) available for geo-targeting when generating proxy lines. Pass plan to filter to a specific plan type. Add country to drill down to the state/city tree for one country (residential only).

# All countries for residential
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/reseller/proxy/locations?plan=residential"

# State + city tree for a specific country
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/reseller/proxy/locations?plan=residential&country=US"

// Country list (no ?country param)
{
  "plan": "residential",
  "countries": [
    { "name": "United States", "iso2": "us" },
    { "name": "Germany",       "iso2": "de" },
    { "name": "United Kingdom","iso2": "gb" }
  ]
}

// Country detail (?country=US)
{
  "plan": "residential",
  "country": {
    "name": "United States",
    "iso2": "us",
    "states": [
      {
        "name": "California",
        "code": "USCAL21",
        "cities": [
          { "name": "Losangeles", "code": "USLOS1" },
          { "name": "Sanfrancisco", "code": "USSAN1" }
        ]
      }
    ]
  }
}

Turns one of your active services into ready-to-use proxy lines. Supports rotating and sticky sessions, country/state/city geo-targeting, HTTP and SOCKS5, and multiple output formats. Up to 10,000 lines per request. Each sticky line gets its own unique cryptographic session ID.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1042,
    "count": 5,
    "country": "US",
    "state": "CA",
    "protocol": "http",
    "format": "user:pass@host:port",
    "session_type": "sticky",
    "session_minutes": 10
  }' \
  "https://strikeproxy.net/api/reseller/proxy/generate"

{
  "service_id": 1042,
  "plan_type": "residential",
  "count": 5,
  "protocol": "http",
  "format": "user:pass@host:port",
  "host": "beta.strikeproxy.net",
  "port": 8080,
  "session_type": "sticky",
  "session_minutes": 10,
  "proxies": [
    "proxy_abc123-country-us-state-USCAL21-session-strike_a1b2c3d4-time-10:[email protected]:8080",
    "proxy_abc123-country-us-state-USCAL21-session-strike_e5f6g7h8-time-10:[email protected]:8080",
    "proxy_abc123-country-us-state-USCAL21-session-strike_i9j0k1l2-time-10:[email protected]:8080",
    "proxy_abc123-country-us-state-USCAL21-session-strike_m3n4o5p6-time-10:[email protected]:8080",
    "proxy_abc123-country-us-state-USCAL21-session-strike_q7r8s9t0-time-10:[email protected]:8080"
  ]
}

Fast local-database plan list (no live upstream data). Use /api/reseller/services for enriched live results. This endpoint is useful when you only need plan IDs and credentials without the network round-trip.

curl -H "Authorization: Bearer YOUR_TOKEN" "https://strikeproxy.net/api/plans"

Returns your current account balance in dollars. The same value shown on the reseller dashboard wallet card.

curl -X GET \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/balance"

{
  "balance": 142.50,
  "username": "acme_reseller"
}

Returns a flat list of every proxy plan on your account from the local database - fast, no upstream network call. Use /api/users/me when you need live usage stats and remaining bandwidth.

curl -X GET \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/plans"

{
  "plans": [
    {
      "id": 1042,
      "plan_type": "residential",
      "proxy_username": "proxy_abc123",
      "proxy_password": "mysecretpass",
      "quantity": 25600
    }
  ]
}

Provisions a new proxy service. Two payment modes are available:

• balance - deducts from your account balance instantly and provisions the plan immediately. Recommended for resellers automating customer order fulfilment.
• crypto - creates an OxaPay hosted invoice and returns a payment URL. Plan is provisioned once payment confirms on-chain.

Request body

Balance payment - recommended for resellers

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "residential", "quantity": 25, "payment_method": "balance"}' \
  "https://strikeproxy.net/api/plans/create"

{
  "paid": true,
  "track_id": "bal_a8f3c2e1b4...",
  "plan": "residential",
  "proxy_username": "proxy_abc123",
  "balance_after": 119.62
}

Duration plan example (balance)

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "unlimited", "quantity": 1, "tier": "day", "payment_method": "balance"}' \
  "https://strikeproxy.net/api/plans/create"

Crypto payment

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "datacenter", "quantity": 100}' \
  "https://strikeproxy.net/api/plans/create"

{
  "track_id": "plan_c9d2e5f8a1...",
  "payment_url": "https://oxapay.com/pay/..."
}

Returns your full account profile including balance, role, and every active proxy plan enriched with live usage data from the upstream network. Use this to hand fresh credentials to downstream customers or to poll for top-up triggers.

curl -X GET \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/users/me"

{
  "username": "acme_reseller",
  "email": "[email protected]",
  "role": "reseller",
  "balance": 142.50,
  "is_admin": false,
  "plans": [
    {
      "plan_type": "residential",
      "username": "proxy_abc123",
      "password": "mysecretpass",
      "bought": "25.00 GB",
      "proxy_url": "http://proxy_abc123:[email protected]:8080",
      "status": "Active",
      "used_gb": 4.23,
      "max_gb": 25.00,
      "remaining_gb": 20.77
    },
    {
      "plan_type": "unlimited",
      "username": "proxy_def456",
      "password": "anotherpass",
      "bought": "24 hours",
      "proxy_url": "http://proxy_def456:[email protected]:8080",
      "status": "Active",
      "expires": "18h 42m remaining"
    }
  ]
}

Adds extra GB bandwidth to an existing plan. Deducts the cost from your account balance automatically. Takes effect immediately on the upstream network.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"proxy_username": "proxy_abc123", "add_gb": 10}' \
  "https://strikeproxy.net/api/proxy/add-bandwidth"

{
  "ok": true,
  "proxy_username": "proxy_abc123",
  "cost": 4.50,
  "balance_after": 138.00
}

Extends the expiry time on an unlimited plan. Deducts the cost from your account balance automatically.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"proxy_username": "proxy_xyz789", "extend_hours": 24}' \
  "https://strikeproxy.net/api/proxy/extend-time"

{
  "ok": true,
  "proxy_username": "proxy_xyz789",
  "cost": 3.50,
  "balance_after": 118.75
}

Rotates the proxy password on an existing plan. Free operation - no balance deduction. Takes effect immediately on the upstream network and in the local database.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"proxy_username": "proxy_abc123", "new_password": "newsecretpass"}' \
  "https://strikeproxy.net/api/proxy/update-password"

{
  "ok": true,
  "proxy_username": "proxy_abc123"
}

Returns your reseller status, latest application record, and any custom price overrides configured on your account by the admin team.

curl -X GET \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://strikeproxy.net/api/reseller/me"

{
  "username": "acme_reseller",
  "role": "reseller",
  "is_reseller": true,
  "application": {
    "id": "uuid-here",
    "status": "approved",
    "created_at": "2025-01-15T10:23:00Z",
    "decided_at": "2025-01-16T09:00:00Z",
    "business_name": "ACME Proxies"
  },
  "pricing": [
    { "plan_type": "residential", "price_per_unit": 0.45 },
    { "plan_type": "mobile",      "price_per_unit": 1.20 },
    { "plan_type": "datacenter",  "price_per_unit": 0.30 }
  ]
}

Submits a reseller program application for review. Rate limited to 3 submissions per 24 hours. A pending application must be decided before a new one is accepted.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "ACME Proxies",
    "website": "https://acmeproxies.com",
    "expected_monthly_volume_usd": 2000,
    "use_case": "Reselling residential proxies to e-commerce clients.",
    "contact": "@acme on Telegram"
  }' \
  "https://strikeproxy.net/api/reseller/apply"

{
  "success": true,
  "msg": "Application submitted."
}

Generate parameters

Reference for POST /api/reseller/proxy/generate parameters.

protocol

format

session_type

Valid hosts

Order parameters

Valid plan keys for POST /api/plans/create and proxy management endpoints.

For GB plans: quantity = gigabytes to buy. No tier required.
For duration plans: quantity = number of tier units (e.g. quantity: 2, tier: "day" = 2 days).tier is required.

Proxy hosts

Connection URL format:

http://PROXY_USERNAME:PROXY_PASSWORD@HOST:PORT

# Example
http://proxy_abc123:[email protected]:8080

Error responses

Errors return JSON with a single error string and the matching HTTP status code. The most common cases are missing auth (401), bad parameters (400), insufficient balance (400), and rate-limit hits (429).

{ "error": "insufficient_funds" }

Error code reference

Rate limits

The default rate limit is 120 requests per minute per token - generous enough for production use without getting in your way. Purchase creation is additionally limited to 10 requests per 10 minutes per user to prevent runaway spend.

If you need uncapped throughput for production scale, message us on Telegram and we will raise it on your account.

Quick start

Reseller end-to-end - log in, browse catalog, place an order, then generate ready-to-use proxy lines for a customer.

# 1. Log in and save your token
TOKEN=$(curl -s -X POST https://strikeproxy.net/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "your_username", "password": "your_password"}' \
  | jq -r '.token')

# 2. Browse the catalog with your reseller prices
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://strikeproxy.net/api/reseller/catalog" | jq '.catalog[] | select(.plan_key=="residential")'

# 3. Place an order (25 GB residential)
SERVICE=$(curl -s -X POST https://strikeproxy.net/api/reseller/order \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "residential", "quantity": 25}')

SERVICE_ID=$(echo $SERVICE | jq -r '.service.id')
echo "Service ID: $SERVICE_ID"

# 4. Pick a country (optional)
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://strikeproxy.net/api/reseller/proxy/locations?plan=residential" | jq '.countries[:5]'

# 5. Generate 100 sticky US proxy lines for your customer
curl -s -X POST https://strikeproxy.net/api/reseller/proxy/generate \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
    \"service_id\": $SERVICE_ID,
    \"count\": 100,
    \"country\": \"US\",
    \"protocol\": \"http\",
    \"session_type\": \"sticky\",
    \"session_minutes\": 30
  }" | jq '.proxies[]'

Standard user flow - check balance, buy a plan, top up bandwidth.

# Check your balance
curl -H "Authorization: Bearer YOUR_TOKEN" "https://strikeproxy.net/api/balance"

# Buy 25 GB residential from balance
curl -X POST https://strikeproxy.net/api/plans/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "residential", "quantity": 25, "payment_method": "balance"}'

# Top up an existing plan with 10 more GB
curl -X POST https://strikeproxy.net/api/proxy/add-bandwidth \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"proxy_username": "proxy_abc123", "add_gb": 10}'