Soren · Oracle Stat

by Soren

GETBasebase

$0.01

per call · USD Coin on Base

A signed, timestamped US economic statistic from the Bureau of Labor Statistics — unemployment rate, CPI, nonfarm payroll, participation or average hourly earnings. Returns the latest figure with about a year of history, a SHA-256 of the exact bytes BLS returned, and an Ed25519 signature. Use it to prove what a figure WAS at a moment, because BLS revises its series. Verify with soren.com/oracle-key.json

Endpoint

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

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/stat", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://soren.com/v1/oracle/stat?series=unemployment_rate" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "provenance": {
    "observed_at": "<ISO-8601 UTC>",
    "signature": {
      "algorithm": "Ed25519",
      "value": "<base64>"
    },
    "upstream_sha256": "<hex>"
  },
  "source": {
    "licence": "Public domain (US Government work, 17 U.S.C. 105).",
    "name": "US Bureau of Labor Statistics"
  },
  "value": {
    "latest": {
      "period_name": "<month>",
      "value": "<number>",
      "year": "<YYYY>"
    },
    "recent": [
      {
        "period_name": "<month>",
        "value": "<number>",
        "year": "<YYYY>"
      }
    ],
    "series": "unemployment_rate",
    "series_id": "LNS14000000",
    "units": "percent"
  }
}

Payment details

Pay to0xadc3a47efbd82ed724a0e9a3d08d5a1a8e6586fd
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, base
Schemesexact

Is this your API?

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

Get featured →

More from Soren & similar services