Customer API
Один ключ: баланс, заказ из архива, статус, отчёт, отмена и пополнение USDT. У каждого метода — готовый запрос на cURL, Python и Node.js и пример ответа.
Базовый адрес
Все методы живут под одним префиксом. Ответы — JSON, время — ISO 8601 в UTC.
BASE_URL = "https://tvyze.com/api/customer/v1"
В примерах ключ берётся из переменной окружения TVYZE_API_KEY.
Заказ через API стартует сам: примерно через минуту, а если в архиве больше 500 аккаунтов — через 10 минут. Пока старт не наступил, статус paused.
Заголовок Api-Key
Ключ передаётся в заголовке, не в query и не как Bearer. Лимит — 60 запросов в минуту на ключ. Чужой order_id вернёт 403.
Api-Key: <API_KEY>
Баланс
GET/balance
Баланс владельца ключа — те же суммы, что в кошельке. available_balance_usd можно тратить на заказы, frozen_balance_usd заморожено на открытых заказах, balance_usd — сумма этих двух.
curl "https://tvyze.com/api/customer/v1/balance" \ -H "Api-Key: $TVYZE_API_KEY"
{
"balance_usd": 48.15,
"frozen_balance_usd": 15.75,
"available_balance_usd": 32.4
}Залить архив
POST/orders/create
multipart/form-data, поле файла называется file. Подходят .zip и .rar, до 200 МБ. В ответе total_accounts — сколько аккаунтов реально приняли из архива.
curl -X POST "https://tvyze.com/api/customer/v1/orders/create" \ -H "Api-Key: $TVYZE_API_KEY" \ -F "file=@accounts.zip"
{
"order_id": 12345,
"total_accounts": 100,
"message": "Order created successfully"
}Статус заказа
GET/orders/{order_id}
done_accounts — успешно закрытые аккаунты. report_url появляется, когда отчёт готов (заказ completed, cancelled или completed_hide). Ссылка живёт около часа, потом запросите статус ещё раз.
curl "https://tvyze.com/api/customer/v1/orders/12345" \ -H "Api-Key: $TVYZE_API_KEY"
{
"order_id": 12345,
"status": "in_work",
"total_accounts": 100,
"done_accounts": 37,
"report_url": null
}{
"order_id": 12345,
"status": "completed",
"total_accounts": 100,
"done_accounts": 100,
"report_url": "https://tvyze.com/reports/order-12345.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=9c1e…"
}Отмена
DELETE/orders/{order_id}
Незабранные аккаунты снимаются, заморозка по ним возвращается. Если кто-то уже взял аккаунт в работу, заказ переходит в wait_cancel и дожидается этих попыток — ответ всё равно cancelled: true. Повторный DELETE по уже завершённому заказу его прячет (cancelled: false).
curl -X DELETE "https://tvyze.com/api/customer/v1/orders/12345" \ -H "Api-Key: $TVYZE_API_KEY"
{
"order_id": 12345,
"cancelled": true,
"message": "Order cancelled successfully"
}Статистика
GET/orders/stats
Только свои заказы. Окно по дате создания, дни в UTC. ordered — сколько аккаунтов заказали, paid — сколько успешно закрыто.
curl "https://tvyze.com/api/customer/v1/orders/stats?days=14&limit=100&offset=0" \ -H "Api-Key: $TVYZE_API_KEY"
{
"period_days": 14,
"orders_count": 3,
"ordered": 220,
"paid": 180,
"by_day": [
{ "date": "2026-09-20", "orders": 2, "ordered": 120, "paid": 90 }
],
"orders": [
{
"order_id": 12345,
"created_at": "2026-09-21T18:44:29Z",
"status": "in_work",
"ordered": 100,
"paid": 37
}
],
"limit": 100,
"offset": 0
}Пополнение USDT
Доступно, если пополнение через API включено для вашего аккаунта, иначе 403 api_deposits_not_allowed. Порядок: создать счёт → перевести USDT → отправить хеш перевода → опрашивать счёт до confirmed.
1. Создать счёт
POST/deposits
TRC20 или BEP20, по умолчанию TRC20_ - : . — новый на каждый счёт, удобно UUIDЕсли ответ не дошёл, повторите запрос с тем же Idempotency-Key: вернётся тот же счёт, второй не создастся. Счёт живёт 20 минут.
curl -X POST "https://tvyze.com/api/customer/v1/deposits" \
-H "Api-Key: $TVYZE_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"network": "TRC20", "amount_usd": 100}'{
"id": 912,
"network": "TRC20",
"address": "TQSjiwJXhxgf2EpJags8y9R5bvDm1dSKzh",
"amount_usd": 100,
"status": "awaiting",
"expires_at": "2026-10-29T12:20:00Z",
"created_at": "2026-10-29T12:00:00Z",
"tx_hash": null,
"confirmations": 0,
"required_confirmations": 20,
"credited_usd": null,
"reject_reason": null,
"rejected_tx_hash": null
}Переведите ровно amount_usd USDT в сети network на address до expires_at.
Поля счёта одинаковые во всех ответах пополнения:
TRC20 или BEP20nullconfirmednull, если всё в порядкеnull2. Отправить хеш перевода
POST/deposits/{id}/tx
Хеш берите в кошельке или в обозревателе (Tronscan, BscScan) после отправки перевода. TRC20 — 64 hex-символа, BEP20 — 0x и 64 hex-символа. Ответ 202 и статус verifying: транзакцию проверяем в фоне. Тот же хеш повторно — 200 без изменений.
curl -X POST "https://tvyze.com/api/customer/v1/deposits/912/tx" \
-H "Api-Key: $TVYZE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tx_hash": "8b1f0c6e2d4a97f35e0b8c1d6a2f4e9073c5b1d8e6f2a4c09b7d3e5f1a8c6b24"}'{
"id": 912,
"network": "TRC20",
"address": "TQSjiwJXhxgf2EpJags8y9R5bvDm1dSKzh",
"amount_usd": 100,
"status": "verifying",
"expires_at": "2026-10-29T12:20:00Z",
"created_at": "2026-10-29T12:00:00Z",
"tx_hash": "8b1f0c6e2d4a97f35e0b8c1d6a2f4e9073c5b1d8e6f2a4c09b7d3e5f1a8c6b24",
"confirmations": 0,
"required_confirmations": 20,
"credited_usd": null,
"reject_reason": null,
"rejected_tx_hash": null
}Засчитывается перевод официального USDT на address, ровно на amount_usd, отправленный после created_at и не позже expires_at + 15 минут. Один хеш засчитывается один раз.
3. Дождаться зачисления
GET/deposits/{id}
Опрашивайте счёт раз в 10–15 секунд, пока статус не станет confirmed.
credited_usdcurl "https://tvyze.com/api/customer/v1/deposits/912" \ -H "Api-Key: $TVYZE_API_KEY"
{
"id": 912,
"network": "TRC20",
"address": "TQSjiwJXhxgf2EpJags8y9R5bvDm1dSKzh",
"amount_usd": 100,
"status": "pending",
"expires_at": "2026-10-29T12:20:00Z",
"created_at": "2026-10-29T12:00:00Z",
"tx_hash": "8b1f0c6e2d4a97f35e0b8c1d6a2f4e9073c5b1d8e6f2a4c09b7d3e5f1a8c6b24",
"confirmations": 7,
"required_confirmations": 20,
"credited_usd": null,
"reject_reason": null,
"rejected_tx_hash": null
}{
"id": 912,
"network": "TRC20",
"address": "TQSjiwJXhxgf2EpJags8y9R5bvDm1dSKzh",
"amount_usd": 100,
"status": "confirmed",
"expires_at": "2026-10-29T12:20:00Z",
"created_at": "2026-10-29T12:00:00Z",
"tx_hash": "8b1f0c6e2d4a97f35e0b8c1d6a2f4e9073c5b1d8e6f2a4c09b7d3e5f1a8c6b24",
"confirmations": 23,
"required_confirmations": 20,
"credited_usd": 100,
"reject_reason": null,
"rejected_tx_hash": null
}Если хеш не прошёл проверку, счёт возвращается в awaiting (или expired, если срок вышел), tx_hash снова null, а причина и сам хеш — в reject_reason и rejected_tx_hash. На тот же счёт можно прислать правильный хеш.
{
"id": 912,
"network": "TRC20",
"address": "TQSjiwJXhxgf2EpJags8y9R5bvDm1dSKzh",
"amount_usd": 100,
"status": "awaiting",
"expires_at": "2026-10-29T12:20:00Z",
"created_at": "2026-10-29T12:00:00Z",
"tx_hash": null,
"confirmations": 0,
"required_confirmations": 20,
"credited_usd": null,
"reject_reason": "tx_wrong_amount",
"rejected_tx_hash": "8b1f0c6e2d4a97f35e0b8c1d6a2f4e9073c5b1d8e6f2a4c09b7d3e5f1a8c6b24"
}amount_usdexpires_at + 15 минутСписок счетов
GET/deposits
Свои счета, новые сверху. status — фильтр по статусу, limit от 1 до 100 (по умолчанию 50), offset от 0.
curl "https://tvyze.com/api/customer/v1/deposits?status=confirmed&limit=50&offset=0" \ -H "Api-Key: $TVYZE_API_KEY"
{
"items": [
{
"id": 912,
"network": "TRC20",
"address": "TQSjiwJXhxgf2EpJags8y9R5bvDm1dSKzh",
"amount_usd": 100,
"status": "confirmed",
"expires_at": "2026-10-29T12:20:00Z",
"created_at": "2026-10-29T12:00:00Z",
"tx_hash": "8b1f0c6e2d4a97f35e0b8c1d6a2f4e9073c5b1d8e6f2a4c09b7d3e5f1a8c6b24",
"confirmations": 23,
"required_confirmations": 20,
"credited_usd": 100,
"reject_reason": null,
"rejected_tx_hash": null
}
],
"total": 1,
"limit": 50,
"offset": 0
}Пополнение целиком
Скрипт создаёт счёт, ждёт хеш перевода, отправляет его и опрашивает счёт до результата.
import os
import time
import uuid
import requests
BASE_URL = "https://tvyze.com/api/customer/v1"
HEADERS = {"Api-Key": os.environ["TVYZE_API_KEY"]}
def call(method: str, path: str, **kwargs) -> dict:
headers = {**HEADERS, **kwargs.pop("headers", {})}
r = requests.request(method, f"{BASE_URL}{path}", headers=headers, timeout=30, **kwargs)
if r.status_code >= 400:
raise RuntimeError(f"{r.status_code} {r.text}")
return r.json()
idempotency_key = str(uuid.uuid4())
invoice = call(
"POST",
"/deposits",
headers={"Idempotency-Key": idempotency_key},
json={"network": "TRC20", "amount_usd": 100},
)
print(f"Переведите {invoice['amount_usd']} USDT ({invoice['network']}) на {invoice['address']} до {invoice['expires_at']}")
tx_hash = input("Хеш перевода: ").strip()
call("POST", f"/deposits/{invoice['id']}/tx", json={"tx_hash": tx_hash})
while True:
d = call("GET", f"/deposits/{invoice['id']}")
if d["status"] == "confirmed":
print("Зачислено, $", d["credited_usd"])
break
if d["reject_reason"]:
print("Хеш не принят:", d["reject_reason"], d["rejected_tx_hash"])
break
if d["status"] in ("expired", "cancelled"):
print("Счёт закрыт:", d["status"])
break
print(d["status"], d["confirmations"], "/", d["required_confirmations"])
time.sleep(15)Ошибки пополнения приходят в одном формате, код — в error.code:
{
"error": {
"code": "min_deposit_amount",
"message": "min_deposit_amount",
"min_usd": 5.0
},
"req_id": "2075f1eafdef43eda737c452c1b9e0d4"
}error.message — invalid access key: ключ неверный или выключенmin_usdnetworksexpires_atnetwork или amount_usdApi-Key или Idempotency-Key, или тело не по схеме, например amount_usd больше 10 000Python-клиент
Пять функций на requests. На создание заказа таймаут 10 минут — архив может быть большим.
import os
import requests
BASE_URL = "https://tvyze.com/api/customer/v1"
HEADERS = {"Api-Key": os.environ["TVYZE_API_KEY"]}
def get_balance() -> dict:
r = requests.get(f"{BASE_URL}/balance", headers=HEADERS, timeout=30)
r.raise_for_status()
return r.json()
def create_order(archive_path: str) -> dict:
with open(archive_path, "rb") as f:
r = requests.post(
f"{BASE_URL}/orders/create",
headers=HEADERS,
files={"file": (os.path.basename(archive_path), f, "application/octet-stream")},
timeout=600,
)
r.raise_for_status()
return r.json()
def get_order(order_id: int) -> dict:
r = requests.get(f"{BASE_URL}/orders/{order_id}", headers=HEADERS, timeout=30)
r.raise_for_status()
return r.json()
def cancel_order(order_id: int) -> dict:
r = requests.delete(f"{BASE_URL}/orders/{order_id}", headers=HEADERS, timeout=60)
r.raise_for_status()
return r.json()
def orders_stats(days: int = 14) -> dict:
r = requests.get(
f"{BASE_URL}/orders/stats",
headers=HEADERS,
params={"days": days, "limit": 100, "offset": 0},
timeout=30,
)
r.raise_for_status()
return r.json()Заказ целиком
Залить архив, опрашивать статус раз в минуту и скачать отчёт, когда появится report_url.
import os
import time
import requests
BASE_URL = "https://tvyze.com/api/customer/v1"
HEADERS = {"Api-Key": os.environ["TVYZE_API_KEY"]}
with open("accounts.zip", "rb") as f:
r = requests.post(
f"{BASE_URL}/orders/create",
headers=HEADERS,
files={"file": ("accounts.zip", f, "application/zip")},
timeout=600,
)
r.raise_for_status()
order_id = r.json()["order_id"]
while True:
order = requests.get(f"{BASE_URL}/orders/{order_id}", headers=HEADERS, timeout=30).json()
print(order["status"], order["done_accounts"], "/", order["total_accounts"])
if order["report_url"]:
break
time.sleep(60)
report = requests.get(order["report_url"], timeout=300)
report.raise_for_status()
with open(f"report-{order_id}.zip", "wb") as out:
out.write(report.content)Архив
- Формат
.zipили.rar. Вложенные архивы раскрываются. - Аккаунт — это файл
.sessionили папка сtdata/key_datas. - Если в архиве есть и session, и tdata, берётся tdata.
- Пустой архив или архив без аккаунтов — 400, заказ не создаётся.
Ошибки заказов
invalid access key — ключ неверный или выключенApi-Keyapi_orders_disabled — ключу не открыт API заказовAccess denied — заказ принадлежит другому ключуOrder not found — такого id нетNo accounts found in archive — в архиве нечего братьInsufficient balance — не хватает баланса на заморозкуorder_finished — отмена уже идущей отмены или скрытого заказаrate limit exceeded — больше 60 запросов за минутуorders_acceptance_paused — приём заказов на паузеСтатусы заказа в поле status: