{"uid":"cap_Zr3r5Qr7EsDoXlT7mAAfF","slug":"api-vectorway-io-5d4991d9","name":"VectorWay Credits Purchase","description":"Top up the buyer's USDC balance via x402 payment. Funds chat completions on a Gemini-backed LLM runtime with optional RAG-style vector memory recall and write, plus semantic memory search and delete. Wallet is derived from the signed payment so credits always land on the payer's own account. Amount is in atomic USDC ($0.000001/unit, ticket $0.001 to $1000). Chat is billed per token.","url":"https://api.vectorway.io/v1/credits/purchase","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"credits":{"type":"integer","maximum":1000000000,"minimum":1000,"description":"Atomic USDC to add to the buyer's existing balance (1_000_000 = $1.00). Funds chat completions on a Gemini-backed LLM runtime with optional RAG-style vector memory recall and write. Chat is billed per real input/output token, embeddings + memory search are free; the balance is just deducted from the settled per-call USDC amount."}}},"responseSchema":{"type":"json","example":{"created":false,"credits":2000000,"agent_only":false,"wallet_address":"0xC0FFEE0000000000000000000000000000000001"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1000","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":"$1000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1000","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1000","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cEaWVTNtdRHeOEi1B_0Mk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1000","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Top up a USDC credit balance for VectorWay's pay-per-call Gemini LLM and vector memory service via x402 payment, crediting the payer's wallet-derived account.","exampleAgentPrompt":"Add $5 worth of USDC credits to my VectorWay account so I can use the Gemini chat completions and vector memory API — that's 5000000 atomic units.","exampleUseCases":[{"title":"Refill exhausted AI credit balance","prompt":"My VectorWay credit balance just ran out mid-task — can you top it up with $10 of USDC so I can keep running Gemini chat completions without interruption?"},{"title":"Onboard and fund new agent wallet","prompt":"I'm setting up a new AI agent that needs access to VectorWay's vector memory and chat API — go ahead and deposit $20 in USDC to get it funded and ready to go."},{"title":"Pre-fund RAG pipeline for project","prompt":"Before we kick off the research pipeline, add $15 worth of USDC credits to my VectorWay account so the agent has enough runway to handle all the vector memory lookups and LLM calls."}],"resultDescription":"Confirmation that the USDC payment was processed and the corresponding credit amount has been applied to the payer's wallet-derived VectorWay account, ready for use with chat completions and vector memory endpoints.","failureModes":["Invalid or missing x402 signed payment — payment not authorized","Amount below minimum ($0.001) or above maximum ($1000) — rejected","Malformed atomic unit amount — validation error","Payment signature does not match expected buyer wallet — credits not applied","x402 facilitator unavailable — payment processing failure"],"whenToPreferThis":"Use this endpoint when an agent or user needs to pre-fund a VectorWay account with USDC before making pay-per-call Gemini LLM or vector memory requests; ideal when the credit balance is exhausted or when onboarding without a subscription, leveraging the x402 payment protocol to tie credits directly to the payer's wallet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:52.417Z","isFirstParty":false}