curl --request POST \
--url https://app.blockgence.com/v1/incident \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"chain": "ethereum",
"exploit_tx": "<string>",
"victim": "<string>",
"addresses": [
"<string>"
],
"addresses_source": "<string>",
"hops": 2,
"fanout": 4,
"since": 0,
"window_days": 123,
"max_credits": 200,
"name": "<string>",
"watch": {
"create": true,
"follow_hops": true,
"shared": false
},
"protocol_addresses": [
{
"address": "<string>",
"source": "<string>",
"role": "protocol"
}
]
}
'import requests
url = "https://app.blockgence.com/v1/incident"
payload = {
"chain": "ethereum",
"exploit_tx": "<string>",
"victim": "<string>",
"addresses": ["<string>"],
"addresses_source": "<string>",
"hops": 2,
"fanout": 4,
"since": 0,
"window_days": 123,
"max_credits": 200,
"name": "<string>",
"watch": {
"create": True,
"follow_hops": True,
"shared": False
},
"protocol_addresses": [
{
"address": "<string>",
"source": "<string>",
"role": "protocol"
}
]
}
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({
chain: 'ethereum',
exploit_tx: '<string>',
victim: '<string>',
addresses: ['<string>'],
addresses_source: '<string>',
hops: 2,
fanout: 4,
since: 0,
window_days: 123,
max_credits: 200,
name: '<string>',
watch: {create: true, follow_hops: true, shared: false},
protocol_addresses: [{address: '<string>', source: '<string>', role: 'protocol'}]
})
};
fetch('https://app.blockgence.com/v1/incident', 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/incident",
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([
'chain' => 'ethereum',
'exploit_tx' => '<string>',
'victim' => '<string>',
'addresses' => [
'<string>'
],
'addresses_source' => '<string>',
'hops' => 2,
'fanout' => 4,
'since' => 0,
'window_days' => 123,
'max_credits' => 200,
'name' => '<string>',
'watch' => [
'create' => true,
'follow_hops' => true,
'shared' => false
],
'protocol_addresses' => [
[
'address' => '<string>',
'source' => '<string>',
'role' => 'protocol'
]
]
]),
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/incident"
payload := strings.NewReader("{\n \"chain\": \"ethereum\",\n \"exploit_tx\": \"<string>\",\n \"victim\": \"<string>\",\n \"addresses\": [\n \"<string>\"\n ],\n \"addresses_source\": \"<string>\",\n \"hops\": 2,\n \"fanout\": 4,\n \"since\": 0,\n \"window_days\": 123,\n \"max_credits\": 200,\n \"name\": \"<string>\",\n \"watch\": {\n \"create\": true,\n \"follow_hops\": true,\n \"shared\": false\n },\n \"protocol_addresses\": [\n {\n \"address\": \"<string>\",\n \"source\": \"<string>\",\n \"role\": \"protocol\"\n }\n ]\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/incident")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"chain\": \"ethereum\",\n \"exploit_tx\": \"<string>\",\n \"victim\": \"<string>\",\n \"addresses\": [\n \"<string>\"\n ],\n \"addresses_source\": \"<string>\",\n \"hops\": 2,\n \"fanout\": 4,\n \"since\": 0,\n \"window_days\": 123,\n \"max_credits\": 200,\n \"name\": \"<string>\",\n \"watch\": {\n \"create\": true,\n \"follow_hops\": true,\n \"shared\": false\n },\n \"protocol_addresses\": [\n {\n \"address\": \"<string>\",\n \"source\": \"<string>\",\n \"role\": \"protocol\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/incident")
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 \"chain\": \"ethereum\",\n \"exploit_tx\": \"<string>\",\n \"victim\": \"<string>\",\n \"addresses\": [\n \"<string>\"\n ],\n \"addresses_source\": \"<string>\",\n \"hops\": 2,\n \"fanout\": 4,\n \"since\": 0,\n \"window_days\": 123,\n \"max_credits\": 200,\n \"name\": \"<string>\",\n \"watch\": {\n \"create\": true,\n \"follow_hops\": true,\n \"shared\": false\n },\n \"protocol_addresses\": [\n {\n \"address\": \"<string>\",\n \"source\": \"<string>\",\n \"role\": \"protocol\"\n }\n ]\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>"
}Start the incident playbook
Creates an asynchronous job that analyzes an incident and builds the case in a single request. It responds 202
with the job_id; progress is available at GET /v1/incident/{job_id}.
Request body, with exactly one input among exploit_tx, victim and addresses:
chain: EVM network (defaults toethereum);exploit_tx: the exploit transaction;victim: the victim’s address; the trace starts from it;addresses: up to 60 attacker addresses, with a mandatoryaddresses_source(where the list comes from). The attribution belongs to that source, not to blockgence;hops(from 1 to 5, defaults to 2) andfanout(from 1 to 10, defaults to 4): hops and branches per node of the trace. An out-of-range value is adjusted to the nearest limit;since: from when to follow the funds (unix), withvictimoraddresses;window_days: days of the trace window from the exploit date or fromsince. Withexploit_tx, 30 by default and up to 180;0means no limit. Withvictimoraddressesit requiressince;max_credits: cap on the credits of the steps, excluding orchestration (defaults to 200, up to 5,000);name: name of the case;watch:{create, follow_hops, shared}, to create a Guard watch for each attacker account. Withoutwatch, the watches are only offered;protocol_addresses: up to 20 protocol addresses,{address, role, source}, to recognize returns.
The steps, in order, are decode, attacker, stolen, trace (in batches of up to 5 seeds), freeze,
case, postmortem and watchlist. Each one ends as ok, skipped or error, with its reason, its evidence
and the credits it cost (credits).
Orchestration is charged when the job is created, and each step that completes successfully is charged
separately. A step that fails is not charged. If the month’s credits or max_credits are not enough for a step,
that step is skipped and the job continues without it.
The same request from the same API key within 24 hours returns that job (200, idempotent_replay: true) at no
charge, unless it ended in error, was interrupted or its case was deleted. Up to 2 jobs in progress are allowed
per API key; beyond that, the response is 429 at no charge. An invalid request returns 400 at no charge.
Cost: 40 credits when the job is created, plus each step that completes successfully, up to the request’s max_credits cap. A failed step is not charged. Repeating the same request returns the existing job, with no charge.
curl --request POST \
--url https://app.blockgence.com/v1/incident \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"chain": "ethereum",
"exploit_tx": "<string>",
"victim": "<string>",
"addresses": [
"<string>"
],
"addresses_source": "<string>",
"hops": 2,
"fanout": 4,
"since": 0,
"window_days": 123,
"max_credits": 200,
"name": "<string>",
"watch": {
"create": true,
"follow_hops": true,
"shared": false
},
"protocol_addresses": [
{
"address": "<string>",
"source": "<string>",
"role": "protocol"
}
]
}
'import requests
url = "https://app.blockgence.com/v1/incident"
payload = {
"chain": "ethereum",
"exploit_tx": "<string>",
"victim": "<string>",
"addresses": ["<string>"],
"addresses_source": "<string>",
"hops": 2,
"fanout": 4,
"since": 0,
"window_days": 123,
"max_credits": 200,
"name": "<string>",
"watch": {
"create": True,
"follow_hops": True,
"shared": False
},
"protocol_addresses": [
{
"address": "<string>",
"source": "<string>",
"role": "protocol"
}
]
}
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({
chain: 'ethereum',
exploit_tx: '<string>',
victim: '<string>',
addresses: ['<string>'],
addresses_source: '<string>',
hops: 2,
fanout: 4,
since: 0,
window_days: 123,
max_credits: 200,
name: '<string>',
watch: {create: true, follow_hops: true, shared: false},
protocol_addresses: [{address: '<string>', source: '<string>', role: 'protocol'}]
})
};
fetch('https://app.blockgence.com/v1/incident', 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/incident",
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([
'chain' => 'ethereum',
'exploit_tx' => '<string>',
'victim' => '<string>',
'addresses' => [
'<string>'
],
'addresses_source' => '<string>',
'hops' => 2,
'fanout' => 4,
'since' => 0,
'window_days' => 123,
'max_credits' => 200,
'name' => '<string>',
'watch' => [
'create' => true,
'follow_hops' => true,
'shared' => false
],
'protocol_addresses' => [
[
'address' => '<string>',
'source' => '<string>',
'role' => 'protocol'
]
]
]),
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/incident"
payload := strings.NewReader("{\n \"chain\": \"ethereum\",\n \"exploit_tx\": \"<string>\",\n \"victim\": \"<string>\",\n \"addresses\": [\n \"<string>\"\n ],\n \"addresses_source\": \"<string>\",\n \"hops\": 2,\n \"fanout\": 4,\n \"since\": 0,\n \"window_days\": 123,\n \"max_credits\": 200,\n \"name\": \"<string>\",\n \"watch\": {\n \"create\": true,\n \"follow_hops\": true,\n \"shared\": false\n },\n \"protocol_addresses\": [\n {\n \"address\": \"<string>\",\n \"source\": \"<string>\",\n \"role\": \"protocol\"\n }\n ]\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/incident")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"chain\": \"ethereum\",\n \"exploit_tx\": \"<string>\",\n \"victim\": \"<string>\",\n \"addresses\": [\n \"<string>\"\n ],\n \"addresses_source\": \"<string>\",\n \"hops\": 2,\n \"fanout\": 4,\n \"since\": 0,\n \"window_days\": 123,\n \"max_credits\": 200,\n \"name\": \"<string>\",\n \"watch\": {\n \"create\": true,\n \"follow_hops\": true,\n \"shared\": false\n },\n \"protocol_addresses\": [\n {\n \"address\": \"<string>\",\n \"source\": \"<string>\",\n \"role\": \"protocol\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/incident")
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 \"chain\": \"ethereum\",\n \"exploit_tx\": \"<string>\",\n \"victim\": \"<string>\",\n \"addresses\": [\n \"<string>\"\n ],\n \"addresses_source\": \"<string>\",\n \"hops\": 2,\n \"fanout\": 4,\n \"since\": 0,\n \"window_days\": 123,\n \"max_credits\": 200,\n \"name\": \"<string>\",\n \"watch\": {\n \"create\": true,\n \"follow_hops\": true,\n \"shared\": false\n },\n \"protocol_addresses\": [\n {\n \"address\": \"<string>\",\n \"source\": \"<string>\",\n \"role\": \"protocol\"\n }\n ]\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
Job created. The response includes the job_id, the initial status of each step and idempotent_replay: false.