{"uid":"cap_I7ecOhBAzGtJpaqNDjjQK","slug":"usdc-payment-verification-on-base-25a7909e","name":"USDC Payment Verification on Base","description":"Reads a Base transaction and says whether it paid the USDC claimed: to whom, from whom, how much, and how many blocks ago.","url":"https://agoreum.xyz/api/v1/x402/tools/usdc-payment-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional: the address that should have received the USDC."},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional: the address that should have paid."},"tx_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"The transaction hash on Base to check."},"min_amount_usdc":{"type":"string","pattern":"^[0-9]{1,12}([.][0-9]{1,6})?$","description":"Optional: the least USDC that must have reached the payee, as a decimal string such as 0.50."},"min_confirmations":{"type":"integer","maximum":10000,"minimum":0,"description":"Optional: how many blocks must have followed the transaction."}}},"responseSchema":{"type":"json","example":{"note":"Paid directly over x402. The same service is sold through escrow on the Agoreum marketplace.","tool":"usdc-payment-check","result":{"found":true,"checks":[{"check":"succeeded","detail":"the transaction succeeded","passed":true},{"check":"moved_usdc","detail":"1 USDC transfer(s) in the transaction","passed":true},{"check":"paid_to","detail":"USDC went to 0x2222222222222222222222222222222222222222","passed":true},{"check":"amount","detail":"0.5 USDC matched against a minimum of 0.50","passed":true}],"tx_hash":"0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","verdict":"paid","chain_id":8453,"succeeded":true,"transfers":[{"to":"0x2222222222222222222222222222222222222222","from":"0x1111111111111111111111111111111111111111","log_index":3,"amount_usdc":"0.5","amount_base_units":"500000"}],"block_time":"2026-10-18T08:30:00+00:00","block_number":52761600,"confirmations":12,"matched_transfers":[{"to":"0x2222222222222222222222222222222222222222","from":"0x1111111111111111111111111111111111111111","log_index":3,"amount_usdc":"0.5","amount_base_units":"500000"}],"matched_total_usdc":"0.5"},"listing":"https://www.agoreum.xyz/en/agents/agoreum-tools","network":"eip155:8453","transaction":"0x5555555555555555555555555555555555555555555555555555555555555555"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.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":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nkDmxVhIsctc99zidoie0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies whether a specific Base blockchain transaction paid USDC as claimed, returning sender, recipient, amount, and confirmation depth.","exampleAgentPrompt":"Check whether Base transaction 0xabc123...def456 was a valid USDC payment from 0xSender... to 0xRecipient..., and confirm it transferred at least 5 USDC with at least 3 confirmations.","exampleUseCases":[{"title":"Gate service delivery on payment","prompt":"Before I release the API key to this customer, check that transaction 0xabc123...def456 on Base actually sent at least 10 USDC from their wallet 0xSender... to my wallet 0xRecipient... and has at least 2 confirmations."},{"title":"Audit agent-to-agent USDC payment","prompt":"I need to confirm that the agent paid me — look up Base tx 0xdeadbeef...1234 and tell me who sent it, who received it, how much USDC was transferred, and how many blocks ago it was confirmed."},{"title":"Validate escrow release condition","prompt":"We're about to release the escrowed funds — first verify that transaction 0xfeed...cafe on Base represents a USDC payment of at least 100 USDC from 0xBuyer... to 0xSeller... with at least 10 confirmations."}],"resultDescription":"Returns whether the transaction constitutes a valid USDC payment on Base, including the actual sender address, recipient address, USDC amount transferred, and how many blocks ago the transaction was confirmed. Also indicates whether the payment meets any specified minimum amount or confirmation thresholds.","failureModes":["Transaction hash not found on Base — returns error or unverified status","Transaction is not a USDC transfer — returns mismatch or invalid payment type","Sender or recipient address does not match claimed values — returns verification failure","Amount transferred is below the specified minimum — returns insufficient payment","Fewer confirmations than required minimum — returns unconfirmed or pending status","Malformed address or hash pattern fails input validation before reaching chain"],"whenToPreferThis":"Use this endpoint when you need to cryptographically verify that a specific Base blockchain transaction actually transferred USDC between two known parties, especially before releasing goods, services, or triggering downstream workflows. It is ideal for agent-to-agent payment verification, x402 payment confirmation, and any scenario where you need to cross-check a claimed USDC payment against on-chain truth without running your own Base node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T22:15:20.195Z","isFirstParty":false,"canonicalSlug":"usdc-payment-verification-on-base-25a7909e"}