{"uid":"cap_p2yxzP9JVAAiNs2DGJV52","slug":"qorevia-market-intelligence-xau-usd-market-state-99a25356","name":"Qorevia Market Intelligence – XAU/USD Market State","description":"Agent-payable market intelligence and finance tools.","url":"https://api.flowhomes.eu/api/xau/market-state?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"],"type":"string"},"queryParams":{"type":"object","properties":{"count":{"type":"integer","maximum":500,"minimum":30},"timeframe":{"enum":["M1","M5","M15","H1"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"atr":2.1,"trend":"up","symbol":"XAUUSD","returnPct":0.12,"rangePosition":0.71,"realizedVolPct":0.34}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gJGwVQ6hAx7s7ljMBEHoh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current market state indicators for XAU/USD (gold) including trend direction, ATR, realized volatility, range position, and return percentage over a configurable timeframe.","exampleAgentPrompt":"What's the current market state for gold — is it trending up or down on the 15-minute chart, and what's the ATR and realized volatility based on the last 100 candles?","exampleUseCases":[{"title":"Gold trend check before trade entry","prompt":"Before I place a gold trade, can you check if XAUUSD is currently in an uptrend on the 1-hour chart and tell me the ATR and where price sits within its recent range — use the last 200 candles."},{"title":"Volatility monitoring for risk management","prompt":"I need to know how volatile gold is right now — give me the realized volatility and ATR for XAUUSD on the 5-minute timeframe over the last 60 candles so I can size my position properly."},{"title":"Automated market condition alert","prompt":"Check the current XAUUSD market state on the M15 timeframe using 100 candles and let me know if the trend is up and realized volatility is above 0.3% — I only want to trade when those conditions align."}],"resultDescription":"A JSON object containing: trend direction (e.g. 'up' or 'down'), ATR value, realized volatility as a percentage, the symbol (XAUUSD), return percentage over the selected period, and range position (0–1 scalar indicating where price sits within its recent high-low range).","failureModes":["Invalid timeframe enum value returns an error (must be M1, M5, M15, or H1)","Count outside 30–500 range is rejected","Payment not included or insufficient USDC triggers a 402 response","Service unavailability returns a 5xx error","Stale or missing market data during low-liquidity periods may return incomplete fields"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pre-computed technical market state snapshot for gold (XAUUSD) — including trend, volatility, and range context — without needing to run your own OHLCV analysis pipeline. Ideal for agent workflows that gate trade decisions, alerts, or risk checks on current gold market conditions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:41:47.953Z","isFirstParty":false,"canonicalSlug":"qorevia-market-intelligence-xau-usd-market-state-99a25356"}