{"uid":"cap_arL7ApkAd-a_GhocmkofR","slug":"soren-onchain-oracle-755da842","name":"Soren Onchain Oracle","description":"A signed, timestamped read from Base mainnet: whether a transaction landed and in which block, an address's ETH and USDC balance, or the current block height and gas price. Use the tx query when you paid over x402, received settlement_pending, and need it resolved — the transaction is in a block with status 1, or it is not. Read through a commercial node, not the public RPC. Verify with soren.com/oracle-key.json","url":"https://soren.com/v1/oracle/onchain","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","examples":["tx"],"description":"tx, balance or block."},"hash":{"type":"string","examples":["0x731e0553663993c778025a6df7ce5a7e8b0b8f0b2a2ced3782802c54d230b757"],"description":"With q=tx, the 32-byte transaction hash."},"address":{"type":"string","examples":["0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd"],"description":"With q=balance, the address to read."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FkRZEprGK4KS4jc9qLoRz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a signed, timestamped on-chain read from Base mainnet: transaction status, address ETH/USDC balances, or current block height and gas price.","exampleAgentPrompt":"Can you check whether transaction 0x731e0553663993c778025a6df7ce5a7e8b0b8f0b2a2ced3782802c54d230b757 landed on Base mainnet and tell me which block it's in and whether its status is 1?","exampleUseCases":[{"title":"Resolve pending x402 payment","prompt":"I paid via x402 and got back settlement_pending — can you confirm whether transaction 0x731e0553663993c778025a6df7ce5a7e8b0b8f0b2a2ced3782802c54d230b757 actually landed on Base and what block it's in?"},{"title":"Check wallet ETH and USDC balance","prompt":"What are the current ETH and USDC balances for wallet address 0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd on Base mainnet?"},{"title":"Monitor current Base chain conditions","prompt":"What's the current block height and gas price on Base mainnet right now?"}],"resultDescription":"A signed, timestamped JSON response verified with soren.com/oracle-key.json. For q=tx: transaction confirmation status (1=success/0=failed/not found) and block number. For q=balance: ETH and USDC balances for the queried address. For q=block: current block height and gas price on Base mainnet. All responses include a cryptographic signature and timestamp for auditability.","failureModes":["Invalid or malformed transaction hash returns an error or not-found result","Missing required 'hash' parameter when q=tx causes a bad request error","Missing required 'address' parameter when q=balance causes a bad request error","Transaction not yet mined returns a not-found or pending state rather than block confirmation","Node provider downtime may cause temporary unavailability","Payment failure ($0.01 USDC via x402) blocks the request"],"whenToPreferThis":"Choose this endpoint when you need a cryptographically signed, auditable on-chain read from Base mainnet — particularly to resolve x402 payment settlement disputes, verify transaction finality, or check wallet balances with a tamper-evident proof. Prefer this over public RPC calls when you need a commercial-grade node with a signed attestation you can present as evidence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:15.914Z","isFirstParty":false}