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 US484,291MWh
US GRID LOAD505,866MWh
GEN_NG US48225,196MWh
WTI71.87$/bbl
OP-13,328USD
OUTAGE US_CAPACITY97,621MW
NUCLEAR OUT3.14percent
HENRY HUB3.16$/MMBtu
BRENT76.49$/bbl
DIESEL4.83$/gal
GASOLINE4.05$/gal
NG STORAGE2,835Bcf
STOCKS CRUDE_EXSPR412,134Mbbl
SUPPLIED PRODUCTS20,272Mbbl/d
NG FUT-11.79$/MMBtu
BRENT_PRICE MONTHLY75$/bbl
WTI FCAST70$/bbl
RETAIL CUSTOMERS145,002,107count
RETAIL PRICE13.88cents/kWh
RETAIL REVENUE41,938M $
RETAIL SALES302,127M kWh
CONS TOTAL2,493,289MMcf
IMPORTS TOTAL238,826MMcf
NG OUTPUT3,789,520MMcf
IMPORTS CRUDE_SAU2,652Mbbl
PROD CRUDE_FIELD424,566Mbbl/d
PRIMARY_CONS MONTHLY7,887T Btu
PROD US0sts
SALES_PRICE US251.3$/st
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 US484,291MWh
US GRID LOAD505,866MWh
GEN_NG US48225,196MWh
WTI71.87$/bbl
OP-13,328USD
OUTAGE US_CAPACITY97,621MW
NUCLEAR OUT3.14percent
HENRY HUB3.16$/MMBtu
BRENT76.49$/bbl
DIESEL4.83$/gal
GASOLINE4.05$/gal
NG STORAGE2,835Bcf
STOCKS CRUDE_EXSPR412,134Mbbl
SUPPLIED PRODUCTS20,272Mbbl/d
NG FUT-11.79$/MMBtu
BRENT_PRICE MONTHLY75$/bbl
WTI FCAST70$/bbl
RETAIL CUSTOMERS145,002,107count
RETAIL PRICE13.88cents/kWh
RETAIL REVENUE41,938M $
RETAIL SALES302,127M kWh
CONS TOTAL2,493,289MMcf
IMPORTS TOTAL238,826MMcf
NG OUTPUT3,789,520MMcf
IMPORTS CRUDE_SAU2,652Mbbl
PROD CRUDE_FIELD424,566Mbbl/d
PRIMARY_CONS MONTHLY7,887T Btu
PROD US0sts
SALES_PRICE US251.3$/st
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
71.87$/bbl
WTI
2026-06-29daily
PETROLEUM
76.49$/bbl
BRENT
2026-06-22daily
NATURAL GAS
3.16$/MMBtu
HENRY HUB
2026-06-22daily
PETROLEUM
4.05$/gal
GASOLINE
2026-06-22weekly
PETROLEUM
4.83$/gal
DIESEL
2026-06-22weekly
NATURAL GAS
2,835Bcf
NG STORAGE
2026-06-19weekly
ELECTRICITY
505,866MWh
US GRID LOAD
2026-06-27 15: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 = 71.87 $/bbl> attest BRENT = 76.49 $/bbl> attest HENRY HUB = 3.16 $/MMBtu> attest GASOLINE = 4.05 $/gal> attest DIESEL = 4.83 $/gal> attest NG STORAGE = 2,835 Bcf> attest US GRID LOAD = 505,866 MWh> attest COAL = 24.98 $/st_
signal_scan.dither320x240
oracle.metrics
00Live Feeds
000Datasets Indexed
00On-Chain Attestations
TESTNETCasper Network
feeds.statusTICK:0000
FeedStatusValue
WTI
LIVE
71.87 $/bbl
BRENT
LIVE
76.49 $/bbl
HENRY HUB
LIVE
3.16 $/MMBtu
GASOLINE
LIVE
4.05 $/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
ATTESTATIONS78
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