Structured Access

What stays free

All of the following are freely accessible to any reader, crawler, or agent, with no payment or registration required:

• Public health guides at /guides/*
• Posts at /posts/*
• Category and tag pages
• The homepage
• /llms.txt
• /sitemap.xml
• /robots.txt
• All other human-readable pages

Nothing about that changes. Public guides will remain free.

What structured access means

Structured access is not a paywall for human readers. It is a metered JSON layer for agents, apps, retrieval systems, and AI workflows that need cleaner, more consistent data than scraped HTML provides. The public site stays open. The structured API is a separate layer for machine clients.

Live preview endpoints

Three endpoint types are currently live on testnet/devnet rails. All return HTTP 402 on an unpaid request. Sending a valid payment header unlocks the structured JSON response.

A. Guide brief

A compact structured summary of a PatientGuide condition page — title, summary, key points, and metadata. Suitable for agent context windows, search augmentation, and health app integrations.

GET /api/x402/guide-brief?slug=hypertension        (Base Sepolia)
GET /api/x402/solana/guide-brief?slug=hypertension  (Solana Devnet)

B. Red flags

Machine-readable urgent-care signals associated with a condition guide. Educational only — not a diagnosis tool or emergency triage system. See the medical disclaimer below.

GET /api/x402/red-flags?slug=hypertension        (Base Sepolia)
GET /api/x402/solana/red-flags?slug=hypertension  (Solana Devnet)

C. Visit prep

Structured appointment-preparation checklists for patients before a healthcare visit. Covers what to track before the appointment, what to bring, questions to discuss with a clinician, and when to seek urgent help. Educational only — not a diagnosis, treatment plan, or triage tool. Currently supports selected high-priority guides: hypertension, stroke, early warning signs of a heart attack, atrial fibrillation, type 1 diabetes, asthma, sepsis, and depression.

GET /api/x402/visit-prep?slug=hypertension        (Base Sepolia)
GET /api/x402/solana/visit-prep?slug=hypertension  (Solana Devnet)

Payment rails available

Two testnet/devnet rails are live. These are for testing the concept, not production billing. No real funds are required.

What an unpaid request returns

Any request without a valid payment header returns HTTP 402 with an x402 payment descriptor. Example:

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:84532",
      "maxAmountRequired": "1000",
      "resource": "https://patientguide.io/api/x402/guide-brief?slug=hypertension"
    }
  ]
}

maxAmountRequired: "1000" is denominated in the smallest unit of USDC (6 decimals), meaning 0.001 USDC.

What a paid response contains

These are approximate field shapes. Exact fields may evolve during preview.

Guide brief

• slug — guide identifier
• title — guide title
• summary — short plain-text synopsis
• keyPoints — array of key points
• updatedDate — last revision date (ISO 8601)

Red flags

• slug — guide identifier
• title — guide title
• type — content type identifier
• redFlags — array of urgent-care signals
• disclaimer — medical disclaimer text

Visit prep

• slug — guide identifier
• title — guide title
• type — content type identifier
• whatToTrack — items to monitor before the appointment
• whatToBring — records and items to bring to the appointment
• questionsToAsk — suggested questions to discuss with a clinician
• whenToSeekUrgentHelp — symptoms that should not wait for a scheduled visit
• disclaimer — medical disclaimer text

Medical disclaimer

Structured data from these endpoints is educational and informational only. It is not a diagnosis, treatment plan, emergency triage tool, or substitute for professional medical care. Content describes general patterns associated with conditions — it does not evaluate any individual patient's situation. If symptoms are severe, sudden, or concerning, seek urgent medical help immediately.

Status and what's next

• Both testnet/devnet rails are verified end-to-end.
• Red flags and visit prep previews support selected high-priority guides: hypertension, stroke, early warning signs of a heart attack, atrial fibrillation, type 1 diabetes, asthma, sepsis, and depression.
• Unsupported slugs may return 404 after payment. More slugs may be added during preview.
• Mainnet access is coming soon. Mainnet is not currently live.
• Public health guides will always remain free.

Testing the x402 preview?

We welcome feedback from builders testing Base Sepolia, Solana Devnet, x402 clients, or agent payment flows.

Open a GitHub issue or reach out via the contact page. Useful things to include:

• Endpoint URL and rail (Base Sepolia or Solana Devnet)
• Client or tool used
• The 402 response or error you received
• Transaction hash or signature, if relevant

Please do not send private keys, seed phrases, keypair files, funded wallet credentials, or sensitive personal health information.

Related

• Hypertension guide
• /llms.txt — machine-readable content index for LLMs