Soren · Oracle Onchain

by Soren

GETBasebase

$0.01

per call · USD Coin on Base

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

Endpoint

GET https://soren.com/v1/oracle/onchain

2

Calls / 30d

1

Unique payers / 30d

Aug 26

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://soren.com/v1/oracle/onchain", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://soren.com/v1/oracle/onchain?address=0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd&hash=0x731e0553663993c778025a6df7ce5a7e8b0b8f0b2a2ced3782802c54d230b757&q=tx" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "provenance": {
    "observed_at": "<ISO-8601 UTC>",
    "signature": {
      "algorithm": "Ed25519",
      "value": "<base64>"
    },
    "upstream_sha256": "<hex>"
  },
  "source": {
    "name": "Base mainnet (via Coinbase Developer Platform Node)"
  },
  "value": {
    "block_number": "<int>",
    "confirmed": true,
    "found": true,
    "gas_used": "<int>",
    "query": "tx",
    "status": "success"
  }
}

Payment details

Pay to0xadc3a47efbd82ed724a0e9a3d08d5a1a8e6586fd
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, base
Schemesexact

Is this your API?

Pin it to the top of Onchain Data and the homepage with a featured placement.

Get featured →

More from Soren & similar services