curl --request GET \
--url https://app.blockgence.com/v1/scam/{chain}/{addr}/victims \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/scam/{chain}/{addr}/victims"
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/scam/{chain}/{addr}/victims', 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/scam/{chain}/{addr}/victims",
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/scam/{chain}/{addr}/victims"
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/scam/{chain}/{addr}/victims")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/scam/{chain}/{addr}/victims")
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>"
}Scammer victims
Given the address of a scammer (the party that collected the funds), separates those who sent it funds according to the evidence:
victims: only with evidence. Their funds left in a transaction they did not sign, without consideration, toward the scammer or moved by it (a drain by signature or by permission), or the victim is the one in the loss transaction of the case given incase_token(linkage: declared). Each victim includesevidence,stolen_usdwith its basis (stolen_usd_basis),drains,open_permissions,incomingandidentity;pattern_indications: counterparties whose flow matches the FinCEN pig-butchering red flag (FIN-2023-Alert005): the scammer paid a “withdrawal” and the counterparty then sent it a larger amount. It is an indication (linkage: probabilistic), not a victim;incoming_counterparties: everyone else who sent it funds, without classification;incoming_in_subject_txs: what came in through transactions the scammer signed (its own conversions);destinations: where it sent its funds, aggregated by destination, withofframp_candidatewhen the destination has an exchange label. Burns go inburns.
subject includes the scammer’s identity and its first funding (funded_by). If addr is an identified service
(an exchange, a bridge), subject_warning notes that its senders are customers and only proven drains count.
Per-asset totals include amount_raw, the exact sum in base units, or null if any row lacks it: never a
partial sum.
The 100 counterparties and the 50 destinations with the highest USD value are listed. coverage indicates what
was read; with complete: false, the absence of an address means nothing. If neither the drains nor the
transfers can be read, the response is 503 at no charge; if only one part fails, it is declared in
degraded_sources. USD values at the date come from DefiLlama, whose license does not allow republishing them.
The list names third parties (confidentiality): it is for the case. With X-Case-Id, the query is recorded in
the case and its victims and destinations can be annotated there.
EVM networks only. A case that does not exist or that you cannot see returns 404; a case on another network,
400. It does not cover public victim reports, other addresses or other networks of the same scammer
(GET /v1/probe/{addr} indicates where it operates), or Tron.
Cost: 40 credits base. Some operations charge less when they reuse a saved result; never more.
curl --request GET \
--url https://app.blockgence.com/v1/scam/{chain}/{addr}/victims \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/scam/{chain}/{addr}/victims"
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/scam/{chain}/{addr}/victims', 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/scam/{chain}/{addr}/victims",
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/scam/{chain}/{addr}/victims"
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/scam/{chain}/{addr}/victims")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/scam/{chain}/{addr}/victims")
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>"
}Authorizations
Headers
Path Parameters
Query Parameters
Response
Successful response.