{"uid":"cap_nVY_IQhIkQr89sIySPsVt","slug":"linkrra-pearl-pool-usdc-top-up-via-x402-470d2151","name":"Linkrra Pearl Pool — USDC Top-Up via x402","description":"OpenAI-compatible inference paid per request in USDC on Base (eip155:8453, scheme exact). GET /v1/models for the model catalogue and per-model USD prices. Every paid route answers unauthenticated requests with an x402 v2 402 challenge (PAYMENT-REQUIRED header + JSON body). Minimum charge $0.01 per paid call on chat/completions and tts (usage-based price applies above it); credit top-ups are $1 minimum. Contact: weare@linkrra.com","url":"https://pool.linkrra.com/api/billing/x402/topup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string"},"method":{"type":"string"},"bodyType":{"type":"string"}}},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"balance":4399472,"credits":4399472}},"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_LRqTkE7QesKCcxBfhXk4s","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":"Tops up a Linkrra Pearl Pool account balance by initiating a USDC payment on Base via the x402 payment protocol, returning the updated credit balance.","exampleAgentPrompt":"I want to top up my Linkrra Pearl Pool account with $10 USDC on Base so I can keep running inference requests — go ahead and submit the payment via x402.","exampleUseCases":[{"title":"Reload credits before a long AI job","prompt":"I'm about to run a big batch of AI inference requests on Linkrra and my balance is low — top up my Pearl Pool account with $20 USDC on Base right now so I don't get cut off mid-run."},{"title":"Automate monthly inference budget refill","prompt":"Set up my Linkrra Pearl Pool account to be topped up with $50 USDC on Base at the start of each month so my inference credits never run out."},{"title":"Fund a new inference account","prompt":"I just signed up for Linkrra's Pearl Pool and need to add some starting credits — deposit $5 USDC on Base to my new account so I can start making API calls."}],"resultDescription":"Returns a JSON object with a boolean 'ok' field confirming success, plus 'balance' and 'credits' fields showing the updated account balance in micro-USDC units (e.g. {ok: true, balance: 4399472, credits: 4399472}).","failureModes":["Payment rejected if x402 challenge response is invalid or malformed","Insufficient USDC balance in the paying wallet causes transaction failure","Wrong network (not Base/eip155:8453) results in payment failure","Malformed request body missing required 'input' or 'output' fields returns 4xx error","x402 scheme mismatch if not using 'exact' scheme returns 402 challenge again","Network congestion on Base may delay on-chain confirmation"],"whenToPreferThis":"Choose this endpoint when you need to add USDC credits to a Linkrra Pearl Pool account to fund subsequent OpenAI-compatible inference API calls paid per-request via x402. This is the correct endpoint for account top-ups, not for making inference calls directly. Prefer this over generic crypto transfer APIs because it integrates directly with Linkrra's credit system and returns a verified updated balance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:11.378Z","isFirstParty":false,"canonicalSlug":"linkrra-pearl-pool-usdc-top-up-via-x402-470d2151"}