{"uid":"cap_kPPmKCjg-uQI-d1TWMMAd","slug":"aeml-gauge-strata-statistical-stratum-projection-f881d204","name":"AEML Gauge Strata – Statistical Stratum Projection","description":"Add-on, statistical strata: share of the last 5 years spent in each official band for this day-of-year, the percentile bands, and where the current reading falls. Backtestable, and stated as approximate. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed.","url":"https://aeml-x402.zeabur.app/gauge/strata","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["signal_id","entity"],"properties":{"entity":{"type":"string","examples":["07010000"],"description":"required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]"},"signal_id":{"type":"string","examples":["hydrology.river-level"],"description":"required - signal id (genus.species); free list at GET /gauge/catalog (paged; ?all=1 for every line)"}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mTkVB-PumOaI7lHOeg2Vt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns 5-year same-season historical stratum distribution, quantile bands, and current-value stratum placement for a given signal and entity","exampleAgentPrompt":"For Bitcoin spot price (signal_id: crypto.spot, entity: btc), show me which historical seasonal stratum the current value falls into — I want the 5-year same-season stratum proportions and quantile bands so I can see if it's unusually high or low for this time of year.","exampleUseCases":[{"title":"Seasonal percentile context for unemployment","prompt":"Pull the strata breakdown for US unemployment (signal_id: macro.unemployment, entity: us) — I want to see how the current reading compares to the same quarter over the past 5 years and which official stratum layer it falls in right now."},{"title":"Crypto spot stratum check for Bitcoin","prompt":"Where does Bitcoin's current spot price land in its historical seasonal stratum distribution? Use signal_id crypto.spot and entity btc — I need the quantile bands and the layer the current value falls into."},{"title":"Shipping disruption historical stratum analysis","prompt":"Check the statistical stratum profile for Hormuz shipping route disruption (signal_id: shipping.route-disruption, entity: hormuz) — show me the 5-year same-season layer proportions and tell me which stratum the current value is in."}],"resultDescription":"A JSON object containing: the strata object with 5-year same-season historical layer proportions, quantile breakpoints, and the current value's stratum placement; entity and signal identifiers; observed_at timestamp; provenance block with freshness, data lineage, and age; an offline-verifiable citation with Ed25519 signature and DID; and a record_hash for integrity verification. Includes a grade disclosure and scope statement clarifying this is observational, not predictive or advisory.","failureModes":["422 Unprocessable Entity if the requested signal_id has no strata definition (not all signals have official stratum bands)","Missing or invalid signal_id / entity parameters return an error","Stale data: freshness field may be 'stale' for low-cadence official signals (monthly/quarterly/annual); data_age_hours may be frozen if collector is down","record_hash null if hashing is unavailable for a projected endpoint; recommend /gauge/verify for full core hash","Unknown entity or signal_id returns 404 or error; consult /gauge/catalog for valid combinations","Payment failure (x402): call requires $0.03 USDC on Base; unsigned or underpaid requests rejected"],"whenToPreferThis":"Use this endpoint when you need seasonal statistical context for a signal — specifically, where the current value sits within its historical stratum distribution for the same season over the past 5 years. Prefer this over /gauge (full core) when you only need strata projection at lower cost ($0.03 vs full gauge price), and over /gauge/ruler when you want quantile-based stratum placement rather than official threshold distances. Best for backtestable, seasonal benchmarking of macro, crypto, hydrology, agriculture, or shipping signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:23.922Z","isFirstParty":false}