Base URL: https://scamprojecttest.xyz/api/v1. Shared rules (auth, limits, errors, idempotency) are in the overview.
Account
| Method | Path | Scope | Description |
|---|
| GET | /users/me | domains:read | Key & user profile |
| GET | /users/{user_id}/balance | domains:read | Balance |
| GET | /transactions | domains:read | Transactions (paginated, ?user_id=) |
| GET | /referrals | domains:read | Referral stats |
curl https://scamprojecttest.xyz/api/v1/users/me -H "Authorization: Bearer $KEY"
{
"principal": { "key_id": 3, "name": "reseller acme", "role": "reseller", "scopes": ["domains:read","domains:buy"], "user_id": 42 },
"user": { "id": 42, "telegram_id": 666971555, "balance_usd": "12.50", "is_banned": false }
}
Domains
List domains
GET /domains · scope domains:read · paginated · ?user_id= (operator)
Domain card
GET /domains/{domain_id} · scope domains:read. A reseller only sees its own; a foreign id → 404.
Availability check
GET /domains/check?names=a.com,b.net · scope domains:read · up to 50 names
{ "results": [ { "domain": "a.com", "available": false, "price_usd": "17.00", "error": null } ] }
TLD price
GET /domains/price?tld=com · scope domains:read
{ "tld": "com", "price_usd": "17.00", "supported": true }
Bulk check
POST /domains/check:bulk · scope domains:read · body { "names": ["a.com","b.net"] } → bulk envelope.
Buying (money)
Money endpoints require API_MONEY_ENABLED, scope domains:buy, an Idempotency-Key header, and (if enabled) an X-Signature.
Bulk registration
POST /domains/register:bulk · scope domains:buy · money · async → 202
curl -X POST "https://scamprojecttest.xyz/api/v1/domains/register:bulk" \
-H "Authorization: Bearer $KEY" \
-H "Idempotency-Key: reg-2026-06-09-001" \
-H "Content-Type: application/json" \
-d '{"names":["example-store-1.com","example-store-2.net"]}'
{ "batch_id": "checkout:1234", "accepted": 2, "status": "pending" }
?user_id=42. Registration runs in the background; poll GET /batches/checkout:1234. Invalid rows → 422 with per-row detail; nothing is charged. Premium (registry-priced) names are unavailable and never enter registration.
Order status
POST /orders/status:bulk · scope domains:read · body { "ids": [101,102] }.
Batch status
GET /batches/{batch_id} · scope domains:read.
Deposits (money)
Create invoice
POST /deposits · scope deposits:write · money → 201
| Field | Type | Description |
|---|
amount_usd | string/number > 0 | Amount to credit (1–1000) |
provider | string | cryptobot · xrocket · lava · p2328 · lolzteam |
asset | string | (optional) coin for CryptoBot |
user_id | number | Required for an operator key |
{ "provider":"cryptobot","external_id":"inv_123","pay_url":"https://...","amount_usd":"5","pay_usd":"5.15" }
Invoice status
GET /deposits/{provider}/{external_id} · scope domains:read.
Operator endpoints
Operator key only (scope admin:*). Money ones require Idempotency-Key.
| Method | Path | Description |
|---|
| POST | /admin/users/{user_id}/balance | Adjust balance {delta_usd, reason} (money) |
| POST | /admin/users/{user_id}/ban | Ban/unban {banned, reason} |
| POST | /admin/deposits/{transaction_id}/mark-completed | Manually complete a deposit (money) |
| POST | /admin/deposits/{transaction_id}/mark-failed | Mark a deposit failed |
