Base URL: https://www.proxyvendor.com/api

Authenticate every request with a personal access token, sent as a Bearer token:

Authorization: Bearer YOUR_TOKEN
Accept: application/json

All responses are JSON in the shape { "remark", "status", "message", "data" }. A request without a valid token returns HTTP 401. Requests are rate limited to 60 per minute per token.

---

GET /balance

Returns your current wallet balance.

curl https://www.proxyvendor.com/api/balance \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Accept: application/json"

{
    "remark": "balance",
    "status": "success",
    "message": { "success": ["Balance retrieved successfully"] },
    "data": { "balance": 25 }
}

---

GET /products

Lists purchasable products with their current stock. Paginated.

curl https://www.proxyvendor.com/api/products \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Accept: application/json"

GET /products/{id}

Returns a single product by id.

---

POST /purchase

Buys a product using your wallet balance. Each unit is deducted from your balance immediately and stock is reserved for you only — there is no way to reserve stock without paying for it.

Parameter	Type	Required	Description
product_id	integer	Yes	The product to buy
qty	integer	No, default 1	Number of units to buy

curl https://www.proxyvendor.com/api/purchase \
    -X POST \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Accept: application/json" \
    -d "product_id=1&qty=1"

{
    "remark": "purchase_complete",
    "status": "success",
    "message": { "success": ["Purchase completed successfully"] },
    "data": {
        "order_id": 12,
        "balance": 15,
        "items": ["1.2.3.4:1000:user:pass"]
    }
}

Possible error remarks:

• out_of_stock — not enough unsold units are left for this product
• insufficient_balance — your wallet balance is lower than the total price

---

GET /orders

Lists your completed purchases. Paginated.

GET /orders/{id}

Returns one of your orders, including the purchased credentials for each item.