NexFlow Pulse

Cloud Scheduler for Agents and APIs

Schedule HTTP calls with per-execution billing (0.0015 USDC) and x402-ready payments.

---

What is NexFlow Pulse?

NexFlow Pulse is a production-grade HTTP scheduler designed for:

• 🤖 AI Agents – Schedule callbacks, keep-alive pings, and task triggers
• 🔄 API Automation – Cron-style HTTP requests without managing infrastructure
• 📡 Webhooks – Reliable delivery with automatic retries and exponential backoff
• 💰 Pay-per-use – Only pay for executions at $0.0015 USDC each

Key Features

Feature	Description
Interval Scheduling	Run jobs every N seconds (min: 1 second)
Cron Scheduling	Standard cron expressions for complex schedules
Automatic Retries	Configurable retry count with exponential backoff
Execution Tracking	Full history of job runs with HTTP status, latency, and errors
Test Runs	Fire a job immediately without affecting its schedule
x402 Ready	Supports wallet-based payments for autonomous agents

---

Quick Start

1. Get an API Key

Sign up at nexflowapp.app to get your API key.

2. Create Your First Job

curl -X POST https://api.nexflowapp.app/v1/pulse/jobs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "targetUrl": "https://httpbin.org/post",
    "method": "POST",
    "scheduleType": "interval",
    "intervalSeconds": 60,
    "body": { "message": "Hello from Pulse!" }
  }'

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "active",
  "nextRunAt": "2026-01-09T22:00:00.000Z",
  "billableExecutions": 0,
  "estimatedCostUsdc": 0
}

3. Check Job Runs

curl https://api.nexflowapp.app/v1/pulse/jobs/550e8400-e29b-41d4-a716-446655440000/runs \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Pricing

Metric	Cost
Per execution	$0.0015 USDC
Storage	Free
API calls	Free

Only successful and failed executions are billed. Paused jobs incur no charges.

---

Documentation

• Overview – Concepts, job lifecycle, and best practices
• API Reference – Endpoint documentation
• OpenAPI Spec – Machine-readable API specification
• x402 Integration – Wallet-based payments for agents

---

Examples

• Node.js/TypeScript – Create and monitor jobs
• HTTP Examples – Raw HTTP requests for testing

---

Use Cases

🤖 Agent Task Markets

Schedule callbacks for AI agents participating in task markets like Virtuals Protocol ACP:

{
  "targetUrl": "https://my-agent.example.com/callback",
  "method": "POST",
  "scheduleType": "interval",
  "intervalSeconds": 300,
  "body": { "action": "check_tasks" }
}

🔔 Keep-Alive Pings

Ensure your services stay healthy with regular heartbeat checks:

{
  "targetUrl": "https://my-service.example.com/health",
  "method": "GET",
  "scheduleType": "interval",
  "intervalSeconds": 60
}

📊 Scheduled Reports

Generate daily reports at a specific time:

{
  "targetUrl": "https://api.example.com/generate-report",
  "method": "POST",
  "scheduleType": "cron",
  "cronExpression": "0 9 * * *"
}

---

API Base URL

https://api.nexflowapp.app/v1/pulse

---

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Or use the X-API-Key header:

X-API-Key: YOUR_API_KEY

---

Rate Limits

Limit	Value
Jobs per account	1,000
Minimum interval	1 second
Request body size	64 KB
Custom headers size	8 KB

---

Support

• 📧 Email: [email protected]
• 🐦 Twitter: @NexFlowApp
• 💬 Discord: Join our community

---

License

This documentation is licensed under MIT.

---

Built with ❤️ by the NexFlow team