{"uid":"cap_iP9jTXVZmlCoQJr6rjhfu","slug":"aeml-gauge-ruler-official-classification-thresholds-lookup-0e330585","name":"AEML Gauge Ruler — Official Classification Thresholds Lookup","description":"Add-on, the official ruler: the band and threshold ladder published by the source agency, its classification, and distance-to-action. NOT every line has an official ruler - pure market quotes do not. When it does not, you get 422 with no_charge:true and reason:no-ruler-for-this-line and you are NOT billed. Never a bag of nulls you paid for. Every record carries an offline-recomputable record_hash.","url":"https://aeml-x402.zeabur.app/gauge/ruler","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"},"example":{}}}}},"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_9Y_Od4kiw7uq-PMsHtPnP","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 official band/flood-stage classification thresholds and alert-level distances for a given signal and entity, or 422 with no_charge:true if no official ruler exists for that line.","exampleAgentPrompt":"What are the official flood stage classification thresholds and how close is the current level to the alert threshold for the Missouri River gauge — use signal_id crypto.spot and entity us or whichever matches the river gage signal for that station?","exampleUseCases":[{"title":"River flood stage threshold check","prompt":"What are the official flood stage and major flood thresholds for the Sacramento River gauge, and how far is the current streamflow from triggering the warning band?"},{"title":"Crypto signal official band lookup","prompt":"Does BTC have an official classification ruler defined? If so, what are the official bands and how far is the current price from the nearest threshold — use signal_id crypto.spot and entity btc."},{"title":"Macro indicator classification standard","prompt":"What is the official classification standard and alert threshold bands for US unemployment — use signal_id macro.unemployment and entity us — and tell me which band the current reading falls into?"}],"resultDescription":"Returns a ruler object with official band thresholds, flood-stage or alert-level classifications, distance to next threshold, and the standard used; includes provenance, data grade disclosure, record_hash for offline verification, and an Ed25519-signed citation. If no official ruler exists for the requested signal/entity combination, returns HTTP 422 with no_charge:true and a reason field explaining the absence — caller is not billed.","failureModes":["422 with no_charge:true and reason:no-ruler-for-this-line when no official classification ruler exists for that signal/entity — not billed","Missing or invalid signal_id or entity parameters result in error","Stale provenance if the underlying official source has not published a new release (data_age_hours reported honestly)","record_hash may be null if hashing failed; use /gauge/verify for corroboration"],"whenToPreferThis":"Use this endpoint when you need the official, standards-backed classification thresholds (bands, flood stages, alert levels) for a specific signal and entity rather than the raw observed value. Prefer this over /gauge (full core) when you only need the ruler projection and want to save cost ($0.01 vs higher). If no official ruler exists, this endpoint returns a clear 422 no-charge signal rather than billing you for null data — making it safe to probe availability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:19.780Z","isFirstParty":false}