GET /apiv2/screening/price

O preço de uma verificação de um provedor, e se o seu saldo a cobre.

Este é o contrato da versão 2. Ele substitui o GET /apiv2/aml/price, que continua funcionando.

URL do Endpoint

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

Cabeçalhos da Requisição

Cabeçalho	Obrigatório	Descrição
X-API-KEY	Sim	Sua chave de API do painel da Netts

Parâmetros de Consulta

Parâmetro	Tipo	Obrigatório	Descrição
provider	string	Sim	elliptic ou bitok. Não há valor padrão

Na versão 1, este parâmetro tinha como padrão elliptic, de modo que um chamador que o omitisse recebia uma cotação de preço para um provedor que não havia especificado. O corpo de uma verificação segue a mesma regra.

Exemplo de Requisição

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

Resposta

{
  "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	Descrição
provider	string	O provedor consultado
price_usdt	string	Preço de tabela de uma verificação, em USDT
price_trx	string | null	O mesmo preço convertido pela taxa atual
available	boolean	Se as verificações podem ser solicitadas no momento
reason	string	Presente apenas quando available for false. Atualmente quota_exhausted
networks	array	Tickers de rede que este provedor cobre
score_scale	object	min e max da própria escala de pontuação do provedor
trx_rate_usd	string | null	Taxa utilizada para a conversão
balance_trx	string	Seu saldo de TRX
can_afford	boolean	balance_trx é pelo menos price_trx

can_afford é uma conveniência, não uma reserva. A taxa oscila e o saldo pode ser gasto em outro lugar entre esta chamada e a verificação. A resposta definitiva é a própria verificação, que recusa com 1004 e informa os valores.

Os valores são cotados com seis casas decimais — essa é a precisão com a qual o TRX é efetivamente debitado do saldo, não uma escolha de exibição. Eles são strings decimais pelo motivo explicado em Números são strings.

A margem do subusuário está incluída em price_trx, exatamente como é incluída no valor cobrado.

Erros

RFC 9457, application/problem+json.

Código	HTTP	Quando
4001	400	provider ausente ou não é um provedor conhecido
4002	403	O provedor existe, mas não está disponível para sua conta
4010 / 4011	401	Sem chave de API, ou chave ou IP não aceitos
5030	503	O provedor está temporariamente indisponível

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

Limites de Taxa

Compartilhado com todas as outras rotas de AML: 5 requisições por segundo, 150 por minuto.