Developer Documentation

# Find high-yield Aave supply events
curl -H "X-API-Key: def_xxx" \
  "https://defeyes-api.vercel.app/api/events?protocol=Aave%20V3&action_type=SUPPLY&apy_min=5"

# Export 100 enriched events as CSV
curl -H "X-API-Key: def_xxx" \
  "https://defeyes-api.vercel.app/api/events/export?format=csv&limit=100" \
  -o high_yield_events.csv

# Get wallet profile
curl -H "X-API-Key: def_xxx" \
  "https://defeyes-api.vercel.app/api/wallets/0x4cdba844ceb949567e3dbf94c5b0f7b3c8e5d2a1"

{
  "status": "ok",
  "time": "2026-01-05T08:00:00.000Z"
}

{
  "status": "ok",
  "chainId": 4078,
  "blockNumber": 12345678,
  "rpcUrl": "https://mainnet-rpc.rnk.dev"
}

{
  "status": "ok",
  "database": "connected",
  "total_events": 31239,
  "last_event": "2026-01-05T08:00:00.000Z"
}

curl -H "X-API-Key: def_xxx" \
  "https://defeyes-api.vercel.app/api/usage"

# Quote a premium-fresh request (last 5 minutes)
curl -X POST "https://defeyes-api.vercel.app/api/x402/quote" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"/api/events","params":{"time_range":"5m","limit":100}}'

# Create webhook for large WETH swaps
curl -X POST "https://defeyes-api.vercel.app/api/webhooks" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: def_xxx" \
  -d '{
    "url": "https://your-app.com/webhooks/defeyes",
    "description": "Large WETH swap alerts",
    "filters": {
      "action_types": ["SWAP"],
      "token_symbol": "WETH",
      "min_value_token": 10.0
    }
  }'

curl -H "X-API-Key: def_xxx" \
  "https://defeyes-api.vercel.app/api/webhooks"

# Pause a webhook
curl -X PUT "https://defeyes-api.vercel.app/api/webhooks/550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: def_xxx" \
  -d '{"status": "paused"}'

curl -X DELETE \
  "https://defeyes-api.vercel.app/api/webhooks/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: def_xxx"

curl -X POST \
  "https://defeyes-api.vercel.app/api/webhooks/550e8400-e29b-41d4-a716-446655440000/test" \
  -H "X-API-Key: def_xxx"

curl -H "X-API-Key: def_xxx" \
  "https://defeyes-api.vercel.app/api/webhooks/550e8400-e29b-41d4-a716-446655440000/logs?limit=50"

# Headers included in webhook POST
Content-Type: application/json
X-Webhook-Signature: sha256=abc123...  # HMAC signature for verification
X-Webhook-Id: 550e8400-e29b-41d4-a716-446655440000
X-Webhook-Timestamp: 1704451200

{
  "event": {
    "id": 12345,
    "ref_tx_hash": "0xabc123...",
    "block_number": 417390882,
    "origin_user": "0x259B6b9C...",
    "protocol_name": "Aave V3 Pool",
    "action_type": "SUPPLY",
    "method_name": "supply",
    "token_in_symbol": "WETH",
    "token_in_amount": 10.5,
    "amount_usd": 25500.00,
    "apy_percent": 5.23,
    "timestamp": "2026-01-05T08:00:00Z",
    "enriched_at": "2026-01-05T08:00:01Z"
  },
  "webhook_id": "550e8400-e29b-41d4-a716-446655440000",
  "delivered_at": "2026-01-05T08:00:02Z"
}

# Flask webhook receiver
from flask import Flask, request, jsonify
import hmac
import hashlib

app = Flask(__name__)
WEBHOOK_SECRET = "whsec_..."  # Store securely

@app.route('/webhooks/defeyes', methods=['POST'])
def handle_webhook():
    # Verify signature
    signature = request.headers.get('X-Webhook-Signature', '').replace('sha256=', '')
    payload = request.get_data()
    
    expected = hmac.new(
        WEBHOOK_SECRET.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    
    if signature != expected:
        return jsonify({"error": "Invalid signature"}), 401
    
    # Process event
    event = request.json['event']
    
    if event['action_type'] == 'SWAP' and event['amount_usd'] > 10000:
        # Trigger your trading logic
        print(f"Large swap detected: {event['ref_tx_hash']}")
    
    return jsonify({"status": "ok"}), 200

if __name__ == '__main__':
    app.run(port=5000)

// Express webhook receiver
const express = require('express');
const crypto = require('crypto');
const app = express();

const WEBHOOK_SECRET = 'whsec_...';  // Store securely

app.use(express.json());

app.post('/webhooks/defeyes', (req, res) => {
  // Verify signature
  const signature = req.headers['x-webhook-signature']?.replace('sha256=', '');
  const payload = JSON.stringify(req.body);
  
  const expected = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(payload)
    .digest('hex');
  
  if (signature !== expected) {
    return res.status(401).json({ error: 'Invalid signature' });
  }
  
  // Process event
  const event = req.body.event;
  
  if (event.action_type === 'SWAP' && event.amount_usd > 10000) {
    console.log(`Large swap: ${event.ref_tx_hash}`);
    // Your trading logic here
  }
  
  res.json({ status: 'ok' });
});

app.listen(5000, () => {
  console.log('Webhook receiver listening on port 5000');
});

# Create webhook programmatically
import requests

API_KEY = "def_xxx"
API_BASE = "https://defeyes-api.vercel.app"

# Create webhook
response = requests.post(
    f"{API_BASE}/api/webhooks",
    headers={"X-API-Key": API_KEY},
    json={
        "url": "https://your-app.com/webhooks/defeyes",
        "description": "Monitor large swaps",
        "filters": {
            "action_types": ["SWAP"],
            "min_value_token": 1000.0
        }
    }
)

webhook = response.json()['webhook']
print(f"Webhook created: {webhook['id']}")
print(f"Secret: {webhook.get('secret', 'Check API response')}")