DocsWebhooks & API

Webhooks & API

Subscribe to events, receive webhooks, and integrate via HTTP APIs.

Wolvo provides a comprehensive REST API and webhook system for integrating with external services, building custom dashboards, and creating advanced automation pipelines.

Base URL: https://api.wolvo.io/v1

Authentication

All API requests require authentication via API key or wallet signature:

API Key Authentication
# Include API key in header
curl -X GET https://api.wolvo.io/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Generate API Key
// Via SDK
const apiKey = await client.apiKeys.create({
  name: 'Production Key',
  permissions: ['read', 'write'],
  expiresIn: '90d'
})

console.log('API Key:', apiKey.key)  // Only shown once!

REST API Reference

GET/workflows
POST/workflows
GET/workflows/:id
PUT/workflows/:id
DELETE/workflows/:id
POST/workflows/:id/activate
GET/signals
GET/modules
POST/webhooks
Example: Create Workflow
curl -X POST https://api.wolvo.io/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Price Alert",
    "trigger": {
      "type": "signal",
      "source": "price-feeds",
      "condition": "price > 100"
    },
    "actions": [{
      "type": "webhook",
      "url": "https://your-server.com/alert"
    }]
  }'

Webhook Events

Receive real-time notifications when events occur in Wolvo:

workflow.executed

Workflow completed execution

workflow.failed

Workflow execution failed

signal.received

New signal received

anomaly.detected

Anomaly detected in signals

module.error

Module threw an error

api_key.expiring

API key expiring soon

Webhook Payload
{
  "event": "workflow.executed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "workflow_id": "wf_abc123",
    "workflow_name": "Price Alert",
    "execution_id": "exec_xyz789",
    "status": "success",
    "duration_ms": 45,
    "trigger": {
      "type": "signal",
      "signal_id": "sig_def456"
    },
    "output": {
      "actions_executed": 2,
      "results": [...]
    }
  },
  "signature": "sha256=..."  // Verify webhook authenticity
}

Rate Limits

API rate limits vary by plan:

PlanRequests/minWebhooks/day
Starter601,000
Pro30010,000
EnterpriseCustomUnlimited

Rate Limit Headers: Check X-RateLimit-Remaining andX-RateLimit-Reset headers in API responses.