{"uid":"cap_zPeFt23ykLwwalUjyMeAc","slug":"soren-us-economic-statistics-oracle-d0fed7f9","name":"Soren US Economic Statistics Oracle","description":"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","url":"https://soren.com/v1/oracle/stat?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"$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":["series"],"properties":{"series":{"type":"string","examples":["unemployment_rate"],"description":"One of: unemployment_rate, cpi, nonfarm_payroll, labor_force_participation, avg_hourly_earnings."}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"value":{"units":"percent","latest":{"year":"<YYYY>","value":"<number>","period_name":"<month>"},"recent":[{"year":"<YYYY>","value":"<number>","period_name":"<month>"}],"series":"unemployment_rate","series_id":"LNS14000000"},"source":{"name":"US Bureau of Labor Statistics","licence":"Public domain (US Government work, 17 U.S.C. 105)."},"provenance":{"signature":{"value":"<base64>","algorithm":"Ed25519"},"observed_at":"<ISO-8601 UTC>","upstream_sha256":"<hex>"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_022_K-AUIfovgPRNbFc1e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a signed, timestamped US economic statistic (unemployment rate, CPI, nonfarm payroll, labor force participation, or average hourly earnings) from BLS, with a SHA-256 hash of the raw BLS bytes and an Ed25519 signature for cryptographic verification.","exampleAgentPrompt":"Can you fetch the latest US unemployment rate from the BLS oracle and give me the signed, timestamped result along with its SHA-256 hash so I can verify it hasn't been revised later?","exampleUseCases":[{"title":"Locking in CPI for an inflation-indexed contract","prompt":"I need a cryptographically signed snapshot of the current US CPI figure from the BLS oracle — I'm writing it into a contract and need to prove what the number was today before BLS potentially revises it later."},{"title":"Auditing nonfarm payroll for a research report","prompt":"Fetch the latest nonfarm payroll figure from the BLS oracle with its Ed25519 signature and hash — I need to cite the exact value that was published and prove it hasn't changed since I pulled it."},{"title":"Monitoring labor participation for an automated dashboard","prompt":"Get me the current US labor force participation rate from the BLS oracle, with the timestamp and signature, so my dashboard can log a verifiable record of each reading over time."}],"resultDescription":"Returns the latest value of the requested BLS statistic plus approximately one year of historical readings, a SHA-256 hash of the exact bytes BLS returned, an Ed25519 signature over those bytes, and a timestamp. The signature can be verified using the public key at soren.com/oracle-key.json, allowing anyone to prove the figure was exactly this value at this moment, even if BLS later revises the series.","failureModes":["Invalid or unsupported BLS series/statistic type returns an error","BLS upstream unavailable causes a fetch failure","Payment not settled (x402) results in 402 Payment Required","Signature verification fails if public key is fetched from wrong URL","Stale data if BLS has not yet released the latest release for the period"],"whenToPreferThis":"Choose this endpoint when you need a cryptographically verifiable, tamper-evident snapshot of a US economic statistic — especially when downstream use cases require proving what a figure WAS at a moment in time (contracts, audits, legal records, smart contracts) and cannot rely on BLS's own website, which revises data in place. Prefer this over direct BLS API calls when attestation, non-repudiation, or historical freeze-point proof is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:43:31.428Z","isFirstParty":false,"canonicalSlug":"soren-us-economic-statistics-oracle-d0fed7f9"}