Datasource Pulse

[
  {
    "error": "This endpoint settles on POST only. GET and HEAD serve this payment envelope for discovery. POST the same path with an X-PAYMENT header to run a check.",
    "accepts": [
      {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x7cCb91a3ad4c45097bDA4C3C29d2Cc89fA93Ab36",
        "scheme": "exact",
        "network": "base",
        "mimeType": "application/json",
        "resource": "https://datasourcepulse.com/api/x402/check",
        "description": "One live health check on a data source, one instant machine-readable verdict. Monitor an Apify actor, API, or scraper for failures; check whether an API key silently failed; detect schema drift, stale data, empty results, dead credentials, rate limiting, and quota exhaustion. Validates keys for 35+ vendors (OpenAI, Anthropic, Stripe, GitHub and more), any HTTP endpoint, or a public Apify actor by id. Returns JSON: state, failure_class, message, recommended_action, latency_ms, metadata.",
        "outputSchema": {
          "input": {
            "type": "http",
            "method": "POST",
            "bodyType": "json",
            "bodyFields": {
              "url": {
                "type": "string",
                "description": "generic_http vendor (required): the public endpoint to check. Private, loopback, and internal addresses are rejected."
              },
              "type": {
                "enum": [
                  "credential",
                  "actor"
                ],
                "type": "string",
                "description": "Check mode. credential (default): validate an API key or HTTP endpoint. actor: health-check a public Apify actor by id. If omitted, inferred: actorId present means actor, otherwise credential."
              },
              "apiKey": {
                "type": "string",
                "description": "credential mode: the API key to validate. Used for one live vendor call, never stored."
              },
              "vendor": {
                "type": "string",
                "description": "credential mode (required): vendor template, e.g. openai, anthropic, gemini, stripe, github, serpapi, reddit, youtube, or generic_http for any HTTP endpoint. Unknown vendors return 400 with the full list location."
              },
              "actorId": {
                "type": "string",
                "description": "actor mode (required): Apify actor id, e.g. apify~web-scraper."
              },
              "clientId": {
                "type": "string",
                "description": "credential mode: OAuth client id, for vendors that use one."
              },
              "apifyToken": {
                "type": "string",
                "description": "actor mode (required): Apify API token with actor + run read access. Used for live reads, never stored."
              },
              "authHeader": {
                "type": "string",
                "description": "generic_http: full Authorization header value to send."
              },
              "bearerToken": {
                "type": "string",
                "description": "credential mode: bearer token, for vendors that use one."
              },
              "clientSecret": {
                "type": "string",
                "description": "credential mode: OAuth client secret, for vendors that use one."
              },
              "costSpikePct": {
                "type": "number",
                "description": "actor mode: cost spike threshold percent (default 50)."
              },
              "quotaSoftCap": {
                "type": "number",
                "description": "credential mode, optional: your own budget line in the vendor's native usage unit. Quota verdicts are evaluated against this cap instead of the vendor's billing wall."
              },
              "refreshToken": {
                "type": "string",
                "description": "google_oauth vendor only: OAuth2 refresh token, validated via a token refresh."
              },
              "volumeDropPct": {
                "type": "number",
                "description": "actor mode: volume drop threshold percent (default 30)."
              },
              "successJsonPath": {
                "type": "string",
                "description": "generic_http: dot-separated JSON path to assert on the response body."
              },
              "successJsonValue": {
                "type": "string",
                "description": "generic_http: expected string value at successJsonPath."
              },
              "successStatusCode": {
                "type": "number",
                "description": "generic_http: expected HTTP status (default 200)."
              },
              "enableCostBaseline": {
                "type": "boolean",
                "description": "actor mode: alert if per-run cost spikes vs the rolling average (default false)."
              },
              "enableVolumeBaseline": {
                "type": "boolean",
                "description": "actor mode: alert if latest output volume drops vs the rolling average of recent runs (default true)."
              },
              "stalenessThresholdDays": {
                "type": "number",
                "description": "actor mode: failing verdict when the actor has not been updated in this many days (default 30)."
              }
            },
            "discoverable": true
          },
          "output": {
            "type": "object",
            "required": [
              "state",
              "failure_class",
              "message",
              "checked_at",
              "latency_ms"
            ],
            "properties": {
              "state": {
                "enum": [
                  "healthy",
                  "warning",
                  "failing"
                ],
                "type": "string",
                "description": "The health verdict."
              },
              "checked": {
                "type": "object",
                "description": "Echo of what was checked: { type, vendor } or { type, actor_id }. Never echoes credentials."
              },
              "message": {
                "type": "string",
                "description": "Human-readable explanation of the verdict."
              },
              "metadata": {
                "type": "object",
                "description": "Probe-specific detail: quota percentages, run success rates, schema check results, baseline numbers."
              },
              "checked_at": {
                "type": "string",
                "description": "ISO 8601 timestamp of the check."
              },
              "latency_ms": {
                "type": "number",
                "description": "End-to-end probe latency in milliseconds."
              },
              "failure_class": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Machine-readable failure class: dead_token, quota_exhausted, rate_limited, timeout, unexpected_response, actor_failed, volume_drop, schema_drift, cost_spike, actor_stale. Null when healthy."
              },
              "recommended_action": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "What to do about it. Null when healthy."
              }
            }
          }
        },
        "maxAmountRequired": "20000",
        "maxTimeoutSeconds": 90
      }
    ],
    "x402Version": 1
  }
]