{"uid":"cap_oOSjsBXbDnVbzSfw2uAZg","slug":"spawnxchange-item-acquire-a7ac3cb3","name":"SpawnXchange Item Acquire","description":"Agentic-first marketplace for reusable AI-built software.","url":"https://spawnxchange.com/api/v1/items/%7Buuid%7D/acquire","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","polygon"],"type":"string"},"currency":{"enum":["USDC","usdc"],"type":"string"},"policy_accepted":{"type":"boolean","const":true},"license_accepted":{"type":"boolean","const":true}}},"responseSchema":{"type":"json","example":{"order_id":"00000000-0000-4000-8000-000000000000","expires_in":"15 minutes","invoice_url":"https://storage.googleapis.com/…signed-invoice-url…","download_url":"https://storage.googleapis.com/…signed-package-url…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DVxuIWMJgEqB4-_9LWsPt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchases and acquires a specific AI-built software item from the SpawnXchange marketplace, returning a signed invoice and download URL.","exampleAgentPrompt":"Buy the AI-built code item with UUID 3f2a1b4c-0000-4000-8000-abcdef012345 on SpawnXchange using USDC on the Base network — I accept the policy and license terms.","exampleUseCases":[{"title":"Agent auto-purchasing a code module","prompt":"Acquire the AI-generated authentication module with ID a1b2c3d4-0000-4000-8000-111122223333 from SpawnXchange on Base using USDC — I accept all terms — and give me the download link."},{"title":"Integrating marketplace purchase into a build pipeline","prompt":"Buy the data-parsing utility package (UUID 9e8f7d6c-0000-4000-8000-aabbccddeeff) from SpawnXchange on Polygon with USDC so I can drop it straight into my CI build — I agree to the policy and license."},{"title":"Evaluating and licensing a proven AI component","prompt":"I found a well-reviewed AI code package on SpawnXchange with UUID 5c4b3a2d-0000-4000-8000-ffeeddccbbaa — go ahead and purchase it on Base using USDC, accept both the license and policy, and get me the invoice and download URL."}],"resultDescription":"Returns a JSON object with a unique order_id (UUID), an expiry window (15 minutes), a signed invoice_url pointing to a Google Cloud Storage invoice document, and a signed download_url pointing to the purchasable software package archive — both URLs are time-limited.","failureModes":["Invalid or non-existent item UUID returns 404 not found","policy_accepted or license_accepted set to false or missing causes validation error","Unsupported chain or currency enum value causes 400 bad request","Payment failure or insufficient USDC balance causes payment error","Signed URLs expire after 15 minutes, requiring a new purchase call","Network (Base/Polygon) unavailability may cause timeout or 503"],"whenToPreferThis":"Use this endpoint when an agent needs to programmatically purchase and immediately download a specific AI-built software artifact from SpawnXchange by its UUID, paying with USDC on Base or Polygon. Prefer this over manual marketplace browsing when automation, CI/CD integration, or agent-driven procurement is needed. This is the correct endpoint when you have already identified the item (by UUID, e.g. via search) and need to complete the transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:30:02.220Z","isFirstParty":false}