All workflows

Rate Limit Plan

Plan request batches under per-minute and optional per-hour API limits with explicit timestamps and remaining work.

1 credit per call · $0.002 USDC with x402

Sample input

{
  "requests": 180,
  "per_minute": 60
}

Worked sample output

{
  "ok": true,
  "mode": "rate_limit_plan",
  "requests": 180,
  "effective_per_minute": 60,
  "batch_count": 3,
  "batches": [
    {
      "batch": 1,
      "scheduled_at": "2026-09-30T21:22:14.219Z",
      "requests": 60
    },
    {
      "batch": 2,
      "scheduled_at": "2026-09-30T21:23:14.219Z",
      "requests": 60
    },
    {
      "batch": 3,
      "scheduled_at": "2026-09-30T21:24:14.219Z",
      "requests": 60
    }
  ],
  "truncated": false,
  "remaining_requests": 0
}

Worked example using published sample data only. Own-data execution is paid.

Connect in curl

Set BOUNTY_API_KEY privately after your payment is verified. Change the retry key for each new logical request.

curl 'https://bounty-engineer-x402-prod.onrender.com/v1/prepaid/rate-limit-plan' \
  -H "Authorization: Bearer $BOUNTY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: workflow-request-001' \
  -H 'X-Max-Credits: 1' \
  --data '{"requests":180,"per_minute":60}'

Connect in n8n

Download the inactive n8n template. Import it, configure the private Header Auth credential, inspect the sample and run it manually. A new execution creates a new billable request; there is no automatic schedule.

Use an HTTP POST to https://bounty-engineer-x402-prod.onrender.com/v1/prepaid/rate-limit-plan. Send JSON and these headers; store the Bearer token as a private credential.

{
  "method": "POST",
  "headers": {
    "Authorization": "Bearer YOUR_PRIVATE_API_KEY",
    "Content-Type": "application/json",
    "Idempotency-Key": "UNIQUE_PER_LOGICAL_REQUEST",
    "X-Max-Credits": "1"
  },
  "body": {
    "requests": 180,
    "per_minute": 60
  }
}

Reuse a retry key only for the same input. Failed execution returns reserved credits. Full integration and recovery guide · Machine-readable recipe