GET /apiv2/screening/providers

您账户可用的提供商，包含价格、各自覆盖的网络以及其评分衡量的尺度范围。

这是版本 2 规范协议。它取代了仍可继续使用的 GET /apiv2/aml/providers。

接口 URL

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

请求头

请求头	必填	描述
X-API-KEY	是	来自 Netts 控制面板的 API 密钥

请求示例

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 字段在架构中是自由格式字符串，而非枚举值，这正是为了使新添加的提供商不会破坏任何验证响应的代码。结果就是当前列表存在于数据中，而非架构中：请在此处读取。

它也是网络列表。 配对关系至关重要——提供商不一定覆盖所有网络。为未覆盖的配对订购筛查会在扣费前返回 4004。

并且它是评分尺度的来源。 一家提供商的 7 分与另一家提供商的 0.7 分并非同一读数，且数字本身并未说明其所属的尺度。每个筛查结果内部的 risk.scale 中也会包含该尺度，因此仅读取结果的集成完全不需要调用此接口。

您账户无法使用的提供商不会被列出。 BitOK 受到限制，不在其白名单内的账户在此处看不到它，且在调用 POST /apiv2/screening 时会被以 4002 拒绝。

相比版本 1 的变动

版本 1 还会返回 supported_formats。该字段属于版本 1 的请求模型，在创建订单时格式便已确定；而在版本 2 中，请求中没有此类字段，因为展现形式是在读取结果时选择的，因此该列表已移除。

在 2026 年 9 月 13 日之前，该列表列出了四种格式——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 的变动 ​

错误响应 ​

速率限制 ​