{"uid":"cap_tKNaT7ktiKXMXZPYm4F9U","slug":"jpyc-live-total-supply-by-chain-28b8d02e","name":"JPYC Live Total Supply by Chain","description":"Read the current contract-reported JPYC totalSupply on Polygon, Kaia, Avalanche or Ethereum, with the token contract address and the block number observed at request time. Use for periodic supply monitoring, cross-chain comparison, or verifying a current JPYC supply figure before citing it. Not for market price, reserve backing, circulating-supply analysis, or financial advice.","url":"https://open-pay.jp/api/paid/usdc/jpyc/supply","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":{"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string","description":"Chain to query. Omit to query all supported chains. Supported values: polygon, kaia, avalanche, ethereum."}},"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","items"],"properties":{"items":{"type":"array","items":{"oneOf":[{"type":"object","required":["chain","chainId","contract","status","blockNumber","totalSupply","totalSupplyFormatted"],"properties":{"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string"},"status":{"type":"string","const":"ok"},"chainId":{"type":"integer","minimum":1},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"blockNumber":{"type":"string","pattern":"^[0-9]+$"},"totalSupply":{"type":"string","pattern":"^[0-9]+$","description":"Atomic JPYC amount with 18 decimals."},"totalSupplyFormatted":{"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."},"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_pw_cJU_72YMBY-HIUSzua","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 total supply of JPYC (Japan's yen-pegged stablecoin) for one or all supported chains (Polygon, Kaia, Avalanche, Ethereum), read directly from the token contracts at request time.","exampleAgentPrompt":"What is the current total supply of JPYC across all chains — Polygon, Kaia, Avalanche, and Ethereum? Give me the supply, block number, and contract address for each.","exampleUseCases":[{"title":"Cross-chain JPYC supply dashboard","prompt":"Pull the live JPYC total supply for all supported chains — Polygon, Kaia, Avalanche, and Ethereum — and show me the supply, block number, and contract address for each so I can build a dashboard."},{"title":"Polygon JPYC market cap estimate","prompt":"I need the current JPYC total supply on Polygon specifically, along with the contract address and the block it was read from, so I can estimate the market cap."},{"title":"Multi-chain JPYC issuance monitoring","prompt":"Check the JPYC total supply on Avalanche right now and tell me the block number it was read from — I want to track how issuance changes over time on that chain."}],"resultDescription":"A JSON response containing, for each queried chain, the JPYC total supply (as a numeric value), the block number at which the supply was read, and the token contract address on that chain. If the optional 'chain' parameter is omitted, results for all four chains (Polygon, Kaia, Avalanche, Ethereum) are returned.","failureModes":["Unsupported chain value returns a validation error","RPC node unavailability may cause timeout or incomplete data","Payment failure (x402) blocks access if USDC is not provided","Stale or slow block data if the underlying RPC is lagging"],"whenToPreferThis":"Use this endpoint when you need real-time, on-chain JPYC token supply data directly from the smart contracts, optionally filtered by a specific supported chain. Prefer this over cached or aggregated sources when freshness and block-level accuracy matter, such as for market cap calculations, tokenomics monitoring, or cross-chain supply reconciliation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:56.589Z","isFirstParty":false}