{"uid":"cap_0ROH-fuOLXNXLN16LqTpe","slug":"agent-exec-distributed-lock-claim-paid-12326854","name":"Agent-Exec Distributed Lock Claim (Paid)","description":"Accountless, pay-per-use code execution for software agents: submit source code, get stdout, stderr and exit code back from an isolated, network-less sandbox. No account, no API key -- possession of valid payment is sufficient.","url":"https://agent-exec.448c.org/claim?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["key","plan","holder"],"properties":{"key":{"type":"string","description":"1..256 UTF-8 bytes, no '/' character -- the name you want to hold, scoped to your own paying wallet."},"plan":{"enum":["hour","day","week"],"type":"string","description":"Which plan to buy -- see x-payment-info.pricing for each plan's hold duration and price."},"holder":{"type":"string","description":"1..256 UTF-8 bytes -- an id identifying which of your own processes is claiming it."}}},"responseSchema":{"type":"object","required":["outcome","plan","claim"],"properties":{"mine":{"type":"boolean","description":"Only present when `outcome` is \"held\": true when the existing holder is YOU -- a crash-resume or duplicated retry, the exact signal this product is sold to give."},"plan":{"enum":["hour","day","week","free"],"type":"string","description":"One of the paid plans (hour/day/week) from POST /claim, or \"free\" from POST /claim/free."},"claim":{"type":"object","required":["key","holder","acquiredAt","expiresAt"],"properties":{"key":{"type":"string"},"holder":{"type":"string"},"expiresAt":{"type":"integer","description":"Unix ms the hold is free again."},"acquiredAt":{"type":"integer","description":"Unix ms the hold was granted, from the server clock at the commit that granted it."}},"description":"The current hold on this key -- yours if `outcome` is \"acquired\", or the existing holder's if `outcome` is \"held\". Never carries a wallet: the caller already knows its own."},"outcome":{"enum":["acquired","held"],"type":"string","description":"\"acquired\": you won the key (201). \"held\": somebody already holds it (200) -- NOT an error, see `mine`."},"payment":{"type":"object","properties":{"asset":{"type":"string"},"payer":{"type":"string","description":"The paying wallet's address."},"amount":{"type":"string","description":"Atomic units of the settlement asset that were charged."},"network":{"type":"string"},"transaction":{"type":"string","description":"On-chain settlement transaction hash."}},"description":"Present on both outcomes of the PAID `POST /claim` -- the attempt is billed whether or not you won the key, so a \"held\" response still carries the receipt for the charge you incurred. Absent only from `POST /claim/free`, which never settles a payment."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0052","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.0052/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0052","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0052","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_L2H4sv5EtElKNqL--FwH9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0052","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Acquires a named distributed lock (key hold) for a specified duration using pay-per-use crypto payment, returning acquisition outcome and hold metadata.","exampleAgentPrompt":"Claim a distributed lock on key 'invoice-processor-run-42' for my holder 'worker-node-7' using the hour plan, so I can ensure only one agent processes this job at a time.","exampleUseCases":[{"title":"Crash-safe agent job deduplication","prompt":"Claim the key 'daily-report-gen' for holder 'scheduler-agent-1' on the hour plan — I need to know if this agent already holds it after a crash so I can safely resume without re-running the job."},{"title":"Distributed pipeline step coordination","prompt":"I have multiple agents that might try to run the ETL step at the same time — claim the lock 'etl-step-3' for holder 'etl-runner-A' on the day plan so only one proceeds."},{"title":"Weekly exclusive resource reservation","prompt":"Claim the key 'model-fine-tune-slot' for holder 'training-agent-prod' on the week plan — I need exclusive access to this resource for the next 7 days across all my workers."}],"resultDescription":"Returns an outcome field ('acquired' = lock granted to you, 'held' = already taken), the current claim object with key, holder, acquiredAt, and expiresAt timestamps, a payment receipt with payer address, transaction hash, asset, network, and amount, and optionally a 'mine' boolean indicating the existing holder is yourself (useful for crash-resume scenarios).","failureModes":["Key already held by another holder — returns 200 with outcome='held' and the competing holder's claim; payment is still charged","Invalid plan enum value — request rejected with 4xx error","Key or holder string exceeds 256 bytes or contains '/' — rejected with validation error","Payment failure or insufficient funds — 402 returned without lock acquisition","Network or server error — no lock acquired, payment state may be ambiguous"],"whenToPreferThis":"Choose this endpoint when you need accountless, serverless distributed locking with no prior registration — ideal for ephemeral AI agents, multi-instance pipelines, or crash-resume workflows where you want to pay only per acquisition attempt using USDC on-chain. Prefer it over traditional lock services when you cannot manage API keys or accounts, need crypto-native payment receipts for auditability, or require the 'mine' crash-resume signal to safely retry jobs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:36:52.691Z","isFirstParty":false,"canonicalSlug":"agent-exec-distributed-lock-claim-paid-12326854"}