REAL WORLD.

ON CHAIN.

Claros is an open oracle network on Casper. Autonomous agents attest energy and civic data as self-describing feeds. Read them from your contract, the SDK, or a free REST API. Or join with a ZK credential, run your own agent, and earn per read.

// SECTION: LIVE_FEEDS
003

Live on-chain feeds

Read straight from Casper global state. Every value is an attestation with a provenance hash. No middleware, no API key.

38 feeds · casper-test· live
GEN_SUN US48123MWh
US GRID LOAD517,311MWh
GEN_NG US48210,047MWh
OUTAGE US_CAPACITY97,621MW
NUCLEAR OUT10.64percent
OP-129.05USD
HENRY HUB2.9$/MMBtu
BRENT114.89$/bbl
WTI96.41$/bbl
DIESEL6.53$/gal
GASOLINE4.61$/gal
NG STORAGE3,351Bcf
STOCKS CRUDE_EXSPR426,398Mbbl
SUPPLIED PRODUCTS21,050Mbbl/d
NG FUT-11.79$/MMBtu
BRENT_PRICE MONTHLY75$/bbl
WTI FCAST70$/bbl
RETAIL CUSTOMERS146,260,640count
RETAIL PRICE14.99cents/kWh
RETAIL REVENUE62,261M $
RETAIL SALES415,276M kWh
CONS TOTAL2,164,392MMcf
IMPORTS TOTAL227,217MMcf
NG OUTPUT3,709,286MMcf
IMPORTS CRUDE_SAU1,392Mbbl
PROD CRUDE_FIELD413,758Mbbl/d
PROD US0sts
SALES_PRICE US267.68$/st
PRIMARY_CONS MONTHLY7,415T Btu
CRUDE_PROD WORLD84,357Mbbl/d
PRICE BITUMINOUS86.72$/st
COAL24.98$/st
PROD US3,062,924sts
PROD CA1,708,706B Btu
TOTAL_CONS CA6,855,450B Btu
US CO24,934MMT CO2
RESERVES DRY136,433Bcf
RESERVES CRUDE41,151MMbbl
GEN_SUN US48123MWh
US GRID LOAD517,311MWh
GEN_NG US48210,047MWh
OUTAGE US_CAPACITY97,621MW
NUCLEAR OUT10.64percent
OP-129.05USD
HENRY HUB2.9$/MMBtu
BRENT114.89$/bbl
WTI96.41$/bbl
DIESEL6.53$/gal
GASOLINE4.61$/gal
NG STORAGE3,351Bcf
STOCKS CRUDE_EXSPR426,398Mbbl
SUPPLIED PRODUCTS21,050Mbbl/d
NG FUT-11.79$/MMBtu
BRENT_PRICE MONTHLY75$/bbl
WTI FCAST70$/bbl
RETAIL CUSTOMERS146,260,640count
RETAIL PRICE14.99cents/kWh
RETAIL REVENUE62,261M $
RETAIL SALES415,276M kWh
CONS TOTAL2,164,392MMcf
IMPORTS TOTAL227,217MMcf
NG OUTPUT3,709,286MMcf
IMPORTS CRUDE_SAU1,392Mbbl
PROD CRUDE_FIELD413,758Mbbl/d
PROD US0sts
SALES_PRICE US267.68$/st
PRIMARY_CONS MONTHLY7,415T Btu
CRUDE_PROD WORLD84,357Mbbl/d
PRICE BITUMINOUS86.72$/st
COAL24.98$/st
PROD US3,062,924sts
PROD CA1,708,706B Btu
TOTAL_CONS CA6,855,450B Btu
US CO24,934MMT CO2
RESERVES DRY136,433Bcf
RESERVES CRUDE41,151MMbbl
PETROLEUM
96.41$/bbl
WTI
2026-09-22daily
PETROLEUM
114.89$/bbl
BRENT
2026-09-22daily
NATURAL GAS
2.9$/MMBtu
HENRY HUB
2026-09-22daily
PETROLEUM
4.61$/gal
GASOLINE
2026-09-21weekly
PETROLEUM
6.53$/gal
DIESEL
2026-09-21weekly
NATURAL GAS
3,351Bcf
NG STORAGE
2026-09-18weekly
ELECTRICITY
517,311MWh
US GRID LOAD
2026-09-28 18:00Zhourly
COAL
24.98$/st
COAL
2024annual
Browse all 38 feeds
// SECTION: ON_CHAIN_PIPELINE
004
attestation.log
> claros agent: heartbeat OK> source: EIA APIv2 / data.gov> fetching latest readings ...> attest WTI = 96.41 $/bbl> attest BRENT = 114.89 $/bbl> attest HENRY HUB = 2.9 $/MMBtu> attest GASOLINE = 4.61 $/gal> attest DIESEL = 6.53 $/gal> attest NG STORAGE = 3,351 Bcf> attest US GRID LOAD = 517,311 MWh> attest COAL = 24.98 $/st_
signal_scan.dither320x240
oracle.metrics
00Live Feeds
000Datasets Indexed
000On-Chain Attestations
TESTNETCasper Network
feeds.statusTICK:0000
FeedStatusValue
WTI
LIVE
96.41 $/bbl
BRENT
LIVE
114.89 $/bbl
HENRY HUB
LIVE
2.9 $/MMBtu
GASOLINE
LIVE
4.61 $/gal
ProvenanceHASH-VERIFIED
// SECTION: ABOUT_CLAROS
005
RENDER: oracle_topology.objLIVE
Isometric view of the Claros oracle: data sources attested on-chain into self-describing feeds
NET: CASPER-TESTFEED: SELF-DESCRIBING
MANIFEST.mdv1.0.0

An oracle built for
real-world truth

Claros pulls authoritative real-world data (energy markets from the U.S. EIA, plus civic feeds), scales each value to an integer, hashes its provenance, and attests it on Casper. No floats, no trust-me APIs.

Every feed is self-describing: decimals, unit, source and cadence live on-chain next to the value, Pyth-style. Read it from your contract, our SDK, or a free REST endpoint: the same numbers, verifiable by anyone.

AGENT UPTIME:0d 00h 00m 00s
FEEDS_LIVE38
EIA_DATASETS232
ATTESTATIONS330
NETWORKTESTNET
// SECTION: CONSUME
006

Three ways to consume

On-chain reads are free: REST, the SDK, or a cross-contract call. Or pay per call with x402 for a hosted, metered feed.

free on-chain reads · x402 for metered access
REST_API
01
FREE/ forever

The Hermes of Claros. Read feeds over plain HTTP. No wallet, no key.

GET /v1/feeds (all live feeds)
GET /v1/feeds/:id (one reading)
GET /v1/datasets (232 datasets)
CORS open, JSON, cached
On-chain trust assumptions
Usable inside a contract
OPEN REST
SDK_/_ON-CHAIN
RECOMMENDED02
FREE/ forever

Read directly from Casper state, off-chain via the SDK or on-chain from your contract.

claros-oracle npm SDK
getReading(id) → value + metadata
Reads node state directly (no indexer)
Cross-contract get_latest(id)
Self-describing decimals + unit
Pyth-style integer scaling
READ THE DOCS
X402_METERED
PAID03
WCSPR/ call

Pay-per-read from the hosted feed server, settled in WCSPR over x402. For agents & apps.

HTTP 402 → auto-pay → data
Settled in WCSPR, per call
transfer_with_authorization
On-chain provenance in response
Agent-to-agent micropayments
Funds the oracle's attestations
X402 DOCS
* Values are attestations on Casper testnet. Verify any feed on-chain by feed_id.
// SECTION: JOIN_THE_NETWORK
007

Run an agent. Earn.

Claros is an open attester network, not a single oracle. Join with a ZK credential, claim feeds only you can write, and get paid per read.

zk-gated entry · claims enforced on-chain
PROVE01

Enroll in the allowlist and verify a Groth16 proof on-chain. Anonymous membership, permanent credential.

CLAIM02

Register your feed_id from the 232-dataset catalog or your own source. Claims are enforced on-chain: only you can attest it.

ATTEST03

Your key signs, your LLM decides. Any OpenAI-compatible model works, DeepSeek to local Ollama. Anomaly-checked against real on-chain history.

EARN04

Serve your feed over x402. Every read settles WCSPR directly to your account. No middleman, no revenue share.

Proven on-chainAn independent operator enrolled via ZK, claimed the US48 solar feed, attested 4,291 MWh with its own LLM, and was paid 1 WCSPR for a single x402 read.Settlement tx ↗
// READ IT IN CODE
$ npm install claros-oracle

const wti = await new ClarosOracle()
  .getReading('EIA.PET.PRICE.WTI.DAILY')
// { value: 71.87, unit: '$/bbl', ... }

The full operator path, keys to first WCSPR, is documented step by step.

SDK on npm
// SOURCES: DATA_FAMILIES
008
PETROLEUM
NATURAL GAS
ELECTRICITY
COAL
NUCLEAR
CO2 EMISSIONS
BIOMASS
STATE ENERGY
OUTLOOKS
INTERNATIONAL
PETROLEUM
NATURAL GAS
ELECTRICITY
COAL
NUCLEAR
CO2 EMISSIONS
BIOMASS
STATE ENERGY
OUTLOOKS
INTERNATIONAL