GET /apiv2/screening/price

某个提供商单次检查的价格，以及您的余额是否足以支付。

这是版本 2 协议。它替代了 GET /apiv2/aml/price，后者仍可继续使用。

接口 URL

GET https://netts.io/apiv2/screening/price?provider=elliptic

请求头

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

查询参数

参数	类型	必填	说明
provider	字符串	是	elliptic 或 bitok。没有默认值

在版本 1 中，此参数默认为 elliptic，因此省略该参数的调用方会被提供未指定的提供商报价。执行检查的请求体也遵循相同的规则。

请求示例

curl "https://netts.io/apiv2/screening/price?provider=elliptic" \
  -H "X-API-KEY: your_api_key"

响应

{
  "schema_version": 2,
  "provider": "elliptic",
  "price_usdt": "0.98",
  "price_trx": "2.884881",
  "available": true,
  "networks": ["trx", "eth", "btc", "..."],
  "score_scale": { "min": 0, "max": 10 },
  "trx_rate_usd": "0.339702",
  "balance_trx": "113.910000",
  "can_afford": true
}

字段	类型	说明
provider	字符串	所查询的提供商
price_usdt	字符串	单次检查的标价，以 USDT 计
price_trx	字符串 | 无	按当前汇率折算后的相同价格
available	布尔值	当前是否可以下单进行检查
reason	字符串	仅在 available 为 false 时存在。目前为 quota_exhausted
networks	数组	该提供商支持的网络代码
score_scale	对象	提供商自身评分标准的 min（最小值）和 max（最大值）
trx_rate_usd	字符串 | 无	用于折算的汇率
balance_trx	字符串	您的 TRX 余额
can_afford	布尔值	balance_trx 是否至少达到 price_trx

can_afford 仅供参考，并非预留锁定。在此次调用与实际检查之间，汇率可能会变动，且余额可能被花费到其他地方。具有权威性的结果来自检查操作本身，如果余额不足，它将以 1004 拒绝并说明相应金额。

金额报价精确到小数点后六位 —— 这是从余额中实际扣除 TRX 的精度，而非仅用于显示的设定。它们以十进制字符串表示，原因详见 数字为字符串形式。

子用户的加价已包含在 price_trx 中，与计费时收取的金额完全一致。

错误响应

RFC 9457，application/problem+json。

错误代码	HTTP 状态码	触发时机
4001	400	provider 缺失或非已知提供商
4002	403	提供商存在，但未对您的账户开放
4010 / 4011	401	未提供 API 密钥，或者密钥或 IP 未被接受
5030	503	提供商暂时不可用

{
  "type": "https://doc.netts.io/api/v2/errors/provider-unavailable-for-account",
  "title": "Provider is not available for your account",
  "status": 403,
  "detail": "BitOK is not available for your account. Please use Elliptic.",
  "instance": "/apiv2/screening/price",
  "code": 4002
}

频率限制

与所有其他 AML 接口共享：每秒 5 次请求，每分钟 150 次。