curl --request GET \
--url https://app.blockgence.com/v1/token/{chain}/{addr} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/token/{chain}/{addr}"
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/token/{chain}/{addr}', 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/token/{chain}/{addr}",
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/token/{chain}/{addr}"
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/token/{chain}/{addr}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/token/{chain}/{addr}")
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>"
}Ficha de un token
Devuelve la ficha de un token EVM, pensada para investigar un posible rug pull. Toda la ficha se lee a un mismo
bloque (state_block) y cada dato cita su transacción, su bloque, su log y su fuente.
Campos principales:
token: nombre, símbolo, decimales y suministro total, leídos del contrato.deployer: quién firmó la creación, el creador directo, la fábrica si la hubo y su primer fondeo (funding). Un fondeador con etiqueta (exchange, puente, mezclador) se informa, pero no vincula a nadie.contract: los permisos del contrato (verGET /v1/contract/{chain}/{addr}).related: las cuentas vinculadas al token, cada una con el motivo del vínculo.pools: los pools de Uniswap V2, Uniswap V3, PancakeSwap V3 y sus forks registrados, con cada agregado y retiro de liquidez y quién lo hizo. Se listan los 50 más antiguos y se lee la liquidez de los 8 más antiguos.mints,sales(ventas de las cuentas vinculadas) yfreeze(llamadas a funciones de congelamiento).key_balances: los saldos del token de las cuentas de la ficha. Los tenedores principales no se listan.signals: hechos que suelen acompañar a un rug pull (retiro de liquidez por una cuenta vinculada, venta de una cuenta vinculada, venta después de un mint, compradores congelados). Son contexto probabilístico, cada uno con su evidencia, nunca un veredicto: los proyectos legítimos también hacen esas operaciones. Un retiro de liquidez trae enfollowel pedido para seguir esos fondos conPOST /v1/tracetx.reasons,coverage,not_coveredydegraded_sources.coverage.history.read: falsesignifica que en esa red no se leyó la historia de eventos: la ausencia de pools o mints no significa que no existan.
No cubre: los tenedores principales, los pools de otras familias, el dueño de una posición de Uniswap V3, el precio en USD ni los honeypots que no usan una lista de bloqueo del propio token.
Errores: una red no EVM, una dirección inválida o que no es un contrato a ese bloque, o un bloque futuro
responden 400. En las redes donde no se puede leer el estado de un bloque anterior, pedir block responde
503 sin cobro, nunca con el dato actual.
Costo: 25 créditos de base. Algunas operaciones cobran menos si reutilizan un resultado guardado; nunca más.
curl --request GET \
--url https://app.blockgence.com/v1/token/{chain}/{addr} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/token/{chain}/{addr}"
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/token/{chain}/{addr}', 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/token/{chain}/{addr}",
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/token/{chain}/{addr}"
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/token/{chain}/{addr}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/token/{chain}/{addr}")
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>"
}Autorizaciones
Encabezados
Parámetros de ruta
Parámetros de consulta
Modo evaluación, para analizar un incidente pasado sin información posterior. Con true, exige block (el anterior al hecho), no cita etiquetas de registros de incidentes ni etiquetas propias, y declara lo excluido en el campo eval_mode de la respuesta. Valor por defecto: false.
Respuesta
La ficha del token.