---
title: "Signed read from Base mainnet"
method: GET
path: "/v1/oracle/onchain"
---

# Signed read from Base mainnet

`GET /v1/oracle/onchain`

## Request

- Base URL: `https://soren.com`
- URL: `https://soren.com/v1/oracle/onchain`
- Auth: none declared

Whether a transaction landed and in which block, the ETH and USDC balance of an address, or current block height and gas price — each with a SHA-256 of the exact node response, the read time and an Ed25519 signature. The tx query resolves an x402 settlement_pending: found:false means not in a block (pending, dropped or never broadcast), which is not the same as failed.

## Query parameters

- `q` 'tx' | 'balance' | 'block', required
- `hash` string
- `address` string

## Response `200`

Signed read.

- object

## Other responses

- `400`: Unknown query or malformed hash/address. Refused before payment.
- `402`: Payment required.
- `503`: The node did not answer.

---

[API](https://skmtc.dev/soren/apis/soren-free-games-api.md) · [All operations](https://skmtc.dev/soren/apis/soren-free-games-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soren/apis/soren-free-games-api/revisions/00402cfcf30d?raw)