Guía rápida

Haz tu primera llamada a la API en 3 pasos.

Paso 1 — Obtén tu API key

Ingresa a tu panel, ve a API Keys y crea una nueva clave. La clave solo se muestra una vez — guárdala de inmediato.

Paso 2 — Haz tu primera llamada

curl -X POST \
  'https://apiscanner-3f4k2fa2ca-uc.a.run.app/v1/api/evaluate/wallet' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wa_live_TU_CLAVE_AQUI' \
  -d '{"address": "TKjUN5z7dDdr1ovU2KTu3EG6SzZKYc3zZX"}'

const response = await fetch('https://apiscanner-3f4k2fa2ca-uc.a.run.app/v1/api/evaluate/wallet', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'wa_live_TU_CLAVE_AQUI'
  },
  body: JSON.stringify({
    address: 'TKjUN5z7dDdr1ovU2KTu3EG6SzZKYc3zZX'
  })
});

const data = await response.json();
console.log(data.data.overview.riskLevel); // "LOW" | "MEDIUM" | "HIGH"

Paso 3 — Interpreta la respuesta

{
  "ok": true,
  "code": "WALLET_EVALUATED",
  "data": {
    "wallet": {
      "address": "TKjUN5z7dDdr1ovU2KTu3EG6SzZKYc3zZX",
      "trxBalance": 4.47,
      "usdtBalance": 320.00
    },
    "overview": {
      "riskLevel": "LOW",     // LOW | MEDIUM | HIGH
      "riskScore": 3,
      "probability": 0.031
    },
    "walletScoring": {
      "walletHealthScore": 87,   // 0–100
      "walletCategory": "EXCELLENT"
    }
  }
}

Autenticación

Todas las llamadas requieren una API key válida en el header x-api-key.

x-api-key: wa_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Formato de la clave

Las API keys de Wallet Alert siguen el formato wa_live_ seguido de 32 caracteres alfanuméricos. Cada key está asociada a tu plan y tiene límites de uso diario y mensual.

Errores de autenticación

Wallet360 — Análisis completo

Endpoint principal para análisis profundo de una wallet TRON: riesgo Bayes, salud, tokens, contrapartes, allowances, seguridad y recomendaciones.

{
  "address": "TKjUN5z7dDdr1ovU2KTu3EG6SzZKYc3zZX"
}

curl -X POST \
  'https://apiscanner-3f4k2fa2ca-uc.a.run.app/v1/api/evaluate/wallet' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wa_live_TU_CLAVE' \
  -d '{"address":"TKjUN5z7dDdr..."}'

{
  "ok": true,
  "code": "WALLET_EVALUATED",
  "data": {
    "generatedAt": "2026-03-29T22:13:08.000Z",
    "wallet": {
      "address": "TKjUN5z7dDdr1ovU2KTu3EG6SzZKYc3zZX",
      "trxBalance": 4.47,
      "usdtBalance": 320.00
    },
    "overview": {
      "riskLevel": "LOW",       // LOW | MEDIUM | HIGH
      "riskScore": 3,          // 0–100
      "probability": 0.031,    // 0.0–1.0
      "reasons": ["Emisor antiguo (180+ días)"]
    },
    "walletScoring": {
      "walletHealthScore": 87,       // 0–100
      "walletCategory": "EXCELLENT",  // EXCELLENT | GOOD | FAIR | RISKY | DANGEROUS
      "creditStyleExplanation": {
        "label": "Wallet excelente",
        "summary": "Sin señales de riesgo significativas.",
        "driversPositive": ["Wallet antigua y activa"],
        "driversNegative": []
      }
    },
    "security": {
      "securityCheck": { "status": "valid" },
      "contractCheck": { "isContract": false },
      "allowanceCheck": { "hasDangerousAllowance": false }
    },
    "recommendations": [
      "La wallet no muestra señales críticas inmediatas."
    ],
    "tokens": [],
    "transactions": [...]
  }
}

TX Risk — Evaluación rápida

Evaluación ligera de riesgo de una wallet o contexto transaccional. Próximamente disponible.

Análisis Avanzado

Módulo extendido con análisis de contrapartes profundo, grafo de relaciones y señales adicionales.

Códigos de error

La API retorna errores estructurados con un campo code machine-readable y message legible.

{
  "ok": false,
  "code": "INVALID_TRON_ADDRESS",
  "message": "invalid tron address"
}

Límites por plan

Cada plan tiene un límite de llamadas diarias y mensuales, y habilita diferentes scopes de la API.

Buenas prácticas

Recomendaciones para integrar la API de forma segura y eficiente.