Webhooks

Real-time event notifications for treasury operations. Webhook support is under development.

Webhook support is under development

We are building webhook support to notify your external systems of treasury events. Check back soon for updates.

Overview

Webhooks will notify external systems of treasury events as they occur. Instead of polling the API, you can register a URL and receive HTTP POST requests when events happen.

Planned Events

transfer.completed— Outbound transfer finished successfully
transfer.failed— Transfer failed (insufficient balance, etc.)
inflow.detected— Incoming funds detected in treasury
wallet.created— New treasury wallet deployed

Example Webhook Payload

Webhook payloads will be JSON objects with an event type, timestamp, and data payload:

Example payloadjson

{
  "id": "evt_abc123",
  "type": "transfer.completed",
  "created_at": "2025-03-04T12:00:00Z",
  "data": {
    "transfer_id": "tx_xyz789",
    "venture_id": "v_venture123",
    "amount": "1000000",
    "currency": "USDC",
    "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "status": "completed"
  }
}