get402.ai

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "data": null,
  "meta": {
    "cached": false,
    "payment": null,
    "cached_at": null,
    "cost_usdc": "0",
    "request_id": "103dfd2e-6368-4fbe-95ec-d93878d66fd1",
    "upstream_status": null
  },
  "error": {
    "code": "payment_required",
    "message": "Payment is required."
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xB3b5Fb04B2Aef15baf18b121F49fF1DfD100Dd2E",
    "amount": "5000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "url": "https://example.com/page"
        }
      },
      "output": {
        "type": "json",
        "example": {
          "path": "/v1/fetch",
          "price": {
            "asset": "USDC",
            "payTo": "0xB3b5Fb04B2Aef15baf18b121F49fF1DfD100Dd2E",
            "amount": "0.005",
            "network": "base"
          },
          "errors": [
            {
              "code": "payment_required",
              "when": "No payment proof was sent.",
              "status": 402,
              "message": "Payment is required."
            },
            {
              "code": "payment_invalid",
              "when": "A proof was sent but verification failed.",
              "status": 402,
              "message": "The payment proof could not be verified."
            },
            {
              "code": "invalid_url",
              "when": "Missing, relative, or malformed url.",
              "status": 400,
              "message": "The url parameter must be an absolute http or https URL."
            },
            {
              "code": "blocked_target",
              "when": "Non-http(s) scheme, a private, link-local, or metadata address, or a host on the deny list, at any redirect hop.",
              "status": 400,
              "message": "Private, link-local and metadata addresses are not fetchable."
            },
            {
              "code": "blocked_by_robots",
              "when": "robots.txt disallows the get402 user agent for the path.",
              "status": 403,
              "message": "The target's robots.txt disallows this user agent for that path."
            },
            {
              "code": "rate_limited",
              "when": "Per-caller, per-target-host, or per-payer limit hit. Retry-After gives the seconds to wait. Never charged.",
              "status": 429,
              "message": "Rate limit exceeded."
            },
            {
              "code": "upstream_failed",
              "when": "DNS, connect, TLS, or read failure. A timeout uses the same code with HTTP 504.",
              "status": 502,
              "message": "The upstream request failed before a response."
            },
            {
              "code": "upstream_error",
              "when": "The target answered with 4xx or 5xx. meta.upstream_status carries that status.",
              "status": 502,
              "message": "The target returned an error."
            },
            {
              "code": "too_large",
              "when": "The hard cap was hit before extraction could succeed.",
              "status": 422,
              "message": "The body exceeded the size cap before enough content was read to extract."
            },
            {
              "code": "unsupported_content",
              "when": "The body is not HTML or plain text.",
              "status": 422,
              "message": "Only HTML and plain text can be extracted."
            },
            {
              "code": "extraction_empty",
              "when": "The fetch succeeded but extraction found no article body.",
              "status": 422,
              "message": "The page had no usable main content."
            },
            {
              "code": "not_found",
              "when": "Unknown request_id on the receipts route.",
              "status": 404,
              "message": "No request exists with that id."
            },
            {
              "code": "unavailable",
              "when": "Health check failed. error.message names the dependency.",
              "status": 503,
              "message": "A dependency is unavailable."
            },
            {
              "code": "internal",
              "when": "Unexpected failure in this service.",
              "status": 500,
              "message": "get402 failed while handling the request."
            }
          ],
          "method": "GET",
          "params": [
            {
              "name": "url",
              "required": true,
              "description": "Absolute http or https URL to fetch."
            },
            {
              "name": "fresh",
              "required": false,
              "description": "1 or true bypasses the cache and fetches now. Same price."
            },
            {
              "name": "max_bytes",
              "required": false,
              "description": "Cap on the downloaded body size. The server enforces its own maximum regardless."
            },
            {
              "name": "timeout_ms",
              "required": false,
              "description": "Hint. The server enforces its own upper bound."
            }
          ],
          "example_error": {
            "data": null,
            "meta": {
              "cached": false,
              "payment": null,
              "cached_at": null,
              "cost_usdc": "0",
              "request_id": "00000000-0000-4000-8000-000000000002",
              "upstream_status": null
            },
            "error": {
              "code": "blocked_target",
              "message": "Private, link-local and metadata addresses are not fetchable."
            }
          },
          "example_success": {
            "data": {
              "url": "https://example.com/page",
              "title": "Page title",
              "markdown": "# Page title\n\nExample body.",
              "final_url": "https://example.com/page",
              "truncated": false,
              "fetched_at": "2026-09-19T12:00:00.000Z",
              "word_count": 5,
              "description": null,
              "content_type": "text/html; charset=utf-8"
            },
            "meta": {
              "cached": false,
              "payment": {
                "asset": "USDC",
                "payer": "0x1111111111111111111111111111111111111111",
                "network": "base",
                "settlement_ref": "0x1111111111111111111111111111111111111111111111111111111111111111"
              },
              "cached_at": null,
              "cost_usdc": "0.005",
              "request_id": "00000000-0000-4000-8000-000000000001",
              "upstream_status": 200
            },
            "error": null
          }
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method"
          ],
          "properties": {
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "GET",
                "HEAD",
                "DELETE"
              ],
              "type": "string"
            },
            "queryParams": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "description": "Absolute http or https URL to fetch."
                },
                "fresh": {
                  "type": "string",
                  "description": "1 or true bypasses the cache and fetches now. Same price."
                },
                "max_bytes": {
                  "type": "string",
                  "description": "Cap on the downloaded body size. The server enforces its own maximum regardless."
                },
                "timeout_ms": {
                  "type": "string",
                  "description": "Hint. The server enforces its own upper bound."
                }
              }
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-10-21 22:19Z

Last indexed by Roundhouse

2026-10-26 13:16Z

Last enriched (probe, favicon, geo)

2026-10-01 05:45Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402