{"uid":"cap_84MhEEjiG47reAr4ykh51","slug":"bounty-engineer-agent-run-ledger-bbef39ff","name":"Bounty Engineer Agent Run Ledger","description":"Machine-buyable infrastructure for autonomous agents: API cost routing, margin optimization, funding-rate data, webpage extraction, result verification, spend controls, retry planning, state, tender search and GitHub bounty intelligence.","url":"https://bounty-engineer-x402-prod.onrender.com/v1/run-ledger?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"op":{"enum":["append","checkpoint","read"],"type":"string"},"data":{},"limit":{"type":"integer","maximum":100,"minimum":1},"run_id":{"type":"string"},"event_id":{"type":"string"},"event_type":{"type":"string"},"ttl_seconds":{"type":"integer","minimum":30},"namespace_key":{"type":"string"}}},"responseSchema":{"type":"json","example":{"ok":true,"op":"append","mode":"agent_run_ledger","data_hash":"...","stream_id":"..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0Y7vcMSnU-RmNgSeVBOUF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Append, checkpoint, or read structured state events for an autonomous agent run, enabling durable in-progress state tracking across agent execution sessions.","exampleAgentPrompt":"Append a new event of type 'tool_call_result' to agent run 'run-abc123' in the 'payments' namespace, keeping state for 300 seconds, and then checkpoint the current progress so I can resume if the run is interrupted.","exampleUseCases":[{"title":"Persist mid-task agent state","prompt":"My agent just finished a subtask in run 'run-xyz789' — append an event of type 'subtask_complete' with the result data to the ledger under namespace 'bounty-hunter', with a 120-second TTL, so it can pick up where it left off."},{"title":"Recover agent run history","prompt":"Read the last 50 events from agent run 'run-def456' in the 'api-router' namespace so I can reconstruct what my agent did before it crashed."},{"title":"Checkpoint long-running agent","prompt":"Create a checkpoint in the ledger for run 'run-gh789' in namespace 'spend-optimizer' so the agent's current state is saved and it can resume from this point if it times out."}],"resultDescription":"Returns a JSON object with ok: true, the operation name (append/checkpoint/read), mode set to 'agent_run_ledger', a data_hash of the stored payload, and a stream_id identifying the ledger stream for this run.","failureModes":["Missing or invalid run_id returns an error","op enum value not in [append, checkpoint, read] causes validation failure","ttl_seconds below 30 rejected","limit above 100 rejected","Run not found when reading returns empty or 404-equivalent","Payment not included or insufficient USDC triggers x402 payment-required response","Expired ledger entries may not be returned on read"],"whenToPreferThis":"Choose this endpoint when an autonomous agent needs durable, scoped, per-run state storage with append-log semantics — particularly within the Bounty Engineer x402 ecosystem where runs are already paying per-call via USDC micropayments. Prefer over generic KV stores when you need event-type tagging, TTL-based expiry, stream identity, and cryptographic data hashes per event.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:39:18.300Z","isFirstParty":false,"canonicalSlug":"bounty-engineer-agent-run-ledger-bbef39ff"}