curl --request POST \
--url https://app.blockgence.com/v1/counterparties \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"address": "<string>",
"chain": "ethereum",
"direction": "both",
"since": 0,
"temporal": true,
"win_start": 0,
"win_end": 0,
"min_usd": 1,
"offset": 0,
"limit": 20,
"include_tokens": true,
"read_more": 0,
"until": 0
}
'import requests
url = "https://app.blockgence.com/v1/counterparties"
payload = {
"address": "<string>",
"chain": "ethereum",
"direction": "both",
"since": 0,
"temporal": True,
"win_start": 0,
"win_end": 0,
"min_usd": 1,
"offset": 0,
"limit": 20,
"include_tokens": True,
"read_more": 0,
"until": 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({
address: '<string>',
chain: 'ethereum',
direction: 'both',
since: 0,
temporal: true,
win_start: 0,
win_end: 0,
min_usd: 1,
offset: 0,
limit: 20,
include_tokens: true,
read_more: 0,
until: 0
})
};
fetch('https://app.blockgence.com/v1/counterparties', 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/counterparties",
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([
'address' => '<string>',
'chain' => 'ethereum',
'direction' => 'both',
'since' => 0,
'temporal' => true,
'win_start' => 0,
'win_end' => 0,
'min_usd' => 1,
'offset' => 0,
'limit' => 20,
'include_tokens' => true,
'read_more' => 0,
'until' => 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/counterparties"
payload := strings.NewReader("{\n \"address\": \"<string>\",\n \"chain\": \"ethereum\",\n \"direction\": \"both\",\n \"since\": 0,\n \"temporal\": true,\n \"win_start\": 0,\n \"win_end\": 0,\n \"min_usd\": 1,\n \"offset\": 0,\n \"limit\": 20,\n \"include_tokens\": true,\n \"read_more\": 0,\n \"until\": 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/counterparties")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"address\": \"<string>\",\n \"chain\": \"ethereum\",\n \"direction\": \"both\",\n \"since\": 0,\n \"temporal\": true,\n \"win_start\": 0,\n \"win_end\": 0,\n \"min_usd\": 1,\n \"offset\": 0,\n \"limit\": 20,\n \"include_tokens\": true,\n \"read_more\": 0,\n \"until\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/counterparties")
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 \"address\": \"<string>\",\n \"chain\": \"ethereum\",\n \"direction\": \"both\",\n \"since\": 0,\n \"temporal\": true,\n \"win_start\": 0,\n \"win_end\": 0,\n \"min_usd\": 1,\n \"offset\": 0,\n \"limit\": 20,\n \"include_tokens\": true,\n \"read_more\": 0,\n \"until\": 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>"
}Todas las contrapartes de una address (paginado) — revelar las ocultas del fan-out
Universo completo de contrapartes de una address, agregado y paginado. NO
está capado por fan-out (trae hasta el máximo del provider), así se revelan las
contrapartes que el rastreo dejó afuera. Respeta consistencia temporal (since)
y devuelve cada contraparte ya etiquetada (label/category) para el grafo. Si la fuente no
puede leer la address → 503 (nunca «0 contrapartes»).
Límites de la fuente (transfer_limits: Bitquery en bsc trae solo salidas y, en plan free,
solo lo reciente): con direction=in y una fuente que no lee entradas no hay nada que responder
→ 503 sin cobro (antes: 200 con total 0, cobrado); con out/both la respuesta sale y el límite
va en degraded_sources.
Lectura enfocada: con direction=out y consistencia temporal, una address que no entra
en el tope de filas se completa desde la llegada de los fondos (focus_after), con el mismo piso que el nodo del
/trace (engine._focus: since o, si es posterior, win_start). Hasta acá se leía desde la punta: en una
address con mucha actividad posterior faltaban justo las salidas que siguen a la llegada, que el nodo sí había
leído, y el «+N» (hidden_out) no cuadraba con lo revelado. Lo que queda sin leer antes de la llegada va en
transfers.truncated_outside, como en el /trace.
La lectura del nodo, entera: since, until, include_tokens y read_more
son los que el nodo publica en reveal, y la lectura es la de su nodo en las TRES direcciones: con in o both,
since también enfoca la lectura (no filtra las entradas), y un padre (until) se completa hacia atrás desde su
última salida, como lo leyó el /trace. Así los cortes que trae revelar son los de la lectura del nodo y
la UI los puede sumar a su cobertura sin más: hasta esa versión, revelar las entradas de un nodo hacia adelante leía
desde la punta y le sumaba el corte entero de esa lectura como un tramo sin leer DENTRO del rastro, elegible para
«leer más», que relee hacia adelante. Los límites de las dos direcciones van una vez cada uno: los que viajan
con la lectura valen para las dos y both los declaraba dos veces.
Notables: la lectura pasa el is_terminal del rastreo como keep, con el alcance de
labels de quien pide, así una contraparte notable chica sobrevive al filtro de polvo como en el /trace.
Costo: 4 créditos de base (solo si la respuesta es < 400; algunas rutas cobran menos si reusan un resultado guardado).
curl --request POST \
--url https://app.blockgence.com/v1/counterparties \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"address": "<string>",
"chain": "ethereum",
"direction": "both",
"since": 0,
"temporal": true,
"win_start": 0,
"win_end": 0,
"min_usd": 1,
"offset": 0,
"limit": 20,
"include_tokens": true,
"read_more": 0,
"until": 0
}
'import requests
url = "https://app.blockgence.com/v1/counterparties"
payload = {
"address": "<string>",
"chain": "ethereum",
"direction": "both",
"since": 0,
"temporal": True,
"win_start": 0,
"win_end": 0,
"min_usd": 1,
"offset": 0,
"limit": 20,
"include_tokens": True,
"read_more": 0,
"until": 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({
address: '<string>',
chain: 'ethereum',
direction: 'both',
since: 0,
temporal: true,
win_start: 0,
win_end: 0,
min_usd: 1,
offset: 0,
limit: 20,
include_tokens: true,
read_more: 0,
until: 0
})
};
fetch('https://app.blockgence.com/v1/counterparties', 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/counterparties",
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([
'address' => '<string>',
'chain' => 'ethereum',
'direction' => 'both',
'since' => 0,
'temporal' => true,
'win_start' => 0,
'win_end' => 0,
'min_usd' => 1,
'offset' => 0,
'limit' => 20,
'include_tokens' => true,
'read_more' => 0,
'until' => 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/counterparties"
payload := strings.NewReader("{\n \"address\": \"<string>\",\n \"chain\": \"ethereum\",\n \"direction\": \"both\",\n \"since\": 0,\n \"temporal\": true,\n \"win_start\": 0,\n \"win_end\": 0,\n \"min_usd\": 1,\n \"offset\": 0,\n \"limit\": 20,\n \"include_tokens\": true,\n \"read_more\": 0,\n \"until\": 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/counterparties")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"address\": \"<string>\",\n \"chain\": \"ethereum\",\n \"direction\": \"both\",\n \"since\": 0,\n \"temporal\": true,\n \"win_start\": 0,\n \"win_end\": 0,\n \"min_usd\": 1,\n \"offset\": 0,\n \"limit\": 20,\n \"include_tokens\": true,\n \"read_more\": 0,\n \"until\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/counterparties")
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 \"address\": \"<string>\",\n \"chain\": \"ethereum\",\n \"direction\": \"both\",\n \"since\": 0,\n \"temporal\": true,\n \"win_start\": 0,\n \"win_end\": 0,\n \"min_usd\": 1,\n \"offset\": 0,\n \"limit\": 20,\n \"include_tokens\": true,\n \"read_more\": 0,\n \"until\": 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>"
}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).
Cuerpo
Todas las contrapartes de UNA address, agregadas y paginadas. A diferencia del trace (capado por fan-out), acá se ve el universo completo de contrapartes (hasta lo que trae el provider), para revelar las que el rastreo dejó afuera.
Respuesta
Successful Response