GET /apiv2/screening/price

El precio de una verificación de un proveedor, y si su saldo la cubre.

Este es el contrato de la versión 2. Reemplaza a GET /apiv2/aml/price, que sigue funcionando.

URL del Endpoint

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

Encabezados de Solicitud

Encabezado	Obligatorio	Descripción
X-API-KEY	Sí	Su clave de API del panel de control de Netts

Parámetros de Consulta

Parámetro	Tipo	Obligatorio	Descripción
provider	cadena	Sí	elliptic o bitok. No hay valor por defecto

En la versión 1 este parámetro tiene por defecto elliptic, por lo que a quien lo omitiera se le cotizaba un precio para un proveedor que no había indicado. El cuerpo de una verificación tiene la misma regla.

Solicitud de Ejemplo

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

Respuesta

{
  "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
}

Campo	Tipo	Descripción
provider	cadena	El proveedor consultado
price_usdt	cadena	Precio de lista de una verificación, en USDT
price_trx	cadena | nulo	El mismo precio convertido a la tasa actual
available	booleano	Si se pueden solicitar verificaciones en este momento
reason	cadena	Presente solo cuando available es false. Actualmente quota_exhausted
networks	arreglo	Tickers de red que cubre este proveedor
score_scale	objeto	min y max de la propia escala de puntuación del proveedor
trx_rate_usd	cadena | nulo	Tasa utilizada para la conversión
balance_trx	cadena	Su saldo de TRX
can_afford	booleano	balance_trx es al menos price_trx

can_afford es una conveniencia, no una reserva. La tasa varía y el saldo puede gastarse en otro lugar entre esta llamada y la verificación. La respuesta definitiva es la propia verificación, que rechaza con 1004 e indica los importes.

Los importes se cotizan con seis decimales; esa es la precisión con la que TRX se deduce realmente del saldo, no una elección de visualización. Son cadenas decimales por el motivo expuesto en Los números son cadenas.

El margen del subusuario está incluido en price_trx, exactamente igual que se incluye en el importe cobrado.

Errores

RFC 9457, application/problem+json.

Código	HTTP	Cuándo
4001	400	Falta provider o no es un proveedor conocido
4002	403	El proveedor existe pero no está disponible para su cuenta
4010 / 4011	401	Sin clave de API, o una clave o IP no aceptada
5030	503	El proveedor no está disponible temporalmente

{
  "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
}

Límites de Tasa

Compartidos con todas las demás rutas de AML: 5 solicitudes por segundo, 150 por minuto.