Wallet Watch

Documentazione API

Integra i dati di Wallet Watch nelle tue applicazioni con la nostra REST API sicura

Important: Importante: Wallet Watch si riserva il diritto di rivedere e approvare tutte le richieste di accesso API. L'accesso è concesso a nostra discrezione basandoci sul caso d'uso previsto e sui requisiti di conformità.

Livelli Chiave API
Due livelli disponibili basati sulle esigenze di utilizzo
LIMITATO

20 richieste/mese

Livello gratuito

Reset mensile

ILLIMITATO

Nessun limite mensile

Livello enterprise

Soggetto ad approvazione

Sicurezza e Autenticazione
Chiavi hash SHA-256 con validazione sicura
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 e Autenticazione
Iniziare con l'API di Wallet Watch

Base URL

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

Authentication Header

x-api-key: your_api_key_here

Dettagli Tecnici

• 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

Ottieni Segnalazioni
Recupera segnalazioni wallet con opzioni di 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
}
Utilizzo API e Limiti
Dettagli di implementazione tecnica

Implementazione Limitazione Velocità

• 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

Esempi di Risposta di Errore

// 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"
}

Header delle Richieste

x-api-key: [your-64-char-api-key]Content-Type: application/jsonAccept: application/json
Endpoint Dati di Riferimento
Recupera categorie e criptovalute per il filtraggio

Categorie

GET
/categories

Restituisce tutte le categorie di attività illecite disponibili con ID, nome, descrizione e icona

Criptovalute

GET
/cryptocurrencies

Restituisce tutte le criptovalute supportate con ID, nome, simbolo e icona

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
}
Processo di Richiesta Accesso API
Come ottenere l'accesso API e i requisiti di approvazione

Access Approval Required: Approvazione Accesso Richiesta: Wallet Watch si riserva il diritto di rivedere, approvare o negare tutte le richieste di accesso API a nostra sola discrezione. Valutiamo le richieste basandoci sul caso d'uso previsto, sui requisiti di conformità e sulle considerazioni di sicurezza della piattaforma.

Processo di Richiesta

  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

Requisiti per l'Approvazione

• 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