Introduction
Everything you need to integrate Sovyx stock delivery into your app, bot, or storefront.
Authentication
Sovyx uses Bearer token authentication. All API requests must include your API key in the Authorization header.
Authorization: Bearer svx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
You can generate and manage API keys from your dashboard under Settings → API Keys. Keys are scoped — a reseller key can only access reseller endpoints.
Rate limits
| Plan | Requests / minute | Requests / day |
|---|---|---|
| Free | 10 | 500 |
| Sovyx Pro | 100 | 10,000 |
| Sovyx Ultra | 1,000 | 100,000 |
| Sovyx Elite | Unlimited | Unlimited |
When you exceed your rate limit the API returns 429 Too Many Requests with a Retry-After header indicating when to retry.
Quick Start
The simplest way to place an order. Everything runs automatically — authenticate, pick stock, and receive keys.
// npm install sovyx import { Sovyx } from 'sovyx'; const client = new Sovyx({ apiKey: process.env.SOVYX_API_KEY }); // 1. Check available stock const stock = await client.stock.list({ category: 'accounts', available: true }); // 2. Place an order const order = await client.orders.create({ product_id: stock[0].id, quantity: 1, deliver_to: 'discord:123456789' }); console.log(order.keys); // ['xxxx-yyyy-zzzz'] console.log(order.status); // 'delivered'
Or use the REST API directly from any language:
curl -X POST https://api.sovyx.cc/v1/orders \ -H "Authorization: Bearer $SOVYX_API_KEY" \ -H "Content-Type: application/json" \ -d '{"product_id":"prod_netflix_4k","quantity":1}'
Error Codes
The API returns standard HTTP status codes. All error responses include a JSON body with error.code and error.message.
| Status | Code | Description |
|---|---|---|
| 400 | bad_request | Missing or invalid parameters |
| 401 | unauthorized | Invalid or missing API key |
| 403 | forbidden | Insufficient plan permissions |
| 404 | not_found | Resource does not exist |
| 409 | out_of_stock | Product temporarily unavailable |
| 429 | rate_limited | Too many requests — back off and retry |
| 500 | internal_error | Server error — contact support |
Webhooks
Webhooks let your server receive real-time notifications when orders are fulfilled, keys are delivered, or stock runs low. Register an HTTPS endpoint and we'll POST events to it.
Event types
| Event | Triggered when |
|---|---|
order.fulfilled | An order is completed and keys are ready |
order.failed | An order could not be completed |
key.delivered | A key is sent to the recipient |
stock.low | A product falls below its alert threshold |
stock.empty | A product goes out of stock |
import { verifySignature } from 'sovyx'; app.post('/webhooks/sovyx', (req, res) => { // Verify the request is from Sovyx const sig = req.headers['svx-signature']; if (!verifySignature(req.body, sig, process.env.SOVYX_WEBHOOK_SECRET)) { return res.status(401).end(); } const { event, data } = req.body; if (event === 'order.fulfilled') { console.log(`Order ${data.id} fulfilled — keys: ${data.keys.join(', ')}`); } res.status(200).end(); });
API Reference
Base URL: https://api.sovyx.cc/v1
All requests and responses use JSON. Timestamps are in ISO 8601 format (UTC).
Create order
Place a new order for one or more units of a product. Keys are delivered automatically on fulfillment.
GET /v1/stock to list available products.
discord:USER_ID, telegram:CHAT_ID, or email:addr@example.com. Defaults to your account's registered Discord.
{
"id": "ord_01HXYZ",
"status": "delivered",
"product_id": "prod_netflix_4k",
"quantity": 1,
"keys": ["email@example.com:password123"],
"delivered_at": "2026-11-22T14:03:12Z",
"created_at": "2026-11-22T14:03:10Z"
}List stock
Returns all available products with their current stock levels and pricing.
accounts, keys, tools.
true, only return products currently in stock.
{
"data": [
{
"id": "prod_netflix_4k",
"name": "Netflix Premium 4K",
"category": "accounts",
"price": 4.99,
"reseller_price": 2.49,
"stock": 143,
"warranty_days": 30
}
],
"total": 42,
"page": 1
}Get balance
Returns your current credit balance and usage for the billing period.
{
"balance": 47.50,
"currency": "USD",
"plan": "pro",
"orders_this_month": 34,
"orders_limit": 50,
"reset_at": "2026-12-01T00:00:00Z"
}