Skip to content

GET /apiv2/screening/price ​

The price of one check from one provider, and whether your balance covers it.

Endpoint URL ​

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

Request Headers ​

HeaderRequiredDescription
X-API-KEYYesYour API key from the Netts dashboard

Query Parameters ​

ParameterTypeRequiredDescription
providerstringYeselliptic or bitok. There is no default

The body of a check has the same rule.

Example Request ​

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

Response ​

json
{
  "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
}
FieldTypeDescription
providerstringThe provider asked about
price_usdtstringList price of one check, in USDT
price_trxstring | nullThe same price converted at the current rate
availablebooleanWhether checks can be ordered right now
reasonstringPresent only when available is false. Currently quota_exhausted
networksarrayNetwork tickers this provider covers
score_scaleobjectmin and max of the provider's own score scale
trx_rate_usdstring | nullRate used for the conversion
balance_trxstringYour TRX balance
can_affordbooleanbalance_trx is at least price_trx

can_afford is a convenience, not a reservation. The rate moves and the balance can be spent elsewhere between this call and the check. The authoritative answer is the check itself, which refuses with 1004 and states the amounts.

Amounts are quoted to six decimal places — that is the precision at which TRX is actually taken from the balance, not a display choice. They are decimal strings for the reason set out in Numbers are strings.

Sub-user markup is included in price_trx, exactly as it is included in the amount charged.

Errors ​

RFC 9457, application/problem+json.

CodeHTTPWhen
4001400provider missing or not a known provider
4002403The provider is not open for your account
4010 / 4011401No API key, or a key or IP that is not accepted
5030503The provider is temporarily unavailable

Rate Limits ​

Shared with every other AML path: 5 requests per second, 150 per minute.