GET /apiv2/screening/providers

Provedores disponíveis para a sua conta, com preços, as redes que cada um cobre e a escala na qual sua pontuação é medida.

URL do endpoint

GET https://netts.io/apiv2/screening/providers

Cabeçalhos da requisição

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

Exemplo de Requisição

bash

curl https://netts.io/apiv2/screening/providers \
  -H "X-API-KEY: your_api_key"

Resposta

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

Campo	Tipo	Descrição
providers[].provider	string	Nome do provedor, conforme enviado no corpo de uma verificação
providers[].price_usdt	string	Preço de tabela de uma verificação, em USDT
providers[].price_trx	string \| null	O mesmo preço convertido na taxa atual. `null` quando a taxa estiver indisponível
providers[].available	boolean	Se as verificações podem ser solicitadas no momento
providers[].reason	string	Presente apenas quando `available` for `false`. Atualmente `quota_exhausted`
providers[].networks	array	Tickers de rede que este provedor cobre
providers[].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
supported_languages	array	Idiomas do relatório. Atualmente apenas `en`

Os preços são strings decimais pelo mesmo motivo que os números no resultado de uma triagem são — consulte Números são strings. score_scale é um valor nosso e não do provedor, portanto permanece como um número JSON.

Para que serve este endpoint

É a lista de provedores. O campo provider de uma verificação é uma string de formato livre no esquema, em vez de uma enumeração, justamente para que um novo provedor não quebre integrações de quem valida respostas. A consequência é que a lista atual reside nos dados, não no esquema: leia-a aqui.

É também a lista de redes. A combinação é importante — um provedor não cobre necessariamente todas as redes. Solicitar uma verificação para um par que não é coberto retorna 4004 antes que qualquer cobrança seja feita.

E é de onde vem a escala. Uma pontuação de 7 de um provedor e 0.7 de outro não são a mesma leitura, e nada no próprio número indica a qual escala ele pertence. A escala também é fornecida dentro de cada resultado de triagem, em risk.scale, portanto uma integração que apenas lê resultados não precisa deste endpoint de forma alguma.

A margem de lucro de subusuários está incluída em price_trx, exatamente como está incluída no valor cobrado.

Erros

RFC 9457, application/problem+json.

Código	HTTP	Quando
`4010` / `4011`	401	Nenhuma chave de API fornecida, ou chave ou IP não aceito

Limites de taxa

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

GET /apiv2/screening/providers ​

URL do endpoint ​

Cabeçalhos da requisição ​

Exemplo de Requisição ​

Resposta ​

Para que serve este endpoint ​

Erros ​

Limites de taxa ​