curl --request GET \
--url https://app.blockgence.com/v1/screening/{addr} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/screening/{addr}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.blockgence.com/v1/screening/{addr}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.blockgence.com/v1/screening/{addr}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.blockgence.com/v1/screening/{addr}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.blockgence.com/v1/screening/{addr}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/screening/{addr}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"detail": "<string>",
"error": "<string>"
}{
"detail": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>",
"error": "<string>"
}{
"error": "source_unavailable",
"detail": "<string>",
"source": "<string>",
"reason": "<string>",
"retryable": true,
"chain": "<string>",
"primitive": "<string>",
"operation": "<string>",
"target": "<string>",
"http_status": 123,
"retry_after": 123,
"upstream_message": "<string>",
"source_fault": true,
"failure_cause": "<string>"
}Screening de riesgo de una address
Screening de riesgo de una address (una consulta puntual, no un monitoreo continuo de transacciones):
¿es riesgosa? Combina labels locales
(OFAC/seeds/comunidad, más las de usuario que ve el alcance de la request: su API key y
su caso, o la UI) + attribution en vivo (Blockscout) + score explicable,
y devuelve una recomendación (allow / review / block). Ideal para compliance.
Solo una sanción VIGENTE bloquea: una baja de OFAC (p.ej. TORNADO CASH, 2025-03-21)
vuelve en sanctions_history y en risk.reasons, con fechas y fuente.
sanctions_status (sanctioned | delisted | conflict | null) y sanctions_history (lista de
SanctionsEvent: autoridad, lista, programas, listed|delisted, fecha y su precisión, URL)
salen de las fuentes de sanciones (lista OFAC vigente + registro de bajas, ver
sanctions.status/timeline). date_precision: entity es la fecha de alta de la ENTIDAD, no
de la dirección. Reemplazan la forma anterior de sanctions_history (list/entity/status/
designated/delisted/sources/verified_on), que ningún consumidor usaba.
Devuelve además, sin tocar el score ni la recomendación: service_type y
conflicting_tags (tags de riesgo de terceros citados pero NO aplicados a la categoría,
p.ej. «Phish / Hack» sobre la hot wallet de un exchange que también es blanco de poisoning).
Acepta EVM (0x + 40 hex), Tron (base58check T…) y Monero (base58 de 95 o 106 caracteres, solo
mainnet). En Tron y Monero la red la define el formato, la address NO se pasa a minúsculas
(base58 las distingue: en minúsculas deja de ser válida) y solo cuentan las labels locales, OFAC
incluida: Blockscout y GoPlus no cubren esas redes. En Monero, una address integrada hereda la
sanción de su estándar (mismas claves públicas: regla attribution.monero-address).
degraded_sources: las consultas que fallaron (hoy GoPlus, stage screening.goplus). Con una
falla ahí la recomendación sale con lo que respondió, y malicious_flags vacío no es «no
marcada»: el cliente decide si reintenta antes de un allow.
known: false si ninguna fuente identifica la address (screening_known). Un
allow así lleva en risk.reasons la leyenda «sin marcas» no es «sin riesgo» (UNKNOWN_NOT_CLEAN).
issuer_freeze: si un emisor (Tether, Circle, Paxos, First Digital, BitGo, Ripple, Binance o TrueUSD) tiene la address congelada, leído on-chain a un bloque fijado, con
cada evento citado a su tx. Vigente, sube allow a review y suma al score, salvo sobre un servicio identificado.
No afirma por qué la congelaron. Una falla de la lectura va a degraded_sources (stages freeze.*).
Costo: 3 créditos de base (solo si la respuesta es < 400; algunas rutas cobran menos si reusan un resultado guardado).
curl --request GET \
--url https://app.blockgence.com/v1/screening/{addr} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/screening/{addr}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.blockgence.com/v1/screening/{addr}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.blockgence.com/v1/screening/{addr}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.blockgence.com/v1/screening/{addr}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.blockgence.com/v1/screening/{addr}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/screening/{addr}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"detail": "<string>",
"error": "<string>"
}{
"detail": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>",
"error": "<string>"
}{
"error": "source_unavailable",
"detail": "<string>",
"source": "<string>",
"reason": "<string>",
"retryable": true,
"chain": "<string>",
"primitive": "<string>",
"operation": "<string>",
"target": "<string>",
"http_status": 123,
"retry_after": 123,
"upstream_message": "<string>",
"source_fault": true,
"failure_cause": "<string>"
}Autorizaciones
Encabezados
Caso activo (opcional): el token de un caso que podés ver. La consulta queda en el registro de actividad de ese caso y resuelve también sus labels propias. Un caso que no existe, se borró o ya no está compartido con vos da 400 case_unavailable y la consulta no se hace (sin cobro).
Parámetros de ruta
Parámetros de consulta
Respuesta
Successful Response