curl --request POST \
--url https://app.blockgence.com/v1/triage \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"victim": "<string>",
"chain": "ethereum",
"loss_txs": [
"<string>"
],
"from_block": 0
}
'import requests
url = "https://app.blockgence.com/v1/triage"
payload = {
"victim": "<string>",
"chain": "ethereum",
"loss_txs": ["<string>"],
"from_block": 0
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({victim: '<string>', chain: 'ethereum', loss_txs: ['<string>'], from_block: 0})
};
fetch('https://app.blockgence.com/v1/triage', 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/triage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'victim' => '<string>',
'chain' => 'ethereum',
'loss_txs' => [
'<string>'
],
'from_block' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.blockgence.com/v1/triage"
payload := strings.NewReader("{\n \"victim\": \"<string>\",\n \"chain\": \"ethereum\",\n \"loss_txs\": [\n \"<string>\"\n ],\n \"from_block\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.blockgence.com/v1/triage")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"victim\": \"<string>\",\n \"chain\": \"ethereum\",\n \"loss_txs\": [\n \"<string>\"\n ],\n \"from_block\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/triage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"victim\": \"<string>\",\n \"chain\": \"ethereum\",\n \"loss_txs\": [\n \"<string>\"\n ],\n \"from_block\": 0\n}"
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>"
}Victim triage
Answers, in a single request, how a victim’s funds were taken, where they went and what can be frozen today, with a warning against re-scams. It combines the compromise vector, the trace from each loss transaction and the current status with the issuers.
Request body: victim (address), chain (EVM network, defaults to ethereum), loss_txs (up to 25 loss
transactions, optional) and from_block (the block from which outflows are searched, defaults to 0).
Without loss_txs, the outflows in transactions the victim did not send are used. A loss the victim signed
(through a compromised key or a deception) appears only if its transactions are given. Finding no losses does
not prove there were none.
The response includes:
losses: one row per transaction, with itsvector, whether it is a loss (is_loss),usd_at_tx,unpricedand whether it was traced (traced);vector: the compromise vector, as inPOST /v1/compromise, orvector_failurewith the reason;traces: up to 3 traces, those of the transactions with the highest USD value at the date, with their receivers, the exchanges reached and their blind spots. The rest can be traced withPOST /v1/tracetx;freeze: today’s status with the issuer of each address in the traces that received a freezable token (freezable,frozen,exchange,issuer_offchain,dust,empty,unknown) and the freezable balance per token. It indicates the status with the issuer, not that it will freeze;rescamandfor_authority: the warning against re-scams and who submits the request. blockgence does not send anything.
Each part that fails is declared in degraded_sources and the others continue. Without loss_txs, if the
outflows cannot be read, the response is 503 at no charge. A non-EVM network or an invalid address or hash
returns 400. USD values at the date come from DefiLlama, whose license does not allow republishing them.
Cost: 60 credits base. Some operations charge less when they reuse a saved result; never more.
curl --request POST \
--url https://app.blockgence.com/v1/triage \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"victim": "<string>",
"chain": "ethereum",
"loss_txs": [
"<string>"
],
"from_block": 0
}
'import requests
url = "https://app.blockgence.com/v1/triage"
payload = {
"victim": "<string>",
"chain": "ethereum",
"loss_txs": ["<string>"],
"from_block": 0
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({victim: '<string>', chain: 'ethereum', loss_txs: ['<string>'], from_block: 0})
};
fetch('https://app.blockgence.com/v1/triage', 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/triage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'victim' => '<string>',
'chain' => 'ethereum',
'loss_txs' => [
'<string>'
],
'from_block' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.blockgence.com/v1/triage"
payload := strings.NewReader("{\n \"victim\": \"<string>\",\n \"chain\": \"ethereum\",\n \"loss_txs\": [\n \"<string>\"\n ],\n \"from_block\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.blockgence.com/v1/triage")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"victim\": \"<string>\",\n \"chain\": \"ethereum\",\n \"loss_txs\": [\n \"<string>\"\n ],\n \"from_block\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/triage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"victim\": \"<string>\",\n \"chain\": \"ethereum\",\n \"loss_txs\": [\n \"<string>\"\n ],\n \"from_block\": 0\n}"
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
Body
Response
Successful response.