{"uid":"cap_zi6jf5s1kHOwPV7KBc1uP","slug":"per-use-research-acquisition-decision-procedure-k-2so-x402-269c7973","name":"Per-Use Research Acquisition Decision Procedure (K-2SO x402)","description":"A decision procedure for autonomous agents evaluating per-use access to premium financial research content via MPP/x402 micro-payments. Covers a task relevance gate, price versus expected insight value assessment, freshness and recency checks, licensing and redistribution boundaries including cache, citation and resale rights, research spend budget accounting, provider legitimacy verification, and a full purchase audit trail suitable for post-settlement reconstruction.","url":"https://k2so.wrong.systems/api/services/per-use-research-acquisition-decision-procedure?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":"Per-use research acquisition decision procedure 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":"per-use-research-acquisition-decision-procedure","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"per-use-research-acquisition-decision-procedure","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":"down","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_DE0hOWBfqbKNgGqKr38GD","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 an AI-generated decision procedure brief guiding agents on when and how to acquire research, paid via x402 USDC microtransaction on Base.","exampleAgentPrompt":"Give me a decision procedure brief on when and how an AI agent should acquire research — I want clear prose guidance I can embed in my agent's logic, and I'm happy to pay the per-use USDC fee via x402.","exampleUseCases":[{"title":"Embedding research policy in an agent","prompt":"My agent needs to know when it's justified to pay for research data vs. rely on what it already has — can you pull the per-use research acquisition decision procedure and give me the prose brief I can paste into its system prompt?"},{"title":"Evaluating a custom research topic","prompt":"I'm building an agent that buys market reports. Can you fetch the research acquisition decision procedure with the topic set to 'competitive intelligence reports' so I get a tailored brief on how my agent should evaluate those purchases?"},{"title":"Auditing an agent's data-buying logic","prompt":"I want to audit whether my autonomous agent's current research-buying behavior matches best practice — run the per-use research acquisition decision procedure and show me the full decision brief it returns."}],"resultDescription":"A JSON object containing a plain-prose decision procedure brief (120+ words) advising agents on research acquisition, along with metadata: topic, model used, generation source (llm/reasoning/deterministic), ISO-8601 timestamp, service slug, and provider name (K-2SO). Payment confirmation fields (paid, payer, transaction) are also included.","failureModes":["HTTP 402 returned if no valid x402 USDC payment is attached — agent must settle exact $0.002 USDC and retry with PAYMENT-SIGNATURE header","Invalid or expired payment signature returns 402 or 401","Malformed query parameters (e.g. invalid meta value) may return 400","LLM generation failure may return ok:false in the result object with no brief","Network or agent merchant downtime returns 5xx"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a structured, prose-form decision procedure specifically about research acquisition — not just raw data, but actionable guidance on whether and how to buy information. Prefer it over static documentation or generic LLM prompts when you want a paid, versioned, on-demand brief that is machine-callable via x402 and returns a consistently structured JSON response with generation metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T22:28:31.844Z","isFirstParty":false,"canonicalSlug":"per-use-research-acquisition-decision-procedure-k-2so-x402-269c7973"}