{"uid":"cap_g7sUF953bPSt0ZN_uJ469","slug":"jpyc-multi-chain-balance-lookup-ab1cc226","name":"JPYC Multi-Chain Balance Lookup","description":"Read the current on-chain JPYC balance of any EVM address on one or all supported chains (Polygon, Kaia, Avalanche, Ethereum), with the token contract and the block number observed at request time. Use before or after a payment, for treasury checks, wallet monitoring, and payment reconciliation. The result does not prove wallet ownership and is not a transaction-finality certificate.","url":"https://open-pay.jp/api/paid/usdc/jpyc/balance","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","required":["address"],"properties":{"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string","description":"Chain to query. Omit to query all supported chains. Supported values: polygon, kaia, avalanche, ethereum."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EVM address to read the JPYC balance of."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["schemaVersion","token","generatedAt","notice","termsUrl","address","items"],"properties":{"items":{"type":"array","items":{"oneOf":[{"type":"object","required":["chain","chainId","contract","status","blockNumber","balance","balanceFormatted"],"properties":{"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string"},"status":{"type":"string","const":"ok"},"balance":{"type":"string","pattern":"^[0-9]+$","description":"Atomic JPYC amount with 18 decimals."},"chainId":{"type":"integer","minimum":1},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"blockNumber":{"type":"string","pattern":"^[0-9]+$"},"balanceFormatted":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"additionalProperties":false},{"type":"object","required":["chain","chainId","contract","status","errorCode","retryable"],"properties":{"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string"},"status":{"type":"string","const":"unavailable"},"chainId":{"type":"integer","minimum":1},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"errorCode":{"enum":["rpc_unavailable","contract_read_failed"],"type":"string"},"retryable":{"type":"boolean"}},"additionalProperties":false}]}},"token":{"type":"object","required":["symbol","decimals"],"properties":{"symbol":{"type":"string","const":"JPYC"},"decimals":{"type":"integer","const":18}},"additionalProperties":false},"notice":{"type":"string","const":"onchain-facts-only","description":"On-chain facts read from public RPC endpoints at request time. Informational only — not financial advice, not an offer, quote or solicitation. Full terms at termsUrl."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"termsUrl":{"type":"string","format":"uri"},"generatedAt":{"type":"string","format":"date-time"},"schemaVersion":{"type":"string","const":"2.2"}},"additionalProperties":false}}}}},"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_A_4xsx8lfXy2ZTExn4tTR","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":"Returns the live JPYC stablecoin balance of any Ethereum-compatible address across Polygon, Kaia, Avalanche, and Ethereum in a single call","exampleAgentPrompt":"What's the current JPYC balance for wallet address 0xAbC1234567890abcdef1234567890abcdef123456 across all chains — Polygon, Kaia, Avalanche, and Ethereum?","exampleUseCases":[{"title":"Portfolio tracker checking JPYC holdings","prompt":"Can you check how much JPYC the wallet 0xAbC1234567890abcdef1234567890abcdef123456 holds right now on Polygon? I want the live on-chain balance, not a cached number."},{"title":"Multi-chain JPYC audit for a DeFi app","prompt":"I need to see the total JPYC balance for address 0xAbC1234567890abcdef1234567890abcdef123456 spread across all supported chains — Polygon, Kaia, Avalanche, and Ethereum — can you pull that all in one go?"},{"title":"Verifying JPYC receipt before releasing goods","prompt":"Has the payment arrived yet? Check the JPYC balance on Avalanche for wallet 0xAbC1234567890abcdef1234567890abcdef123456 and tell me the current block number so I know it's live data."}],"resultDescription":"Returns per-chain JPYC token balances (as on-chain balanceOf reads) for the queried address, including the block number at which each balance was read, covering up to four chains (Polygon, Kaia, Avalanche, Ethereum) with no indexer lag.","failureModes":["Invalid address format (not a 0x-prefixed 40-hex-character address) returns a validation error","Unsupported chain enum value returns an error listing valid options","RPC node timeouts on a specific chain may cause partial or failed responses","Rate limiting if request volume exceeds plan thresholds","Network congestion on a chain can slow real-time block reads slightly"],"whenToPreferThis":"Choose this endpoint when you need live, block-number-anchored JPYC balances with no indexer lag across one or all of Polygon, Kaia, Avalanche, and Ethereum in a single API call. It is ideal for payment verification, compliance checks, or portfolio queries where real-time accuracy and multi-chain coverage matter more than historical data or transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:23.051Z","isFirstParty":false}