---
title: "x402-protected demo endpoint"
method: GET
path: "/api/payments/x402/demo"
tags: ["agent-rpc"]
---

# x402-protected demo endpoint

`GET /api/payments/x402/demo`

Returns HTTP 402 with x402 payment requirements when no payment header is present. When a payment header is present, returns a demo stub response without verifying settlement. Use this endpoint to inspect x402 negotiation; production paid endpoints live at x402.quicknode.com.

## Response `200`

Demo stub response when a payment header is present.

- X402DemoQuote
  - `ok` boolean, required
  - `message` string, required
  - `docs` string, uri, required

## Other responses

- `402` — Payment Required (x402)

## Changes

- **2026-08-23** `dfb483c5f33e` — 3 info
  - added the required property `docs` to the response with the `200` status
  - added the required property `message` to the response with the `200` status
  - added the required property `ok` to the response with the `200` status

[Change history](https://skmtc.dev/quicknode/apis/quicknode-agent-api/changes/api/payments/x402/demo/get.md)

---

[API](https://skmtc.dev/quicknode/apis/quicknode-agent-api.md) · [All operations](https://skmtc.dev/quicknode/apis/quicknode-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quicknode/quicknode-agent-api/revisions/dfb483c5f33e/schema)