{"uid":"cap_7D7-gsutC7A24RHj_KqWL","slug":"lotus-network-gas-decision-journal-75e13258","name":"Lotus Network Gas Decision Journal","description":"Records an agent decision (execute now, or wait) against a fresh forecast snapshot and returns a decision_id plus the block at which the outcome becomes checkable. Nothing is predicted here beyond the snapshot: this is a tamper-evident journal entry so the agent can later prove what it knew and what it chose.","url":"https://lotusnetworkapi.com/api/v1/gas/decision","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"note":{"type":"string"},"stance":{"enum":["execute","wait"],"type":"string"},"maxFeeGwei":{"type":"number"},"horizonMinutes":{"type":"integer"}}},"responseSchema":{"type":"json","example":{"stance":"wait","success":true,"auditUrl":"https://lotusnetworkapi.com/api/v1/gas/audit/7c1f9a2b4d6e8f0a1b2c3d4e5f607182","snapshot":{"lowGwei":0.0106,"highGwei":0.0182,"baseFeeGwei":0.0142},"decisionId":"7c1f9a2b4d6e8f0a1b2c3d4e5f607182","recordedAt":"2026-07-30T04:12:00.000Z","auditableAt":"2026-07-30T04:27:00.000Z","targetBlock":24881453}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CYGIZrVyDc167e9m-oTju","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Records an agent's gas decision (execute or wait) against a current gas forecast snapshot, returning a tamper-evident decision_id and the block at which the outcome can be verified.","exampleAgentPrompt":"Log my gas decision to execute now against the current Base L2 gas snapshot — my max fee is 12 Gwei, my horizon is 10 minutes, and note that this is for a DeFi swap so I can prove later what conditions I acted on.","exampleUseCases":[{"title":"Audit-proof execute decision for DeFi swap","prompt":"Record that I've decided to execute my swap right now — max fee 8 Gwei, 5-minute horizon — and add a note 'USDC swap on Base' so I can prove what gas I saw if anyone challenges the timing later."},{"title":"Wait decision during gas spike","prompt":"Log a wait decision against today's Base L2 gas conditions, max fee 5 Gwei, 15-minute horizon, with the note 'deferring mint until gas drops' — I want a tamper-evident record that I chose not to act because fees were too high."},{"title":"Compliance journaling for automated agent fleet","prompt":"My agent just evaluated gas and decided to execute — commit that decision to the journal with a max fee of 20 Gwei over a 30-minute horizon and note 'automated batch settlement' so the decision is on record for compliance review."}],"resultDescription":"Returns a decision_id uniquely identifying this journal entry, plus the block number at which the outcome becomes checkable, allowing the agent to later verify and prove what gas conditions it observed and what action it committed to.","failureModes":["Invalid stance value (not 'execute' or 'wait') returns a 422 validation error","Missing required fields returns 400 bad request","Payment not included or incorrect USDC amount returns 402 Payment Required","Service unavailable if underlying gas snapshot feed is down","Duplicate rapid submissions may create multiple independent journal entries — not idempotent"],"whenToPreferThis":"Use this endpoint when an AI agent needs a tamper-evident, auditable record of a gas-related decision tied to a specific on-chain snapshot — particularly for compliance, post-hoc verification, or proving rational behavior. Prefer this over simple logging when proof-of-knowledge at a specific block is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:17.241Z","isFirstParty":false}