Wallet Watch

Documentación de API

Integra datos de Wallet Watch en tus aplicaciones con nuestra API REST segura

Important: Importante: Wallet Watch se reserva el derecho de revisar y aprobar todas las solicitudes de acceso a la API. El acceso se otorga a nuestra discreción basándose en el caso de uso previsto y los requisitos de cumplimiento.

Niveles de Clave API
Dos niveles disponibles según las necesidades de uso
LIMITADO

20 solicitudes/mes

Nivel gratuito

Reinicio mensual

ILIMITADO

Sin límites mensuales

Nivel empresarial

Sujeto a aprobación

Seguridad y Autenticación
Claves hash SHA-256 con validación segura
256-bit API keys with SHA-256 hashing
Monthly usage tracking and enforcement
Automatic rate limit reset cycle
Request logging and audit trail
URL Base y Autenticación
Comenzando con la API de Wallet Watch

Base URL

https://your-domain.com/api/public

Authentication Header

x-api-key: your_api_key_here

Detalles Técnicos

• API keys are 64-character hexadecimal strings (256-bit)

• Keys are hashed using SHA-256 before storage

• Limited tier: 20 requests per calendar month with automatic reset

• Unlimited tier: No monthly restrictions (enterprise only)

• All API responses use standard HTTP status codes

• Request/response content-type: application/json

Obtener Reportes
Recuperar reportes de billeteras con opciones de filtro
GET
/submissions

Query Parameters

limitintegerResults limit (1-500, default: 100)
categoryIdstringFilter by category ID (optional)
cryptocurrencyIdstringFilter by cryptocurrency ID (optional)
searchTermstringSearch in wallet addresses (optional)

Example Request

GET /api/public/submissions?limit=10&searchTerm=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

Example Response

{
  "submissions": [
    {
      "id": "cm1234567890",
      "walletAddress": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "category": {
        "id": "cat123",
        "name": "Phishing",
        "icon": "AlertTriangle"
      },
      "cryptocurrency": {
        "id": "btc",
        "name": "Bitcoin",
        "symbol": "BTC"
      },
      "reason": "Used in phishing attack targeting crypto users",
      "websiteUrl": "https://fake-exchange.scam",
      "reportedOwner": "Scammer Name",
      "status": "approved",
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "total": 1,
  "limit": 10
}
Uso de API y Límites
Detalles de implementación técnica

Implementación de Limitación de Velocidad

• Limited Tier: 20 requests per calendar month

• Reset Mechanism: Monthly counter automatically resets on the first day of each month

• Usage Tracking: Each successful API call increments the usage counter

• Enforcement: Requests exceeding the limit receive HTTP 401 with error message

Ejemplos de Respuesta de Error

// Monthly limit exceeded (Limited tier)
{
  "message": "Monthly API limit exceeded (20 requests/month)"
}

// Invalid API key
{
  "message": "Invalid API key"
}

// Missing API key
{
  "message": "API Key is required"
}

Encabezados de Solicitud

x-api-key: [your-64-char-api-key]Content-Type: application/jsonAccept: application/json
Endpoints de Datos de Referencia
Recuperar categorías y criptomonedas para filtrado

Categorías

GET
/categories

Devuelve todas las categorías de actividad ilícita disponibles con ID, nombre, descripción e ícono

Criptomonedas

GET
/cryptocurrencies

Devuelve todas las criptomonedas soportadas con ID, nombre, símbolo e ícono

Example Response Structure

// Categories endpoint
{
  "categories": [
    {
      "id": "cat123",
      "name": "Phishing",
      "description": "Fraudulent websites...",
      "icon": "AlertTriangle"
    }
  ]
}

// Cryptocurrencies endpoint
{
  "cryptocurrencies": [
    {
      "id": "btc",
      "name": "Bitcoin",
      "symbol": "BTC",
      "icon": "bitcoin-icon"
    }
  ]
}
Error Responses
Understanding API error codes
400Bad RequestInvalid or missing parameters
401UnauthorizedMissing or invalid API key
429Rate LimitedToo many requests
500Server ErrorInternal server error

Error Response Format

{
  "success": false,
  "error": "Invalid API key",
  "code": 401
}
Proceso de Solicitud de Acceso a API
Cómo obtener acceso a la API y requisitos de aprobación

Access Approval Required: Aprobación de Acceso Requerida: Wallet Watch se reserva el derecho de revisar, aprobar o denegar todas las solicitudes de acceso a la API a nuestra sola discreción. Evaluamos las solicitudes basándose en el caso de uso previsto, requisitos de cumplimiento y consideraciones de seguridad de la plataforma.

Proceso de Solicitud

  1. Contact us through our Contact page with your API access request
  2. Provide detailed information about your intended use case and integration plans
  3. Include information about your organization, compliance requirements, and data handling practices
  4. Wait for our team to review your request (review process may take 5-10 business days)
  5. If approved, receive your API key and tier assignment
  6. Begin integration with proper authentication and rate limit compliance

Requisitos para Aprobación

• Legitimate business use case for crypto fraud prevention or research

• Compliance with applicable data protection and privacy laws

• Commitment to responsible use of API data

• Technical capability to properly integrate and handle rate limits

• Agreement to our Terms of Use and API usage policies