{"uid":"cap_TCJvMXjmpTS-Xbi2NqgbG","slug":"agentdrives-credit-top-up-b2536ced","name":"AgentDrives Credit Top-Up","description":"Prepaid credit for AgentDrives tool searches: $5 buys 500, $20 buys 2,000 and $50 buys 5,000. Without a key it returns a new API key that holds the credit. Each search with that key (POST /api/paid/find-tools) takes $0.01 from the balance, with no payment per call.","url":"https://agentdrives.com/api/credits/topup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"agent":{"type":"string","description":"Your name as an agent, kept on the new account"},"buyer":{"type":"object","description":"For an invoice: vat_id, country, company, address"},"force":{"type":"boolean","description":"Top up although the balance isn't low"},"amount_usd":{"enum":[5,20,50],"description":"US dollars"}}},"responseSchema":{"type":"json","example":{"key":{"header":"x-api-key","shown_once":true},"topup":{"calls":500,"amount_cents":500},"credit":{"balance_cents":500},"api_key":"<shown once>","payment":{"rail":"x402","currency":"usd","receipt_url":"https://agentdrives.com/api/credits/<id>/receipt","amount_cents":500}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"6.05","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":"$6.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"6.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"6.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KsnhlUTnul6mi8QecWpus","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"6.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase API credits for AgentDrives by topping up your account balance with a one-time USDC payment, receiving an API key in return.","exampleAgentPrompt":"Top up my AgentDrives account with $20 of credits — my agent is called 'ResearchBot' — so I have enough calls for the next batch of tasks.","exampleUseCases":[{"title":"Bootstrap a new agent account","prompt":"Create a new AgentDrives account for my agent 'InvoiceHelper' and load it with $20 of credits so it can start calling tools right away."},{"title":"Refill low balance before a big run","prompt":"My AgentDrives balance is getting low — force a top-up of $50 for my agent 'DataCrawler' so it doesn't run out mid-task."},{"title":"Get API key with billing invoice","prompt":"Top up $20 of AgentDrives credits for my agent 'SupportBot' and make sure the invoice is under Acme Inc., VAT ID DE123456789, Germany."}],"resultDescription":"Returns a one-time-shown API key (to be stored immediately), the number of calls added, the resulting credit balance in cents, and a payment receipt URL. The key must be passed as the x-api-key header on subsequent AgentDrives API calls.","failureModes":["Payment declined or USDC transfer fails — no credits or key issued","Invalid amount_usd value (must be 5, 20, or 50) — returns validation error","Balance is not low and force flag is not set — top-up rejected with balance-not-low error","Malformed buyer invoice fields — validation error on vat_id or country","API key shown only once — if not stored immediately it cannot be retrieved again"],"whenToPreferThis":"Use this endpoint when an AI agent needs to self-provision or refund its AgentDrives account using an x402 micropayment. Prefer this over manual dashboard top-ups when running in fully automated, agent-driven workflows where a human is not available to log in. It is the only way to obtain a valid AgentDrives API key programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T09:29:52.905Z","isFirstParty":false,"canonicalSlug":"agentdrives-credit-top-up-b2536ced"}