{"service":"Signal Forge Fetch","version":"0.1.0","status":"pilot","endpoint":"/x402/fetch","method":"POST","description":"One public static HTML page to bounded Markdown with source URLs, retrieval time and content hash. No account or API key. No JavaScript, login, paywall or CAPTCHA bypass. Unsupported pages fail before settlement.","tags":["web","fetch","markdown"],"input_schema":{"type":"object","additionalProperties":false,"required":["url","request_key"],"properties":{"url":{"type":"string","pattern":"^https?://","maxLength":2048},"request_key":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]+$"},"max_chars":{"type":"integer","minimum":1000,"maximum":24000,"default":12000}}},"output_schema":{"type":"object","additionalProperties":false,"required":["schema_version","request_id","source_url","final_url","title","markdown","retrieved_at","published_at","content_sha256","source_status","content_chars","truncated","untrusted_content","quality","timing","replay"],"properties":{"schema_version":{"const":"1.0"},"request_id":{"type":"string","minLength":1,"maxLength":128},"source_url":{"type":"string","maxLength":2048},"final_url":{"type":"string","maxLength":2048},"title":{"type":"string","maxLength":500},"markdown":{"type":"string","minLength":80,"maxLength":24000},"retrieved_at":{"type":"string","minLength":20,"maxLength":40},"published_at":{"type":"null"},"content_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"source_status":{"type":"integer","minimum":200,"maximum":299},"content_chars":{"type":"integer","minimum":80,"maximum":24000},"truncated":{"const":false},"untrusted_content":{"const":true},"quality":{"type":"object","additionalProperties":false,"required":["status","method","warnings"],"properties":{"status":{"const":"usable"},"method":{"enum":["readability","document"]},"warnings":{"type":"array","items":{"type":"string"}}}},"timing":{"type":"object","additionalProperties":false,"required":["source_fetch_ms","extraction_ms"],"properties":{"source_fetch_ms":{"type":"integer","minimum":0},"extraction_ms":{"type":"integer","minimum":0}}},"replay":{"type":"boolean"}}},"error_schema":{"type":"object","required":["error"],"properties":{"request_id":{"type":"string"},"error":{"type":"object","required":["code","message","retryable","settlement_status"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"settlement_status":{"enum":["not_settled","unknown","settled"]}}}}},"example_request":{"url":"https://signalforgestudios.com/capabilities/","request_key":"example-job-000001","max_chars":12000},"example_response":{"schema_version":"1.0","request_id":"example-only","source_url":"https://example.com/","final_url":"https://example.com/","title":"Example","markdown":"# Example\n\nThis synthetic response illustrates the contract only. It is not an actual page fetch, settlement, performance measurement or customer result.","retrieved_at":"2026-10-02T00:00:00.000Z","published_at":null,"content_sha256":"8f5771012a0d69b586ff3fcb1d3ece5d4f489d7e63f8d331d76bb02804d8036b","source_status":200,"content_chars":153,"truncated":false,"untrusted_content":true,"quality":{"status":"usable","method":"document","warnings":["Synthetic example only."]},"timing":{"source_fetch_ms":0,"extraction_ms":0},"replay":false},"examples_are_synthetic":true,"payment":{"scheme":"exact","network":"eip155:8453","asset":"USDC","price_usd":0.005,"amount":"5000","payTo":"0x7e4d786057930b66cb45e2017a587425ebade587","payment_required":true},"retry":"Keep request_key and the original PAYMENT-SIGNATURE header. Successful response recovery lasts 24h. Unknown settlement requires reconciliation, not a fresh payment.","freshness":"Every new job retrieves the page; replays preserve the original retrieved_at timestamp.","latency":{"paid_p95_ms":null,"paid_sample_count":0,"target_p95_ms":5000,"target_only":true},"limits":{"source_bytes":1048576,"markdown_chars":24000,"redirects":3,"source_timeout_ms":8000,"extraction_timeout_ms":2500,"notes":"Headerless or merged-cell tables and known obfuscated body text are unsupported. Content that exceeds max_chars is rejected, not clipped. HTML selection is not a factual-accuracy guarantee."},"privacy":"Completed responses and source URLs are held privately for 24h after confirmed settlement. Unresolved settlements retain their response until reconciliation. Payment bindings and transaction metadata are retained; raw HTML and payment signatures are not logged."}