{"uid":"cap_Rven6kESLW05bH6j9KVo7","slug":"suede-agent-studio-gateway-top-up-ba6d3c8c","name":"Suede Agent Studio Gateway Top-Up","description":"Build AI agents and publish explicit preview, payment-enabled, or unavailable state. Settled x402 calls route to your wallet.","url":"https://agents.suedeai.ai/api/gateway/topup","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object"},"dryRun":{"type":"boolean"}}},"responseSchema":{"type":"json","format":"application/json","example":{"payer":"0xabc","runId":"run_123","result":{"ok":true},"status":"done","outputs":{},"settled":true,"transaction":"0x123","totalCostUsdc":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qst1OmAl0hVaQMSYisAPR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a payment-gated AI agent run on Suede Agent Studio, routing settled x402 payments to the publisher's wallet.","exampleAgentPrompt":"Run my Suede Agent Studio agent with this input payload and settle the $1 USDC payment — let me know the run ID, transaction hash, and whether it completed successfully.","exampleUseCases":[{"title":"Test agent before live payment","prompt":"Run my Suede agent in dry-run mode with this input so I can see what the output would be before actually spending any USDC."},{"title":"Paid agent execution for automation pipeline","prompt":"Execute my Suede Agent Studio agent with the input data I'm passing and confirm that the $1 USDC was settled and routed to the creator's wallet — I need the run ID and final output."},{"title":"Verify agent result after on-chain payment","prompt":"I just submitted a job to my Suede agent — can you trigger it with this input, confirm the x402 payment settled on-chain, and return the transaction hash and result?"}],"resultDescription":"Returns a JSON object containing the payer wallet address, a unique run ID, the agent's output object, execution status (e.g. 'done'), whether payment was settled, the on-chain transaction hash, and the total cost in USDC.","failureModes":["Agent in unavailable state — returns error indicating the agent is not accepting calls","Payment not settled — x402 transaction fails or is rejected, run does not execute","Invalid input payload — malformed 'input' object causes execution failure","Agent in preview state — may return partial or mock results without full settlement","Network or wallet routing failure — transaction hash not returned, settlement uncertain"],"whenToPreferThis":"Choose this endpoint when you need to invoke a specific AI agent published on Suede Agent Studio that is payment-gated via the x402 protocol, and you want settled USDC payments routed directly to the agent creator's wallet. Prefer this over generic agent-hosting platforms when you specifically need x402-native payment settlement with on-chain transaction proof and a structured run result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:38.863Z","isFirstParty":false}