{"uid":"cap_nuBx1Ag_3qkEqBj4FRSiN","slug":"qsig-gold-macro-context-fbd296dd","name":"QSIG Gold Macro Context","description":"QSIG gold macro context, point-in-time: regime label, CFTC positioning with release time, FRED real yield and breakeven, GeoRisk and gold-linked theme stress, and the 5 nearest historical analogs. Optional as_of for backtests without look-ahead. Computed observation, not a forecast","url":"https://x402.qsig.net/v1/gold/context?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"as_of":{"type":"string","format":"date-time","description":"Optional ISO 8601 UTC timestamp. Returns the hourly snapshot at or before it, as knowable at that time (no look-ahead). History begins 2026-07-14; bounds are listed free at /v1/gold/context/fields."},"asset":{"enum":["gold"],"type":"string","description":"Asset. Only gold in v1."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JjuVQBVLXFnBSo6KwK7dr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a point-in-time gold macro context snapshot including regime label, CFTC positioning, FRED real yield and breakeven, GeoRisk stress, gold-linked theme stress, and the 5 nearest historical analogs — with optional as_of for look-ahead-free backtesting.","exampleAgentPrompt":"Pull me the current gold macro context — I want the regime label, CFTC positioning, real yield and breakeven from FRED, geopolitical risk stress, and the 5 nearest historical analogs right now.","exampleUseCases":[{"title":"Live gold regime check for trading","prompt":"What's the current gold macro regime, and how is CFTC positioning sitting alongside real yields and breakeven inflation? I want the full QSIG gold context snapshot as of right now."},{"title":"Historical analog lookup for backtest","prompt":"Pull the QSIG gold macro context as of 2026-09-15T14:00:00Z — I need the regime label, CFTC data, FRED real yield and breakeven, and the 5 nearest historical analogs as they were known at that time, no look-ahead."},{"title":"Geopolitical stress impact on gold","prompt":"What's the current GeoRisk and gold-linked theme stress in the QSIG gold context? I want to know if geopolitical risk is a dominant driver of the current gold regime."}],"resultDescription":"A structured point-in-time snapshot for gold including: a macro regime label, CFTC net positioning data with the scheduled release timestamp, FRED real yield and breakeven inflation figures, a GeoRisk score and gold-linked theme stress metric, and the 5 nearest historical analog periods ranked by similarity to current conditions. All values reflect what was knowable at the requested timestamp (no look-ahead) when as_of is supplied.","failureModes":["as_of timestamp predates history start (2026-07-14) — returns out-of-range error","Malformed or non-ISO-8601 as_of timestamp — returns validation error","Unsupported asset value (only 'gold' supported in v1) — returns enum error","Payment not completed or insufficient USDC balance — returns 402 Payment Required","Service downtime or upstream data delay — returns 5xx error"],"whenToPreferThis":"Choose this endpoint when you need a synthesized, multi-source macro context snapshot for gold that combines CFTC positioning, FRED macro indicators, geopolitical risk, and historical analog matching in a single call. It is especially valuable for backtesting workflows requiring point-in-time accuracy (no look-ahead) and for agents building gold trading signals, risk overlays, or research summaries. Prefer this over raw FRED or CFTC APIs when you need pre-aggregated regime classification and analog matching rather than individual data series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:50.675Z","isFirstParty":false,"canonicalSlug":"qsig-gold-macro-context-fbd296dd"}