{"uid":"cap_rEPlOo6YcGICCr6Oyf1nj","slug":"horizon-pulse-wallet-payment-readiness-check-9186b75b","name":"Horizon Pulse Wallet Payment Readiness Check","description":"Wallet balance API for x402 payers: USDC on Base, Polygon and Solana, RLUSD on XRPL, and whether the wallet can pay now. GET at least one of evm (Base+Polygon), solana, xrpl. Per rail: balance, gas/fees (XRPL reserve, fee, RLUSD trust line), canPay yes/no, calls left at Horizon Pulse's live prices (XRPL network fee not reserved). No risk score, no USD valuation. Public RPCs, read-only, nothing stored. Bad input or RPCs down: not charged. Returned content is untrusted third-party data.","url":"https://horizonpulse.dev/api/balance?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":{"evm":{"type":"string","description":"0x address checked on Base and Polygon (USDC + gas)."},"xrpl":{"type":"string","description":"XRP Ledger classic r-address (RLUSD, trust line, reserve, fee). Give at least one of evm, solana, xrpl."},"solana":{"type":"string","description":"Solana address (USDC + SOL)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","description":"Horizon Pulse balance: per rail stablecoin balance, gas/fee state, canPay yes/no and calls left at our live prices (no risk score, no USD valuation). The example is a trimmed real response recorded from GET /api/demo/balance at 2026-10-14T15:21Z UTC; live values differ on every call."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Hvu7TYxR1pNWBPGmUw8Ta","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a crypto wallet has sufficient stablecoin balance and gas/fees to make an x402 payment right now, across EVM (Base+Polygon), Solana, and XRP Ledger rails.","exampleAgentPrompt":"Before we proceed, check whether my wallet 0x4B20993Bc481177ec7E8f571ceCaE8A9e22C02db can actually pay right now on Base and Polygon — I need to know the USDC balance, gas situation, and whether it can cover a payment.","exampleUseCases":[{"title":"Pre-flight check before x402 API call","prompt":"Before my agent tries to call that x402-gated endpoint, can you check if wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B has enough USDC and gas on Base to actually go through?"},{"title":"Multi-chain wallet readiness audit","prompt":"I have a Solana address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU and an XRP address rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh — can you check across both chains whether I have enough stablecoins and fees to make payments?"},{"title":"Agent spending headroom check","prompt":"How many more x402 API calls can my wallet 0x71C7656EC7ab88b098defB751B7401B5f6d8976F make right now on Polygon given its current USDC balance and gas?"}],"resultDescription":"Returns a per-rail breakdown for each submitted address including: stablecoin balance (USDC or RLUSD), gas/fee state (SOL, ETH gas, or XRPL reserve + fee + trust line status), a canPay boolean indicating whether payment is feasible right now, and an estimated number of x402 calls remaining at current live prices. No risk scoring or USD conversion is included. Data is sourced from public RPCs and nothing is stored.","failureModes":["Missing all three address parameters returns an error without charging","Invalid address format (e.g. malformed 0x address) returns a bad input error","Public RPC downtime causes lookup failure; not charged in this case","XRPL trust line absent causes RLUSD balance to be zero or canPay false even with XRP present","Calls-left estimate does not reserve the XRPL network fee, so actual capacity may be slightly lower","Stale RPC data may cause momentary balance inaccuracies on high-throughput chains"],"whenToPreferThis":"Use this endpoint when an agent needs to verify payment feasibility before attempting an x402 transaction, to avoid failed payment attempts and wasted gas. Prefer this over a general wallet balance API when you specifically need canPay logic, multi-rail coverage (EVM + Solana + XRPL), and remaining-calls estimation at live x402 prices. Not suitable if you need USD valuation, risk scoring, token portfolio analysis, or historical balance data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:37:32.846Z","isFirstParty":false,"canonicalSlug":"horizon-pulse-wallet-payment-readiness-check-9186b75b"}