{"uid":"cap_e5f1v6dlCqhrrNMxg3wla","slug":"venice-ai-x402-credit-top-up-f70357b9","name":"Venice AI x402 Credit Top-Up","description":"Add USDC credits via x402 payment.","url":"https://api.venice.ai/api/v1/x402/top-up?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{},"description":"No body fields are required. Payment is supplied via the PAYMENT-SIGNATURE header; send an empty object to discover payment requirements.","additionalProperties":false},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object","required":["walletAddress","amountCredited","newBalance","paymentId"],"properties":{"paymentId":{"type":"string","example":"payment_01HZY8M4W4Y6QZ8B6Q4P0V3J2K","description":"Unique identifier for the x402 payment."},"newBalance":{"type":"number","example":22.5,"description":"Updated wallet balance in USD after the top-up."},"walletAddress":{"type":"string","example":"0xyour_wallet_address","description":"Wallet that received the credited balance."},"amountCredited":{"type":"number","example":10,"description":"Amount credited to the wallet in USD."}},"additionalProperties":false},"success":{"enum":[true],"type":"boolean"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JTVnCCgkCO479icS-vNYw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Tops up a Venice AI credit balance using an x402 micropayment (USDC on Base or Solana), returning the credited amount and new balance.","exampleAgentPrompt":"Top up my Venice AI credit balance using USDC so I can run inference — send the x402 payment now and tell me my new balance once it goes through.","exampleUseCases":null,"resultDescription":"Returns a success object with the payment ID, wallet address that was credited, the amount credited in USD, and the updated total balance in USD after the top-up.","failureModes":["Missing PAYMENT-SIGNATURE header returns 402 with Base and Solana USDC payment requirements","Invalid or malformed payment signature returns 400/402 error","Insufficient USDC in paying wallet causes payment rejection","Network mismatch (wrong chain) causes payment failure","Duplicate payment replay may be rejected"],"whenToPreferThis":"Use this endpoint when an agent needs to fund a Venice AI account before calling inference endpoints (chat, image, audio, video). It is the canonical x402 payment entry point for Venice AI and accepts both Base and Solana USDC. Prefer this over any other top-up mechanism when operating in an x402-aware payment flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:36:24.305Z","isFirstParty":false,"canonicalSlug":"venice-ai-x402-credit-top-up-f70357b9"}