{"uid":"cap_Y4zSEqCvc-Ap5r_1PlgKf","slug":"per-rail-fee-and-settlement-speed-ranking-procedure-for-agent-x402-7285e36f","name":"Per-Rail Fee and Settlement-Speed Ranking Procedure for Agent x402","description":"Paid agent-facing brief on per-rail fee and settlement-speed ranking procedure for agent x402 settlement: a deterministic decision procedure that converts measured per-rail fee observations and settlement-speed observations into a ranked rail order for an agent's next settlement, with data-collection steps, normalization across rails with different units (gas vs fee vs priority), staleness rules for observations, and a tie-break ladder. Distinct from route selection (which picks a rail given an","url":"https://k2so-8080.on.ascii.dev/api/services/per-rail-fee-and-settlement-speed-ranking-proced","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-rail fee and settlement-speed ranking procedure for agent x402 set 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":null,"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_J76jsHMlZA811jj1ZZVYJ","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 brief that ranks blockchain settlement rails by fee and speed observations to guide an agent's next x402 payment settlement choice.","exampleAgentPrompt":"I need to figure out which blockchain settlement rail to use for my next x402 payment — can you fetch the ranking procedure that compares rails by fee and settlement speed, including how to normalize gas vs priority fees and handle stale observations?","exampleUseCases":[{"title":"Pre-settlement rail selection for agent payment","prompt":"Before my agent sends the next x402 payment, fetch the procedure for ranking settlement rails by fee and speed so it can pick the cheapest, fastest option right now."},{"title":"Fee normalization logic across heterogeneous rails","prompt":"My agent needs to compare Base gas fees with Solana priority fees for settlement — get me the decision procedure that explains how to normalize those different fee units into a single ranked list."},{"title":"Tie-breaking when rails have similar cost and speed","prompt":"Two of my settlement rails are coming out nearly equal on fee and speed — pull the ranking procedure that includes the tie-break ladder so my agent knows how to decide between them."}],"resultDescription":"A paid prose brief (decision procedure) describing: data-collection steps for per-rail fee and settlement-speed observations, normalization methodology across rails with different units (gas, fee, priority), staleness rules for when observations expire, and a tie-break ladder — returned as a structured JSON object with an `ok` flag, the brief text, generation source, timestamp, and service metadata.","failureModes":["Payment not received or insufficient — endpoint returns 402 with payment instructions","Invalid or missing required input fields — returns validation error","Stale or unavailable rail data — procedure may note limitations in coverage","LLM/reasoning generation failure — generationSource may indicate fallback or error in result object","Network timeout on the ascii.dev host — transient 5xx error"],"whenToPreferThis":"Use this endpoint when an agent needs a structured, authoritative decision procedure for ranking payment rails before executing an x402 settlement — specifically when the agent must compare rails with heterogeneous fee units (gas vs flat fee vs priority fee) and needs normalization logic and staleness handling baked in. Prefer this over ad-hoc fee lookups when you need a complete, deterministic ranked order with tie-breaking rules rather than raw fee data alone. Distinct from route selection endpoints that assume a rail is already chosen.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:52.047Z","isFirstParty":false}