{"uid":"cap_EgnGkjKu03_geGzWamljO","slug":"jpyc-transfer-events-by-chain-28f9f3e9","name":"JPYC Transfer Events by Chain","description":"List recent JPYC Transfer events on one supported chain from roughly the last hour of blocks, optionally filtered by address — tx hash, from, to, amount, block. Without a cursor: newest first. With a cursor: only events after that position, oldest first, so each observed event is returned once within the scanned window. Use to confirm a recent JPYC payment or monitor wallet activity. Not for history beyond the window, sanctions screening, identity, or finality proof.","url":"https://open-pay.jp/api/paid/usdc/jpyc/transfers","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":["chain"],"properties":{"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string","description":"Chain to scan. Supported values: polygon, kaia, avalanche, ethereum."},"limit":{"type":"string","default":"20","pattern":"^(?:[1-9]|[1-9][0-9]|100)$","description":"Maximum number of transfer events to return, newest first (1-100). This is not a page number."},"cursor":{"type":"string","pattern":"^[0-9]+:(?:-1|[0-9]+)$","description":"The nextCursor value from a previous response (\"<block>:<logIndex>\"). Returns only transfers newer than that position, oldest first (mode=delta), so repeated calls pay only for new events and return each observed event once within the scanned window, assuming stable chain history; continue with nextCursor while hasMore is true. A cursor up to 64 blocks beyond the current chain head (normal when a node lags) returns no items and echoes the cursor back; further ahead is rejected with 400 cursor_ahead_of_head."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Only transfers where this address is the sender or the recipient."}},"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","chain","chainId","contract","fromBlock","toBlock","mode","nextCursor","hasMore","truncated","items"],"properties":{"mode":{"enum":["snapshot","delta"],"type":"string","description":"snapshot = no cursor was supplied; items are newest first. delta = a cursor was supplied; items are the events after that position, oldest first."},"chain":{"enum":["polygon","kaia","avalanche","ethereum"],"type":"string"},"items":{"type":"array","items":{"type":"object","required":["blockNumber","txHash","logIndex","from","to","value","valueFormatted"],"properties":{"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"value":{"type":"string","pattern":"^[0-9]+$","description":"Atomic JPYC amount with 18 decimals."},"txHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"logIndex":{"type":"integer","minimum":0},"blockNumber":{"type":"string","pattern":"^[0-9]+$"},"valueFormatted":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"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."},"chainId":{"type":"integer","minimum":1},"hasMore":{"type":"boolean","description":"delta: more events exist after the returned ones — call again with nextCursor to continue. snapshot: older events in the window were omitted and are NOT retrievable via nextCursor (it starts after the newest returned event)."},"toBlock":{"type":"string","pattern":"^[0-9]+$"},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"termsUrl":{"type":"string","format":"uri"},"fromBlock":{"type":"string","pattern":"^[0-9]+$"},"truncated":{"type":"boolean","description":"true when the supplied cursor is older than the scanned block window; events between the cursor and fromBlock were not scanned."},"nextCursor":{"type":"string","pattern":"^[0-9]+:(?:-1|[0-9]+)$","description":"Pass as the cursor query parameter on the next call to receive only transfers newer than this response (\"<block>:<logIndex>\"). In snapshot mode this is where monitoring starts (after the newest returned event). Never moves backwards relative to the cursor you supplied."},"generatedAt":{"type":"string","format":"date-time"},"schemaVersion":{"type":"string","const":"2.2"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n_hjwGWLlxnCoYPsH9DRW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the most recent JPYC stablecoin transfer events on a specified blockchain (roughly the last hour of blocks), newest first, optionally filtered to a single address as sender or recipient.","exampleAgentPrompt":"Show me the most recent JPYC transfer events on Polygon for the address 0xAbC1234567890abcdef1234567890abcdef123456 — I want to see who sent or received JPYC to that wallet in the last hour.","exampleUseCases":[{"title":"Audit wallet JPYC payment activity","prompt":"Pull up the last 50 JPYC transfers on Polygon where 0xAbC1234567890abcdef1234567890abcdef123456 was either the sender or receiver — I need to review recent payment activity for that wallet."},{"title":"Monitor JPYC chain activity dashboard","prompt":"Fetch the latest JPYC transfer events on Avalanche — no address filter, just give me the 20 most recent transfers across the whole chain so I can see what's moving."},{"title":"Verify JPYC payment was received","prompt":"Check if address 0xDef9876543210fedcba9876543210fedcba987654 received any JPYC on Ethereum in the past hour — I'm waiting on a payment and want to confirm it went through."}],"resultDescription":"A list of JPYC transfer events from approximately the last hour of blocks on the specified chain, ordered newest first. Each record includes the transaction hash, sender (from) address, recipient (to) address, transfer amount, and block number. Optionally filtered to transfers involving a specific wallet address as either sender or recipient.","failureModes":["Missing required 'chain' query parameter returns an error","Invalid chain value (not polygon, kaia, avalanche, or ethereum) returns a validation error","Malformed address (not matching 0x + 40 hex chars) returns a pattern validation error","Limit value outside 1-100 range may be rejected or clamped","No transfers in the last hour on a quiet chain returns an empty list","Payment failure (insufficient USDC balance) blocks the request via x402 protocol"],"whenToPreferThis":"Use this endpoint when you need real-time, on-chain JPYC transfer event data for the past hour on a specific supported chain, especially when monitoring a specific address for incoming or outgoing JPYC payments. Prefer this over balance checks when you need transaction-level detail (tx hash, from/to, amount per transfer) rather than a summary balance. Best suited for payment verification, activity auditing, and live transfer monitoring workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:17.195Z","isFirstParty":false}