API de rastreo de wallets cripto con webhooks para cada transferencia
Monitoriza cualquier dirección en Bitcoin, Ethereum, Solana, Tron, BNB Chain y Polygon. Cada transferencia entrante y saliente de BTC, ETH, SOL, TRX, BNB, POL, USDT y USDC se registra y se envía a tu servidor como webhook.
- Seis blockchains con una API y un formato de webhook
- Transferencias entrantes y salientes de monedas, USDT y USDC
- Sin comisión por evento en ningún plan
Monitorización de direcciones blockchain sin operar un nodo
Un rastreador de wallets vigila una dirección de blockchain y te avisa cuando se mueve dinero. LirChain lee cada bloque nuevo en seis redes, selecciona las transferencias que tocan las direcciones que rastreas y convierte cada una en un evento que puedes ver en el panel, leer por la API o recibir como webhook.
No necesitas la clave privada de la wallet, y no tiene por qué ser tuya: se puede rastrear cualquier dirección pública. Por eso el rastreador sirve para vigilar tu propia tesorería y tus wallets frías, las wallets de socios y proveedores o las direcciones que te dan tus usuarios.
Una sola petición y un solo formato de webhook cubren las seis redes. Añadir el seguimiento de USDT en Tron o de USDC en Solana a una aplicación que ya rastrea wallets de Ethereum es cambiar un campo, no hacer una integración nueva.
Qué te ofrece Rastreador de wallets
Seis blockchains, una API
Las wallets de Bitcoin, Ethereum, Solana, Tron, BNB Chain y Polygon se rastrean con la misma petición y se notifican en el mismo formato.
Transferencias entrantes y salientes
Se notifican ambas direcciones, para la moneda propia de cada red y para las stablecoins USDT y USDC.
Webhooks con reintentos automáticos
Cada transferencia se envía a tu endpoint HTTPS como JSON en cuanto se confirma, y se reenvía cada minuto hasta que tu servidor la acepta.
Tu propio id en cada evento
Etiqueta una dirección rastreada con tu id de usuario, cuenta o wallet y recíbelo en cada webhook, así los eventos encajan con tus registros sin consultas extra.
Solo transferencias confirmadas
Un evento se crea cuando la transferencia está confirmada de forma segura en su cadena. Una transacción fallida nunca se notifica.
Importes legibles
Cada evento trae los valores propios de la cadena (dirección del contrato e importe en la unidad mínima) junto al símbolo del token y el importe en unidades enteras.
Cómo funciona
Del registro a la primera llamada en unos minutos.
- 1
Crea un proyecto Wallet Tracker
Regístrate, abre el proyecto Wallet Tracker en el panel y copia su clave de API. Las cuentas nuevas empiezan en el plan Free.
- 2
Añade las direcciones que quieres rastrear
Envía la red y la dirección, con tu propio id para ella si quieres. La dirección se comprueba según las reglas de su red antes de aceptarse.
- 3
Recibe un webhook por cada transferencia
Configura una URL de webhook en el proyecto y cada transferencia confirmada hacia o desde una wallet rastreada se envía a ella. El historial completo sigue disponible en el panel y por la API.
curl https://api.lirchain.com/merchant/wallet-tracker/create \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"network": "ethereum",
"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"external_id": "treasury"
}'const API_KEY = "YOUR_API_KEY";
async function createWalletTracker(params) {
const response = await fetch("https://api.lirchain.com/merchant/wallet-tracker/create", {
method: "POST",
headers: { "x-api-key": API_KEY, "content-type": "application/json" },
body: JSON.stringify(params),
});
if (!response.ok) {
throw new Error(`LirChain API ${response.status}: ${await response.text()}`);
}
return response.json();
}
const result = await createWalletTracker({
network: "ethereum",
address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
external_id: "treasury",
});const API_KEY = "YOUR_API_KEY";
type CreateWalletTrackerParams = {
network: string;
address: string;
external_id?: string;
};
type CreateWalletTrackerResult = {
id: string;
project_id: string;
merchant_id: string;
network: string;
address: string;
external_id: string | null;
};
async function createWalletTracker(params: CreateWalletTrackerParams): Promise<CreateWalletTrackerResult> {
const response = await fetch("https://api.lirchain.com/merchant/wallet-tracker/create", {
method: "POST",
headers: { "x-api-key": API_KEY, "content-type": "application/json" },
body: JSON.stringify(params),
});
if (!response.ok) {
throw new Error(`LirChain API ${response.status}: ${await response.text()}`);
}
return response.json();
}
const result = await createWalletTracker({
network: "ethereum",
address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
external_id: "treasury",
});import requests
API_KEY = "YOUR_API_KEY"
def create_wallet_tracker(**params):
response = requests.post(
"https://api.lirchain.com/merchant/wallet-tracker/create",
headers={"x-api-key": API_KEY},
json=params,
timeout=30,
)
response.raise_for_status()
return response.json()
result = create_wallet_tracker(
network="ethereum",
address="0xdAC17F958D2ee523a2206206994597C13D831ec7",
external_id="treasury",
)<?php
const API_KEY = "YOUR_API_KEY";
function create_wallet_tracker(array $params): array
{
$curl = curl_init("https://api.lirchain.com/merchant/wallet-tracker/create");
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($params),
CURLOPT_HTTPHEADER => ["x-api-key: " . API_KEY, "content-type: application/json"],
]);
$body = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if ($body === false || $status >= 400) {
throw new Exception("LirChain API $status: $body");
}
return json_decode($body, true);
}
$result = create_wallet_tracker([
"network" => "ethereum",
"address" => "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"external_id" => "treasury",
]);package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
const apiKey = "YOUR_API_KEY"
func CreateWalletTracker(params map[string]any) (map[string]any, error) {
body, err := json.Marshal(params)
if err != nil {
return nil, err
}
request, err := http.NewRequest("POST", "https://api.lirchain.com/merchant/wallet-tracker/create", bytes.NewReader(body))
if err != nil {
return nil, err
}
request.Header.Set("x-api-key", apiKey)
request.Header.Set("content-type", "application/json")
response, err := http.DefaultClient.Do(request)
if err != nil {
return nil, err
}
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil {
return nil, err
}
if response.StatusCode >= 400 {
return nil, fmt.Errorf("LirChain API %d: %s", response.StatusCode, data)
}
var result map[string]any
return result, json.Unmarshal(data, &result)
}
func main() {
result, err := CreateWalletTracker(map[string]any{
"network": "ethereum",
"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"external_id": "treasury",
})
fmt.Println(result, err)
}{
"type": "wallet-tracker",
"event": {
"id": "95e04e32-5c98-4f68-8c62-f487bda0ed5c",
"tracker_id": "67153a22-af19-4352-ab8e-041006c76c7b",
"external_id": "treasury",
"project_id": "ea54aa6c-21d7-46a4-b1fe-c0703f74a2af",
"created_ms": 1791504120904
},
"transfer": {
"network": "ethereum",
"block_number": 26151012,
"tx_hash": "0x4e3a…9f21",
"log_index": "28",
"from_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"to_address": "0x52ae0f1c8d4b7a90e3b6c2d15f8a47e09b3c91f3",
"asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "102870865",
"symbol": "USDC",
"amount_units": "102.870865"
}
}Todos los endpoints y campos están en la referencia de la API de Rastreador de wallets (en inglés). ¿Usas un agente de programación? Dale lirchain.com/llms-full.txt y podrá escribir la integración por ti.
Blockchains y tokens que puedes rastrear
En cada red el rastreador notifica la moneda propia de la red, y USDT y USDC donde existen.
| Red | Monedas y tokens |
|---|---|
| Ethereum | USDTUSDCETH |
| BNB Chain | USDTUSDCBNB |
| Polygon | USDTUSDCPOL |
| Tron | USDTUSDCTRX |
| Solana | USDTUSDCSOL |
| Bitcoin | BTC |
Para qué usan los equipos Rastreador de wallets
Monitorización de tesorería y wallets frías
Entérate de cada movimiento en las wallets de la empresa en cuanto se confirma, sin que nadie refresque un explorador de bloques.
Detección de depósitos en tus propias direcciones
¿Ya generas las direcciones tú mismo? Rastréalas y acredita a tus usuarios cuando llegue el webhook.
Alertas de wallets y bots
Reenvía los webhooks del rastreador a Telegram, Discord o Slack para crear alertas de wallets para tu equipo o tu comunidad.
Contabilidad y auditoría
Mantén una lista completa y con fecha de lo que cada wallet recibió y envió, lista para la conciliación.
Liquidación con socios y contrapartes
Ve el momento en que paga un proveedor, un cliente o una contraparte OTC, en cualquiera de las seis cadenas que use.
Aplicaciones de portafolio y analítica
Lleva a tu producto las transferencias en vivo de las wallets de tus usuarios sin mantener nodos de seis blockchains.
Precios de Rastreador de wallets
Los eventos del rastreador no tienen comisión. El plan fija cuántas wallets rastreas y cuántos eventos se notifican cada 30 días.
| Plan | Free | Starter | Business | Enterprise |
|---|---|---|---|---|
| Precio al mes | Gratis | $19.99 | $49.99 | $249.99 |
| Wallets rastreadas | 5 | 1000 | 20.000 | 1.000.000 |
| Eventos cada 30 días | 30 | 10.000 | 200.000 | 10.000.000 |
| Comisión por evento | Ninguna | Ninguna | Ninguna | Ninguna |
Cada plan incluye los cuatro productos. Comparar los planes
Rastreador de wallets: preguntas y respuestas
- ¿En qué blockchains puedo rastrear wallets?
- Bitcoin, Ethereum, Solana, Tron, BNB Chain (BSC) y Polygon. Las seis se rastrean con la misma API y se notifican en el mismo formato de webhook.
- ¿Qué monedas y tokens notifica el rastreador de wallets?
- La moneda propia de cada cadena (BTC, ETH, SOL, TRX, BNB y POL) y las stablecoins USDT y USDC en Ethereum, Solana, Tron, BNB Chain y Polygon.
- ¿Necesito la clave privada de la wallet o un nodo propio?
- No. Un rastreador solo necesita la dirección pública, así que puedes monitorizar cualquier wallet, tuya o de otra persona. LirChain lee las blockchains por ti, de modo que no hay ningún nodo que operar ni mantener sincronizado.
- ¿Cuánto tarda en enviarse el webhook tras una transacción?
- En cuanto la transferencia está confirmada de forma segura: 12 bloques en Ethereum, BNB Chain y Polygon, 20 bloques en Tron, 3 bloques en Bitcoin y transacciones finalizadas en Solana. En la mayoría de las redes es cuestión de uno o dos minutos.
- ¿El rastreador de wallets es gratis?
- Sí, el plan Free rastrea 5 wallets y notifica 30 eventos cada 30 días, sin tarjeta. Starter rastrea 1000 wallets y notifica 10.000 eventos por $19.99 al mes. No hay comisión por evento en ningún plan.
- ¿Qué pasa si mi servidor no recibe un webhook?
- Si tu servidor no responde con un estado 2xx, el mismo webhook se vuelve a enviar cada minuto, hasta 20 veces, siempre con la misma cabecera x-webhook-id para que puedas ignorar uno que ya procesaste. Además, cada evento queda en el panel y en la lista de eventos de la API.
- ¿Desde cuándo se notifican las transferencias?
- Desde el momento en que añades el rastreador. Cada transferencia confirmada después se registra y se envía a tu webhook.
Funciona con el resto de LirChain
Una cuenta, un saldo y una API para los cuatro productos.
Empieza gratis con Rastreador de wallets
Las cuentas nuevas empiezan en el plan Free, con todos los productos incluidos y sin tarjeta.