Skip to content
Translated page. The English version is the source of truth.

GET /apiv2/screening/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[].providerstring提供商名称,与筛查请求体中发送的一致
providers[].price_usdtstring单次筛查的标价,以 USDT 计
providers[].price_trxstring | null按当前汇率折算的相同价格。汇率不可用时为 null
providers[].availableboolean当前是否可以订购筛查
providers[].reasonstring仅在 available 为 false 时存在。目前为 quota_exhausted
providers[].networksarray该提供商覆盖的网络代码
providers[].score_scaleobject提供商自身评分尺度的 min 和 max
trx_rate_usdstring | null换算使用的汇率
supported_languagesarray报告语言。目前仅支持 en

价格为小数字符串,原因与筛查结果中的数字相同——参见数字即字符串。score_scale 是我们的数值而非提供商的数据,因此保持为 JSON 数字。

此接口的作用 ​

它是提供商列表。 筛查的 provider 字段在架构中是自由格式字符串,而非枚举值,这正是为了使新添加的提供商不会破坏任何验证响应的代码。结果就是当前列表存在于数据中,而非架构中:请在此处读取。

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

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

子用户加价包含在 price_trx 中,正如它包含在扣费金额中一样。

错误响应 ​

RFC 9457,application/problem+json。

代码HTTP触发场景
4010 / 4011401未提供 API 密钥,或密钥/IP 未被接受

速率限制 ​

与其他所有 AML 路径共享:每秒 5 次请求,每分钟 150 次。