{"uid":"cap_h2jlm9rShUgtCbR5Aju_8","slug":"youraitools-credits-top-up-0ed4dc12","name":"YourAITools Credits Top-Up","description":"Top up an existing YourAITools credits key: one x402 payment of $1 USDC adds $1.00 of credits. Send the key as Authorization: Bearer <key>. Prepaid API usage only, not refundable.","url":"https://api.youraitools.co/credits/v1/topup/1?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{},"description":"Search intents: top up api credits, add api balance, prepaid api top up, usdc top up, x402 credits, agent api balance"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"pack":{"type":"string"},"topped_up":{"type":"boolean"},"balance_usd":{"type":"string"},"credited_usd":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"pack":"1","topped_up":true,"balance_usd":"1.25","credited_usd":"1.00"}},"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_zO6X7EP50uW7u1UrCTEN0","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":"Add $1 USD of credits to a YourAITools account balance for use across AI tools and APIs that accept crypto payments via x402","exampleAgentPrompt":"Top up my YourAITools account balance with $1 of credits using USDC so I can keep calling AI APIs through the x402 directory.","exampleUseCases":[{"title":"Refill agent API budget","prompt":"My AI agent is running low on credits for calling tools through YourAITools — can you add $1 of USDC to top up the balance so it can keep working?"},{"title":"Fund new YourAITools account","prompt":"I just signed up for YourAITools and need to load some credits before I can start using the AI APIs — go ahead and add $1 USDC to my account."},{"title":"Automate recurring credit top-up","prompt":"Whenever my YourAITools balance runs low, automatically top it up with $1 in credits so my agents never get blocked by an empty account."}],"resultDescription":"Returns a JSON object confirming the top-up, including the pack identifier ('1'), a boolean 'topped_up' flag (true on success), the new balance in USD (e.g. '1.25'), and the amount credited in USD (e.g. '1.00').","failureModes":["Payment not received or insufficient USDC — top-up not applied, topped_up returns false","Network or x402 protocol error — request fails to complete","Account not found or authentication failure — credits cannot be applied","Blockchain transaction not confirmed — balance may not update immediately"],"whenToPreferThis":"Use this endpoint when an AI agent or application needs to programmatically add $1 USD of credits to a YourAITools account balance, especially in automated pipelines where agents need to self-fund access to the x402-compatible AI tools directory. Prefer this over manual top-up when credit management is part of an autonomous agent workflow running on Base or Solana with USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T03:17:39.422Z","isFirstParty":false,"canonicalSlug":"youraitools-credits-top-up-0ed4dc12"}