Валюты, сети и балансы

Какие валюты и сети поддерживает ваш инстанс — определяется его настройками. Не хардкодьте этот список: читайте его через API. Все три эндпоинта ниже — read-only, требуют подписи и тела не имеют (GET).

Валюта в запросах депозитов и выплат указывается полем assetCode — это поле code из каталога активов. Сеть определяется самим assetCode: USDT_TRC20, USDT_ERC20, USDT_TON и т. д. — это разные активы в разных сетях.

Базовый адрес в примерах — https://wallet.your-exchange.com, идентификатор ключа — pk_live_a1b2c3d4. Схема подписи для GET — Аутентификация (тело пустое, сообщение для подписи = "<timestamp>.").

Активы

GET /v1/public/assets — список активных валют, доступных для депозитов и выплат. Возвращает только публичные поля; внутренние идентификаторы и адреса системных кошельков не отдаются.

TS=$(date +%s)
SIG=$(printf '%s.' "$TS" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | sed 's/^.* //')
curl "https://wallet.your-exchange.com/v1/public/assets" \
  -H "X-Api-Id: pk_live_a1b2c3d4" -H "X-Timestamp: $TS" -H "X-Signature: $SIG"

const res = await fetch(`${BASE_URL}/v1/public/assets`, {
  headers: signedHeaders(null), // GET -> тело пустое
});
const { ok, data } = await res.json();
// data — массив активов; используйте data[i].code как assetCode в запросах

200 OK

{
  "ok": true,
  "data": [
    {
      "code": "USDT_TRC20",
      "symbol": "USDT",
      "displayName": "Tether USD (TRC-20)",
      "network": "TRON",
      "tokenStandard": "TRC20",
      "decimals": 6,
      "depositEnabled": true,
      "payoutEnabled": true,
      "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "minDeposit": "1",
      "minPayout": "1"
    },
    {
      "code": "TRX",
      "symbol": "TRX",
      "displayName": "TRON",
      "network": "TRON",
      "tokenStandard": null,
      "decimals": 6,
      "depositEnabled": true,
      "payoutEnabled": true,
      "contractAddress": null,
      "minDeposit": "1",
      "minPayout": "1"
    }
  ]
}

Поля актива

string

Код актива. Используйте его как assetCode при создании депозита или выплаты (например USDT_TRC20, TRX).

string

Тикер валюты (например USDT).

string

Человекочитаемое название (например Tether USD (TRC-20)).

string

Код сети актива (например TRON). Сопоставляется с code из списка сетей.

string | null

Стандарт токена: TRC20, ERC20, BEP20, JETTON и т. п. null — для нативной монеты сети.

number

Число десятичных знаков актива. Суммы с большим числом знаков после запятой будут отвергнуты с кодом AMOUNT_TOO_MANY_DECIMALS.

boolean

Доступны ли депозиты в этом активе.

boolean

Доступны ли выплаты в этом активе.

string | null

Адрес контракта токена (публичная on-chain информация). null — для нативной монеты.

string

Минимальная сумма депозита (строка). Меньшая сумма даст AMOUNT_BELOW_MINIMUM.

string

Минимальная сумма выплаты (строка). Меньшая сумма даст AMOUNT_BELOW_MINIMUM.

Проверяйте depositEnabled / payoutEnabled перед операцией: даже активный актив может быть временно закрыт на одну из сторон.

Сети

GET /v1/public/networks — включённые сети с метаданными. В список попадают только сети, у которых есть хотя бы один активный актив и которые включены в настройках инстанса.

TS=$(date +%s)
SIG=$(printf '%s.' "$TS" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | sed 's/^.* //')
curl "https://wallet.your-exchange.com/v1/public/networks" \
  -H "X-Api-Id: pk_live_a1b2c3d4" -H "X-Timestamp: $TS" -H "X-Signature: $SIG"

const res = await fetch(`${BASE_URL}/v1/public/networks`, {
  headers: signedHeaders(null),
});
const { data } = await res.json(); // массив сетей, отсортирован по code

200 OK

{
  "ok": true,
  "data": [
    {
      "code": "TON",
      "displayName": "Gram",
      "archetype": "memo_based",
      "nativeSymbol": "GRAM",
      "enabled": true,
      "defaultConfirmations": 1
    },
    {
      "code": "TRON",
      "displayName": "TRON",
      "archetype": "account_based",
      "nativeSymbol": "TRX",
      "enabled": true,
      "defaultConfirmations": 19
    }
  ]
}

Поля сети

string

Код сети (например TRON, TON). Совпадает с полем network в каталоге активов.

string

Человекочитаемое название сети (например TRON, Gram).

string

Архетип сети: account_based, utxo или memo_based. Определяет модель адресации.

string

Тикер нативной монеты сети (например TRX, GRAM). В сети TON нативная монета — GRAM (ребрендинг Toncoin), сам код сети остаётся TON.

boolean

Включена ли сеть и доступна ли для операций.

number

Число подтверждений по умолчанию, после которых депозит считается финализированным.

Балансы

GET /v1/public/balances — агрегированные доступные средства hot-кошельков по каждому активу. Это то, чем можно оплачивать выплаты.

TS=$(date +%s)
SIG=$(printf '%s.' "$TS" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | sed 's/^.* //')
curl "https://wallet.your-exchange.com/v1/public/balances" \
  -H "X-Api-Id: pk_live_a1b2c3d4" -H "X-Timestamp: $TS" -H "X-Signature: $SIG"

const res = await fetch(`${BASE_URL}/v1/public/balances`, {
  headers: signedHeaders(null),
});
const { data } = await res.json(); // массив { assetCode, symbol, network, available, updatedAt }

200 OK

{
  "ok": true,
  "data": [
    {
      "assetCode": "USDT_TRC20",
      "symbol": "USDT",
      "network": "TRON",
      "available": "1530.500000",
      "updatedAt": "2026-06-02T20:58:00.000Z"
    },
    {
      "assetCode": "TRX",
      "symbol": "TRX",
      "network": "TRON",
      "available": "8420.100000",
      "updatedAt": "2026-06-02T20:58:00.000Z"
    }
  ]
}

Поля баланса

string

Код актива (тот же, что code в каталоге активов).

string

Тикер валюты (например USDT).

string

Код сети актива (например TRON).

string

Доступно на hot-кошельках для выплат (строка, формат NUMERIC). Сравнивайте как decimal, не как float.

string | null

Когда баланс последний раз сверялся с сетью (ISO 8601). null, если сверки ещё не было.

Перед созданием выплаты сверьтесь с available для нужного актива — иначе вернётся INSUFFICIENT_HOT_WALLET_BALANCE. Помните, что баланс мог измениться между чтением и выплатой: используйте available как ориентир, а не как гарантию.

Частые вопросы

Какую валюту передавать в assetCode?

Поле code из GET /v1/public/assets (например USDT_TRC20). Сеть определяется самим кодом актива — отдельно её передавать не нужно.

Почему USDT встречается несколько раз?

USDT существует в разных сетях как разные активы: USDT_TRC20 (TRON), USDT_TON (TON) и т. д. Это разные assetCode с разными адресами и контрактами. Отправляйте средства строго в той сети, что соответствует assetCode.

Как часто можно дёргать эти эндпоинты?

Каталог кешируется на стороне сервера, ответ отдаётся быстро. Тем не менее не опрашивайте его в цикле без необходимости — кешируйте у себя и учитывайте общий лимит запросов (см. Лимиты).

Сумма с лишними знаками после запятой отклоняется.

Число знаков после запятой не должно превышать decimals актива (например 6 для USDT_TRC20). Иначе вернётся AMOUNT_TOO_MANY_DECIMALS. См. Ошибки.

Начало работы

Аутентификация

Депозиты

Счета

Выплаты

Webhooks

AML

Конвертации

Справочник

Валюты, сети и балансы

Активы

Поля актива

Сети

Поля сети

Балансы

Поля баланса

Частые вопросы

​Активы

​Поля актива

​Сети

​Поля сети

​Балансы

​Поля баланса

​Частые вопросы

Активы

Поля актива

Сети

Поля сети

Балансы

Поля баланса

Частые вопросы