Информация/Направления

Направления

Получение списка доступных направлений депозита и вывода с актуальными статусами и комиссиями.

Endpoint возвращает все поддерживаемые пары валюта + сеть с их текущими статусами, лимитами и расчётными комиссиями вывода. Используйте его, чтобы динамически строить UI выбора валюты и заранее показывать пользователю стоимость вывода.

Список направлений

GET/v1/directions

Аутентификация не требуется — endpoint публичный в рамках проекта (подпись обязательна по общему правилу, тело запроса пустое).

Для GET-запроса подпись считается от пустого тела: hash_hmac('sha256', base64_encode(''), $apiKey)

Пример запроса

Shell

curl -X GET https://api.2328.io/api/v1/directions \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Пример ответа

JSON

{
  "state": 0,
  "result": [
    {
      "network": "Tron",
      "currency": "USDT",
      "deposit_status": "active",
      "withdrawal_status": "active",
      "min_deposit": null,
      "max_deposit": null,
      "min_withdrawal": "1.000000000000000000",
      "max_withdrawal": null,
      "withdrawal_fee": "2.500000000000000000",
      "withdrawal_fee_type": "fixed"
    },
    {
      "network": "Bitcoin",
      "currency": "BTC",
      "deposit_status": "inactive",
      "withdrawal_status": "active",
      "min_deposit": null,
      "max_deposit": null,
      "min_withdrawal": null,
      "max_withdrawal": null,
      "withdrawal_fee": null,
      "withdrawal_fee_type": "estimated"
    }
  ]
}

Поля ответа

Поле	Тип	Описание
`network`	string	Название сети (например, `Tron`, `Bitcoin`, `Ethereum`)
`currency`	string	Код валюты (например, `USDT`, `BTC`, `ETH`)
`deposit_status`	string	Статус приёма депозитов (см. ниже)
`withdrawal_status`	string	Статус вывода (см. ниже)
`min_deposit`	string \| null	Минимальная сумма депозита. `null` — без ограничений
`max_deposit`	string \| null	Максимальная сумма депозита. `null` — без ограничений
`min_withdrawal`	string \| null	Минимальная сумма вывода. `null` — без ограничений
`max_withdrawal`	string \| null	Максимальная сумма вывода. `null` — без ограничений
`withdrawal_fee`	string \| null	Расчётная комиссия вывода в валюте направления. `null` — нет данных
`withdrawal_fee_type`	string	Тип комиссии: `fixed`, `estimated` или `unknown` (см. ниже)

Статусы направлений

Статус	Описание
`active`	Направление работает штатно
`inactive`	Временно недоступно (технические работы)
`disabled`	Не поддерживается

Если deposit_status или withdrawal_status отличается от active — соответствующая операция будет отклонена с ошибкой direction_disabled. Используйте этот endpoint, чтобы заранее скрыть недоступные направления в UI.

Типы комиссии вывода

Тип	Описание
`fixed`	Фиксированная комиссия в поле `withdrawal_fee`
`estimated`	Оценочная комиссия на основе актуального network fee. Финальная сумма может незначительно отличаться — уточняйте через `/v1/payout/calc`
`unknown`	Комиссия для этого направления не настроена