{"uid":"cap_hz_apVYLVCS87d3QOgtE_","slug":"x402-per-article-paywall-pricing-unit-and-retention-selection-45179cdb","name":"x402 Per-Article Paywall Pricing Unit and Retention Selection","description":"Deterministic procedure for a content publisher that must decide how to price premium articles behind an HTTP 402 paywall. Inputs: article production cost, expected reads per article, reader return frequency, competitor price per article, refund chargeback rate, and the publisher's target revenue per reader. Steps: 1) classify the content as one-off value (news, analysis), reference value (docs, tutorials), or serial value (fiction, columns) to choose the default unit; 2) price per-read as cost","url":"https://k2so.wrong.systems/api/services/x402-per-article-paywall-pricing-unit-and-retent?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"x402 per-article paywall pricing unit and retention selection paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"x402-per-article-paywall-pricing-unit-and-retent","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"x402-per-article-paywall-pricing-unit-and-retent","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bo1Sb0uk4KrEkMrdU9vxI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a deterministic decision procedure for pricing premium articles behind an HTTP 402 paywall, including content classification, per-read pricing, and reader retention unit selection.","exampleAgentPrompt":"I'm a content publisher setting up an HTTP 402 paywall for my news articles — each piece costs about $50 to produce, I expect 200 reads per article, readers come back weekly, my competitor charges $0.10 per article, my chargeback rate is 2%, and I want to earn $0.30 per reader. Walk me through the right pricing unit and price point.","exampleUseCases":[{"title":"Pricing a news analysis paywall","prompt":"I run a political analysis blog and I'm setting up an x402 paywall. Each article costs $80 to produce, I expect about 150 reads per piece, readers visit roughly once a week, competitors charge $0.15 per article, my refund rate is 1.5%, and I want to earn $0.40 per reader. What pricing unit and price should I use?"},{"title":"Choosing pricing model for a tutorial site","prompt":"I publish technical tutorials and I'm wondering whether to charge per-read or use some other unit for my x402 paywall. My production cost per tutorial is $200, I expect 500 reads, readers come back monthly, competitors charge $0.25, chargeback rate is 3%, and my target revenue per reader is $0.50. What does the decision procedure say?"},{"title":"Serial fiction paywall unit selection","prompt":"I'm launching a serialized fiction site with an HTTP 402 paywall. Each chapter costs $30 to write, I expect 300 reads per chapter, readers return weekly, similar sites charge $0.05 per chapter, my chargeback rate is 0.5%, and I need $0.20 revenue per reader. Should I use per-read, episode, or some other unit?"}],"resultDescription":"A JSON response containing a plain-prose decision procedure (120+ words) that classifies the content type, recommends a pricing unit, suggests a per-read price, and outlines a retention strategy. Includes metadata: service slug, provider name, ISO-8601 generation timestamp, generation source (llm, reasoning, or deterministic), and the topic used.","failureModes":["Missing or malformed query parameters may result in a generic rather than tailored procedure","Payment not included returns HTTP 402 with payment instructions rather than the procedure","Invalid topic override may cause fallback to default classification logic","LLM generation source may produce variable output on repeated calls despite deterministic framing"],"whenToPreferThis":"Choose this endpoint when a content publisher or agent needs a structured, opinionated decision procedure for x402 per-article paywall pricing — especially when classifying content type (news vs. docs vs. serial fiction) matters for unit selection. Prefer this over generic pricing calculators when operating within the x402 HTTP payment ecosystem and needing prose guidance an agent can act on directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:43:07.352Z","isFirstParty":false,"canonicalSlug":"x402-per-article-paywall-pricing-unit-and-retention-selection-45179cdb"}