{"uid":"cap_w9QNU6Kn1JTgHt_fwDK7i","slug":"aeml-gauge-calibrated-unit-plug-in-3efb8ba5","name":"AEML Gauge Calibrated Unit Plug-in","description":"Add-on, calibrated units: normalized_index and pct_to_action so readings compare across stations. When the line has no calibration basis you get 422 with no_charge:true and reason:no-calibrated-for-this-line, and are NOT billed. Every record carries an offline-recomputable record_hash.","url":"https://aeml-x402.zeabur.app/gauge/calibrated","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_ZxEDloQ8H-KkG6hFP1uDx","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 cross-site-comparable calibrated unit projections (normalized_index / pct_to_action) for a given signal and entity, or 422 with no-charge flag if no calibration exists for that signal line.","exampleAgentPrompt":"Can you pull the calibrated normalized index for the crypto.spot signal on BTC from the AEML gauge — I want the cross-site-comparable pct_to_action reading along with data freshness info?","exampleUseCases":[{"title":"Normalized crypto signal comparison","prompt":"Get me the calibrated gauge reading for the crypto.spot signal on BTC — I need the normalized_index and pct_to_action so I can compare it cross-site with other signal sources."},{"title":"Macro unemployment signal calibration check","prompt":"What's the calibrated unit projection for the macro.unemployment signal for the US entity? I want to see the normalized_index and whether it's near the action threshold."},{"title":"Shipping route disruption gauge reading","prompt":"Pull the calibrated normalized index for the shipping.route-disruption signal on the Hormuz entity — include the provenance freshness status and grade so I know how decision-ready the data is."}],"resultDescription":"Returns a JSON object with a 'calibrated' sub-object containing normalized_index and pct_to_action (cross-site comparable values), plus metadata fields: signal_id, entity, entity_name, observed_at, grade (data quality tier), scope statement, nature (neutrality disclaimer), provenance (freshness, data lineage, data age), record_hash, and optional _citation for offline verification. If no calibration exists for the requested signal line, returns HTTP 422 with no_charge:true and reason:no-calibrated-for-this-line — meaning the call is not billed.","failureModes":["422 with no_charge:true and reason:no-calibrated-for-this-line — signal line has no calibrated unit defined; call is not billed","Missing or invalid signal_id parameter — malformed dot-notation label","Missing or invalid entity parameter — entity not recognized in catalog","Payment failure via x402 protocol — USDC payment not accepted","Stale data indicated by freshness:stale in provenance — data may not reflect current conditions","null calibrated field — calibration data temporarily unavailable despite line existing"],"whenToPreferThis":"Choose this endpoint when you need cross-site-comparable normalized signal readings (normalized_index / pct_to_action) for a specific signal-entity pair, especially when you want to benchmark or compare gauge readings across different sources or time periods on a standardized scale. Prefer this over the full /gauge endpoint when you only need the calibrated projection and want to minimize cost ($0.02 vs fuller bundles). If the line has no calibration, you are not charged. Use /gauge/catalog or /gauge/preview (free) first to confirm the signal_id and entity are valid before calling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:47.313Z","isFirstParty":false}