curl --request GET \
--url https://app.blockgence.com/v1/guard/watches/{wid}/hops \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/guard/watches/{wid}/hops"
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/guard/watches/{wid}/hops', 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/guard/watches/{wid}/hops",
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/guard/watches/{wid}/hops"
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/guard/watches/{wid}/hops")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/guard/watches/{wid}/hops")
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>"
}Derived watch tree
Returns the tree of derived watches the watch belongs to, with each hop followed or cut and its reason.
An adversary watch with the follow_hops rule enabled follows the funds that leave toward other accounts.
Guard accumulates per destination what the address sends, in native currency and priced tokens and excluding
noise. When a destination reaches min_usd (US$1,000 by default) and is a regular account without a label, Guard
creates a derived watch on it. The derived watch belongs to the same owner, inherits the rules and the sharing,
and monitors from the hop transaction. The depth (max_depth, 2 by default) and the number of derived watches
(max_derived, 10 by default) are set by the root watch. Each derived watch counts against the plan’s watch
limit.
The response includes:
root_watch_id: the root watch;watches[]:id,address,name,status,depth,derived_from,armed_block,armed_after_tx,open_alertsandlast_event_ts, with the root first;hops[]: each decision, withwatch_id(the watch that sent the funds),address,tx,block,usd,outcome(derivedorcut),reason,detail,derived_watch_id,retractedandnote;reasons: the text of each reason.
Cut reasons: labeled (a public label: exchange, bridge, router, mixer or known attacker), contract,
delegated_eoa (an account delegated through EIP-7702), block_builder, reserved, unpriced,
already_watched, own_watched (an own wallet monitored in the organization), max_depth, max_derived,
plan_limit, code_unreadable and code_budget (the destination’s code could not be read) and removed (the
derived watch was deleted and is not created again). Destinations cut for unpriced, max_derived,
plan_limit, code_unreadable or code_budget are evaluated again on the next outflow toward them.
If a chain reorganization removes the hop transaction, the hop becomes retracted and the derived watch is
paused until the transaction is included again.
It only includes what the requester can view: a derived watch the requester cannot view does not appear, nor
does its id. Returns 404 if the watch does not exist or the requester cannot view it. Requires an API key
assigned to a person (403).
Cost: free.
curl --request GET \
--url https://app.blockgence.com/v1/guard/watches/{wid}/hops \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/guard/watches/{wid}/hops"
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/guard/watches/{wid}/hops', 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/guard/watches/{wid}/hops",
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/guard/watches/{wid}/hops"
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/guard/watches/{wid}/hops")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/guard/watches/{wid}/hops")
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>"
}Authorizations
Headers
Path Parameters
Response
Successful response.