Customer API

Один ключ: баланс, заказ из архива, статус, отчёт, отмена и пополнение USDT. У каждого метода — готовый запрос на cURL, Python и Node.js и пример ответа.

Куда слать запросы?

Базовый адрес

Все методы живут под одним префиксом. Ответы — JSON, время — ISO 8601 в UTC.

base
BASE_URL = "https://tvyze.com/api/customer/v1"

В примерах ключ берётся из переменной окружения TVYZE_API_KEY.

Заказ через API стартует сам: примерно через минуту, а если в архиве больше 500 аккаунтов — через 10 минут. Пока старт не наступил, статус paused.

Как авторизоваться?

Заголовок Api-Key

Ключ передаётся в заголовке, не в query и не как Bearer. Лимит — 60 запросов в минуту на ключ. Чужой order_id вернёт 403.

header
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"
Ответ · 200
{
  "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"
Ответ · 200
{
  "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"
Ответ · 200 · в работе
{
  "order_id": 12345,
  "status": "in_work",
  "total_accounts": 100,
  "done_accounts": 37,
  "report_url": null
}
Ответ · 200 · готов
{
  "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"
Ответ · 200
{
  "order_id": 12345,
  "cancelled": true,
  "message": "Order cancelled successfully"
}
Как посмотреть свои заказы за период?

Статистика

GET/orders/stats

Только свои заказы. Окно по дате создания, дни в UTC. ordered — сколько аккаунтов заказали, paid — сколько успешно закрыто.

days14 по умолчанию, от 1 до 90
limit100 по умолчанию, от 1 до 1000
offset0 и больше
curl "https://tvyze.com/api/customer/v1/orders/stats?days=14&limit=100&offset=0" \
  -H "Api-Key: $TVYZE_API_KEY"
Ответ · 200
{
  "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
}
Как пополнить баланс по API?

Пополнение USDT

Доступно, если пополнение через API включено для вашего аккаунта, иначе 403 api_deposits_not_allowed. Порядок: создать счёт → перевести USDT → отправить хеш перевода → опрашивать счёт до confirmed.

1. Создать счёт

POST/deposits

networkTRC20 или BEP20, по умолчанию TRC20
amount_usdСумма в USDT: от минимальной (сейчас 5) до 10 000
Idempotency-KeyЗаголовок, обязателен. 8–64 символа: латиница, цифры, _ - : . — новый на каждый счёт, удобно 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}'
Ответ · 201
{
  "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.

Поля счёта одинаковые во всех ответах пополнения:

idНомер счёта
networkСеть: TRC20 или BEP20
addressАдрес для перевода. Берите из ответа для каждого счёта
amount_usdСумма к оплате в USDT — переводите ровно её
statusСтатус счёта, см. шаг 3
expires_atСрок оплаты
created_atКогда создан счёт
tx_hashПринятый хеш перевода или null
confirmationsСколько подтверждений сети набрал перевод
required_confirmationsСколько подтверждений нужно для зачисления: TRC20 — 20, BEP20 — 15
credited_usdСколько зачислено на баланс; заполнено только при confirmed
reject_reasonПочему последний хеш не принят; null, если всё в порядке
rejected_tx_hashХеш, который не прошёл проверку, или null

2. Отправить хеш перевода

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"}'
Ответ · 202
{
  "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.

awaitingЖдём перевод и хеш
verifyingПроверяем транзакцию в сети, до 10 минут
pendingПеревод найден, набираются подтверждения
confirmedЗачислено, сумма в credited_usd
expiredСрок вышел, принятого хеша нет
cancelledСчёт отменён администратором
curl "https://tvyze.com/api/customer/v1/deposits/912" \
  -H "Api-Key: $TVYZE_API_KEY"
Ответ · 200 · pending
{
  "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
}
Ответ · 200 · confirmed
{
  "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. На тот же счёт можно прислать правильный хеш.

Ответ · 200 · хеш не принят
{
  "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"
}
tx_not_foundТранзакции нет в сети 10 минут — проверьте хеш и сеть
tx_failedТранзакция в сети завершилась ошибкой
tx_not_incomingВ транзакции нет перевода USDT на адрес счёта
tx_wrong_amountСумма перевода не равна amount_usd
tx_before_invoiceПеревод отправлен до создания счёта
tx_after_invoiceПеревод отправлен позже expires_at + 15 минут
verify_timeoutСеть долго не отвечала — пришлите хеш ещё раз

Список счетов

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"
Ответ · 200
{
  "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
}

Пополнение целиком

Скрипт создаёт счёт, ждёт хеш перевода, отправляет его и опрашивает счёт до результата.

deposit.py
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:

Ответ · 400
{
  "error": {
    "code": "min_deposit_amount",
    "message": "min_deposit_amount",
    "min_usd": 5.0
  },
  "req_id": "2075f1eafdef43eda737c452c1b9e0d4"
}
bad_request401, в error.message — invalid access key: ключ неверный или выключен
api_deposits_disabled403 — пополнение через API выключено на сервисе
api_deposits_not_allowed403 — пополнение через API не включено для аккаунта
user_inactive403 — аккаунт заблокирован
min_deposit_amount400 — сумма меньше минимальной, минимум в min_usd
network_disabled400 — сеть выключена, доступные в networks
invalid_tx_hash400 — строка не похожа на хеш транзакции
invalid_idempotency_key400 — ключ не 8–64 символа или с недопустимыми символами
amount_busy400 — не удалось выдать счёт, повторите через минуту
deposit_not_found404 — нет такого счёта или он чужой
too_many_open_deposits409 — уже 3 неоплаченных счёта
tx_already_used409 — хеш уже засчитан по другому счёту
tx_in_verification409 — хеш сейчас проверяется по другому счёту, повторите через минуту
deposit_already_bound409 — к счёту уже принят другой хеш
deposit_not_claimable409 — счёт отменён или уже зачислен
deposit_expired409 — прошло больше 15 минут после expires_at
deposit_not_api409 — счёт создан на сайте, хеш отправляйте там
idempotency_key_reused409 — ключ уже использован с другими network или amount_usd
422Нет Api-Key или Idempotency-Key, или тело не по схеме, например amount_usd больше 10 000
rate_limited429 — больше 10 счетов в час, 6 хешей или 120 чтений в минуту
temporarily_unavailable503 — повторите через минуту
Есть готовый клиент?

Python-клиент

Пять функций на requests. На создание заказа таймаут 10 минут — архив может быть большим.

client.py
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.

order.py
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?

Архив

  • Формат .zip или .rar. Вложенные архивы раскрываются.
  • Аккаунт — это файл .session или папка с tdata/key_datas.
  • Если в архиве есть и session, и tdata, берётся tdata.
  • Пустой архив или архив без аккаунтов — 400, заказ не создаётся.
Что значат коды?

Ошибки заказов

401invalid access key — ключ неверный или выключен
422Нет заголовка Api-Key
403api_orders_disabled — ключу не открыт API заказов
403Access denied — заказ принадлежит другому ключу
404Order not found — такого id нет
400No accounts found in archive — в архиве нечего брать
400Insufficient balance — не хватает баланса на заморозку
400order_finished — отмена уже идущей отмены или скрытого заказа
429rate limit exceeded — больше 60 запросов за минуту
503orders_acceptance_paused — приём заказов на паузе

Статусы заказа в поле status:

pausedЖдёт отложенного старта
in_workВ работе
wait_cancelОтмена запрошена, дожимаются уже взятые аккаунты
cancelledОтменён, остаток разморожен
completedЗакрыт, отчёт можно забирать
completed_hideСкрыт повторной отменой