{"uid":"cap_BbZTChcZXgILDLnT2HhuP","slug":"rail-fee-digest-a61d94d2","name":"Rail Fee Digest","description":"Weekly digest of rail economics for x402/MPP payments: per-rail transfer fees, facilitator bps, live Base gas, last-week settlement volume by rail/facilitator/product, sampled transfer gas, and an LLM-composed signal. Cache is 7 days so each paid call is a fresh weekly read.","url":"https://k2so.wrong.systems/api/services/rail-fee-digest?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":{"days":{"type":"string","default":"7","description":"Composite input. Optional (default: 7)"},"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"Rail Fee Digest 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"},"score":{"type":"number"},"service":{"type":"string","description":"Service slug"},"summary":{"type":"string"},"evidence":{"type":"object"},"strengths":{"type":"array","items":{"type":"string"}},"confidence":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"riskFactors":{"type":"array","items":{"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,"service":"rail-fee-digest"},"service":"rail-fee-digest","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_soyDbg6-Gwh3XpI-2njvv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a weekly digest of x402/MPP rail economics including per-rail transfer fees, facilitator basis points, live Base gas prices, last-week settlement volumes, and an LLM-composed signal.","exampleAgentPrompt":"Pull me the latest weekly rail fee digest — I want to see per-rail transfer fees, facilitator basis points, live Base gas, last week's settlement volumes, and the LLM signal on what it all means.","exampleUseCases":[{"title":"Routing decision based on current rail fees","prompt":"Before I commit to routing this batch of micropayments, can you pull the current x402 rail fee digest so I can see which rail has the lowest transfer fees and facilitator bps right now?"},{"title":"Weekly rail economics monitoring for treasury","prompt":"Every Monday morning, grab the rail fee digest and tell me how settlement volumes and facilitator fees shifted compared to what I'd expect — include the LLM signal and any risk factors."},{"title":"Gas cost benchmarking for x402 agent stack","prompt":"What's the live Base gas price and sampled transfer gas cost for x402 rails this week? I need the full digest including the confidence score and any strengths or weaknesses flagged."}],"resultDescription":"A JSON object with ok/paid status, a result object containing a service slug, an LLM-composed summary, an evidence object, strengths and risk factors arrays, a confidence string, a numerical score, a generatedAt ISO-8601 timestamp, and payment metadata. The digest is cached for 7 days so each paid call returns a fresh weekly read.","failureModes":["Payment not processed — returns 402 with payment instructions","Cache miss on a new week — may incur slightly higher latency for first call of the week","Invalid days parameter — falls back to default of 7","meta=1 flag returns free metadata JSON without payment but no digest data","Network or provider error returns ok:false with error detail"],"whenToPreferThis":"Choose this endpoint when you need a structured, regularly-refreshed (weekly) digest of x402/MPP rail economics in a single paid call, especially when you want an LLM-composed signal alongside raw fee and volume data. Prefer this over building your own aggregation when you need facilitator bps, Base gas, settlement volume by rail/facilitator/product, and a synthesized risk/confidence assessment in one response. The 7-day cache ensures freshness without redundant charges.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T14:26:24.238Z","isFirstParty":false,"canonicalSlug":"rail-fee-digest-a61d94d2"}