# Soren Onchain Oracle

> Soren Onchain Oracle is a paid API for AI agents from soren.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns a signed, timestamped on-chain read from Base mainnet: transaction status, address ETH/USDC balances, or current block height and gas price.

## Facts

- Endpoint: GET https://soren.com/v1/oracle/onchain
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/soren-onchain-oracle-755da842
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_arL7ApkAd-a_GhocmkofR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability soren-onchain-oracle-755da842
```

Example prompt: Can you check whether transaction 0x731e0553663993c778025a6df7ce5a7e8b0b8f0b2a2ced3782802c54d230b757 landed on Base mainnet and tell me which block it's in and whether its status is 1?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "$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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soren-onchain-oracle-755da842/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from soren.com](https://www.zero.xyz/host/soren.com/llms.txt)