Webhooks

{
  "id": "wh_abc123xyz",
  "url": "https://your-app.com/webhooks/fintool",
  "events": ["filing.new", "earnings_call.new"],
  "filters": {
    "tickers": ["AAPL", "MSFT", "GOOGL", "AMZN", "NVDA"],
    "doc_types": ["8-K", "10-K", "10-Q"]
  },
  "secret": "whsec_a1b2c3d4e5f6...",
  "status": "active",
  "created_at": "2025-01-15T10:30:00Z"
}

{
  "webhooks": [
    {
      "id": "wh_abc123xyz",
      "url": "https://your-app.com/webhooks/fintool",
      "events": ["filing.new", "earnings_call.new"],
      "filters": {
        "tickers": ["AAPL", "MSFT", "GOOGL", "AMZN", "NVDA"],
        "doc_types": ["8-K", "10-K", "10-Q"]
      },
      "status": "active",
      "created_at": "2025-01-15T10:30:00Z",
      "last_triggered_at": "2025-01-15T14:22:00Z"
    }
  ]
}

{
  "event": "filing.new",
  "timestamp": "2025-01-15T14:22:00Z",
  "data": {
    "publication_id": "0000320193-25-000042",
    "ticker": "AAPL",
    "company_name": "Apple Inc.",
    "doc_type": "8-K",
    "title": "Current Report",
    "filing_date": "2025-01-15",
    "items": ["Item 2.02", "Item 9.01"],
    "url": "https://api.fintool.com/v1/documents/0000320193-25-000042",
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000042"
  }
}

import hmac
import hashlib
from flask import Flask, request

app = Flask(__name__)

WEBHOOK_SECRET = "whsec_your_secret_here"

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    """Verify the webhook signature"""
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

@app.post("/webhooks/fintool")
def handle_webhook():
    signature = request.headers.get("X-Fintool-Signature")

    if not verify_webhook(request.data, signature, WEBHOOK_SECRET):
        return {"error": "Invalid signature"}, 401

    event = request.json

    if event["event"] == "filing.new":
        process_new_filing(event["data"])
    elif event["event"] == "earnings_call.new":
        process_earnings_call(event["data"])

    return {"received": True}, 200

def process_new_filing(data):
    print(f"New filing: {data['ticker']} - {data['doc_type']}")
    # Your processing logic here

def process_earnings_call(data):
    print(f"New earnings call: {data['ticker']}")
    # Your processing logic here

const crypto = require('crypto');
const express = require('express');

const app = express();
const WEBHOOK_SECRET = 'whsec_your_secret_here';

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(`sha256=${expected}`),
    Buffer.from(signature)
  );
}

app.post('/webhooks/fintool', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-fintool-signature'];

  if (!verifyWebhook(req.body, signature, WEBHOOK_SECRET)) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  const event = JSON.parse(req.body);

  switch (event.event) {
    case 'filing.new':
      console.log(`New filing: ${event.data.ticker} - ${event.data.doc_type}`);
      break;
    case 'earnings_call.new':
      console.log(`New earnings call: ${event.data.ticker}`);
      break;
  }

  res.json({ received: true });
});