GET /apiv2/screening/providers

Провайдеры, доступные вашему аккаунту, с ценами, поддерживаемыми сетями и шкалой, по которой рассчитывается их оценка.

Это контракт версии 2. Он заменяет GET /apiv2/aml/providers, который продолжает работать.

URL эндпоинта

GET https://netts.io/apiv2/screening/providers

Заголовки запроса

Заголовок	Обязательный	Описание
X-API-KEY	Да	Ваш API-ключ из панели управления Netts

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

bash

curl https://netts.io/apiv2/screening/providers \
  -H "X-API-KEY: your_api_key"

Ответ

json

{
  "schema_version": 2,
  "providers": [
    {
      "provider": "elliptic",
      "price_usdt": "0.98",
      "price_trx": "2.884881",
      "available": true,
      "networks": ["ada", "algo", "apt", "arb", "atom", "avax", "base", "bch",
                   "bnb", "bsc", "btc", "celo", "cro", "doge", "dot", "dydx",
                   "etc", "eth", "fil", "flr", "ftm", "gnosis", "hbar", "hype",
                   "icp", "inj", "linea", "ltc", "matic", "mob", "near", "okb",
                   "op", "sei", "sol", "strk", "sui", "tao", "ton", "trx",
                   "xdc", "xlm", "xrp", "xtz", "zec", "zen", "zil", "zksync"],
      "score_scale": { "min": 0, "max": 10 }
    }
  ],
  "trx_rate_usd": "0.339702",
  "supported_languages": ["en"]
}

Поле	Тип	Описание
providers[].provider	string	Название провайдера, передаваемое в теле запроса на проверку
providers[].price_usdt	string	Прейскурантная цена одной проверки в USDT
providers[].price_trx	string \| null	Та же цена, конвертированная по текущему курсу. `null`, когда курс недоступен
providers[].available	boolean	Доступен ли заказ проверок прямо сейчас
providers[].reason	string	Присутствует только в том случае, если `available` имеет значение `false`. На данный момент: `quota_exhausted`
providers[].networks	array	Тикеры сетей, поддерживаемых данным провайдером
providers[].score_scale	object	`min` и `max` собственной шкалы оценок провайдера
trx_rate_usd	string \| null	Курс, использованный для конвертации
supported_languages	array	Языки отчета. На данный момент только `en`

Цены представлены строками с десятичными числами по той же причине, что и числа в результатах скрининга — см. Числа представлены строками. Значение score_scale сформировано нашей стороной, а не провайдером, поэтому оно остается числом JSON.

Для чего нужен этот эндпоинт

Это список провайдеров. Поле provider при проверке является строкой произвольного формата в схеме, а не перечислением (enum), как раз для того, чтобы добавление нового провайдера не нарушало работу валидаторов ответов. Следствием этого является то, что актуальный список находится в данных, а не в схеме: считывайте его здесь.

Это также список сетей. Связка имеет значение — провайдер не обязательно поддерживает каждую сеть. Заказ проверки для неподдерживаемой пары вернет 4004 до списания каких-либо средств.

И отсюда берется шкала. Оценка 7 от одного провайдера и 0.7 от другого — это разные показатели, и само число никак не указывает на используемую шкалу. Шкала также возвращается в каждом результате скрининга в поле risk.scale, поэтому интеграции, которая только считывает результаты, этот эндпоинт вовсе не нужен.

Провайдер, недоступный вашему аккаунту, в списке не отображается. BitOK имеет ограниченный доступ, и аккаунты не из белого списка не увидят его здесь и получат отказ с кодом 4002 при вызове POST /apiv2/screening.

Что изменилось по сравнению с версией 1

Версия 1 также возвращает supported_formats. Это поле относилось к модели запроса версии 1, где формат фиксировался при создании заказа; в версии 2 такого поля в запросе нет, поскольку представление выбирается при чтении результата, поэтому список был удален.

До 13 сентября 2026 года в этом списке указывались четыре формата — rate, full, md и pdf — из которых фактически формировались только два. Запрос на получение pdf молча возвращал обычный full. Теперь оба эндпоинта указывают только то, что они действительно возвращают, а версия 1 отклоняет md и pdf в запросе вместо того, чтобы незаметно подменять их чем-то другим.

Наценка для субаккаунтов включена в price_trx точно так же, как она включается в списываемую сумму.

Ошибки

RFC 9457, application/problem+json.

Код	HTTP	Когда
`4010` / `4011`	401	API-ключ отсутствует, либо переданный ключ или IP-адрес не принят

Ограничения частоты запросов

Общие для всех остальных путей AML: 5 запросов в секунду, 150 в минуту.

GET /apiv2/screening/providers ​

URL эндпоинта ​

Заголовки запроса ​

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

Ответ ​

Для чего нужен этот эндпоинт ​

Что изменилось по сравнению с версией 1 ​

Ошибки ​

Ограничения частоты запросов ​