{"uid":"cap_DjHX07Is972IOe0EB_6rU","slug":"prereason-fx-liquidity-context-api-db1a5eff","name":"PreReason FX Liquidity Context API","description":"PreReason delivers market context for financial agents. Bitcoin on-chain metrics, macro indicators, and reasoning context in one API call.","url":"https://api.prereason.com/api/fx","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","required":["briefing"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. Access range depends on tier: Free=30d, Basic=from Jan 2025, Pro=all."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured."},"briefing":{"enum":["btc.quick-check","btc.context","btc.pulse","btc.grid-stress","macro.snapshot","cross.correlations","btc.momentum","btc.on-chain","btc.miner-survival","btc.etf-flows","macro.liquidity","cross.breadth","btc.full","btc.factors","btc.energy","btc.treasury","cross.regime","fx.liquidity"],"type":"string","description":"Briefing ID. 18 available: btc.quick-check, btc.context, btc.pulse, btc.grid-stress, macro.snapshot, cross.correlations (Tier 1), btc.momentum, btc.on-chain, btc.miner-survival, btc.etf-flows, macro.liquidity, cross.breadth (Tier 2), btc.full, btc.factors, btc.energy, btc.treasury, cross.regime, fx.liquidity (Tier 3)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"context":"Bitcoin trading at $84,200, up 4.2% over 7 days...","metrics":{"bitcoin_price":{"signal":"bullish","trend_7d":4.2,"confidence":82}},"briefing":"btc.quick-check","generated_at":"2026-03-17T12:00:00Z"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"fx.liquidity"}}},"response":{"date":"2026-06-12","_timing":{"total_ms":691,"computedAt":"2026-06-12T04:46:26.276Z","metrics_ms":491,"correlations_ms":200,"tier_features_ms":0},"metrics":{"dxy":{"name":"dxy","trend":{"momentum":"steady","change_7d":0.43,"direction":"flat","change_30d":1.78,"change_90d":0.83,"percentile":50,"percentile_label":"average"},"signal":"below-trend","context":"Dollar strength (UUP) stable at 27.95. Consolidating: neutral dollar backdrop.","timestamp":"2026-06-11T19:45:14+00:00","confidence":56,"regulatory_mode":"descriptive","value_formatted":"27.95","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":100,"percentile_score":0,"trend_consistency":20}},"cny-usd":{"name":"cny-usd","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":-0.41,"change_90d":-1.89,"percentile":49,"percentile_label":"average"},"signal":"at-trend","context":"CNY/USD stable at 6.7655. Consolidating: Yuan conditions neutral.","timestamp":"2026-06-05T00:00:00+00:00","confidence":65,"regulatory_mode":"descriptive","value_formatted":"6.77","confidence_label":"Medium","confidence_factors":{"data_quality":30,"signal_strength":50,"percentile_score":60,"trend_consistency":100}},"eur-usd":{"name":"eur-usd","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":-1.75,"change_90d":0.4,"percentile":46,"percentile_label":"average"},"signal":"at-trend","context":"EUR/USD stable at 1.1533. Consolidating: FX conditions neutral.","timestamp":"2026-06-05T00:00:00+00:00","confidence":64,"regulatory_mode":"descriptive","value_formatted":"1.15","confidence_label":"Medium","confidence_factors":{"data_quality":30,"signal_strength":48,"percentile_score":60,"trend_consistency":100}},"bitcoin-price":{"name":"bitcoin-price","trend":{"momentum":"steady","change_7d":-0.2,"direction":"flat","change_30d":-20.92,"change_90d":-10.57,"percentile":69,"percentile_label":"above average"},"signal":"neutral","context":"BTC at $63,626, flat over 7d. Consolidating.","timestamp":"2026-06-12T04:42:29+00:00","confidence":49,"regulatory_mode":"signal","value_formatted":"$63,626","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":42,"percentile_score":22,"trend_consistency":60}},"net-liquidity":{"name":"net-liquidity","trend":{"momentum":"steady","change_7d":0.42,"direction":"flat","change_30d":1.14,"change_90d":1.53,"percentile":64,"percentile_label":"moderate growth"},"signal":"neutral","context":"Net liquidity stable at $5.90T. Consolidating.","timestamp":"2026-06-12T04:05:42.328+00:00","confidence":64,"regulatory_mode":"signal","value_formatted":"$5.90T","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":44,"percentile_score":32,"trend_consistency":100}}},"correlations":{"eur-usd_vs_dxy":{"pair":"eur-usd_vs_dxy","value":null,"metric1":"eur-usd","metric2":"dxy","interpretation":"Insufficient data (8 points, need 10+)","unavailable_reason":"eur-usd has only 8 data points in 30-day window"},"dxy_vs_net-liquidity":{"pair":"dxy_vs_net-liquidity","value":-0.05,"metric1":"dxy","metric2":"net-liquidity","interpretation":"No meaningful correlation (-0.05)"},"cny-usd_vs_net-liquidity":{"pair":"cny-usd_vs_net-liquidity","value":0.23,"metric1":"cny-usd","metric2":"net-liquidity","interpretation":"Weak positive correlation (+0.23)"},"eur-usd_vs_bitcoin-price":{"pair":"eur-usd_vs_bitcoin-price","value":null,"metric1":"eur-usd","metric2":"bitcoin-price","interpretation":"Insufficient data (8 points, need 10+)","unavailable_reason":"eur-usd has only 8 data points in 30-day window"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":5,"metrics_available":5,"correlations_total":4,"unavailable_metrics":[],"correlations_computable":4,"unavailable_correlations":[]},"generated_at":"2026-06-12T04:46:26.276Z","_tier_context":{"your_tier":"free","related_briefings":[{"id":"fx.liquidity","tier":"pro","description":"Adds dollar and currency environment"},{"id":"fx.usd","tier":"basic","description":"Adds usd-as-currency briefing. uup dxy proxy + dtwexbgs broad trade-weighted dollar + real-rate-10y (10y nominal minus 10y breakeven) as the foundational driver, plus fed funds and 10y nominal as macro overlay. distinct from the macro briefings by being usd-currency-anchored with real-rate as the primary mechanism."},{"id":"fx.eur","tier":"basic","description":"Adds eur-native briefing: invesco currencyshares euro trust (fxe) plus eur/usd spot, ecb deposit facility rate (short end), germany 10y bund yield (long end), and eurozone m3 money supply (monetary aggregate). counterpart-bank policy depth provided via fed-ecb-spread for the dollar leg."},{"id":"fx.jpy","tier":"basic","description":"Adds jpy-native briefing: invesco currencyshares japanese yen trust (fxy) plus jpy/usd spot, boj short-term policy rate (short end), japan 10y jgb yield (long end, often anchored by yield curve control regime), and boj total assets (largest central-bank balance sheet relative to gdp). carry-trade context via fed-boj-spread, carry-trade-returns-proxy, and 1d carry velocity."},{"id":"fx.policy-divergence","tier":"pro","description":"Adds causal reasoning"},{"id":"fx.momentum","tier":"pro","description":"Adds causal reasoning"}],"higher_tier_features":["Causal reasoning (Pro)","Regime classification (Pro)","Divergence detection (Pro)","Extended historical data from Jan 2025 (Basic+)","Full historical data access (Pro)"]},"briefing_used":"fx.liquidity","briefing_metadata":{"name":"FX Liquidity","tier":"pro","data_access":"Today + last 30 days","description":"Dollar and currency environment - EUR/USD, CNY/USD direction with net liquidity correlation","metrics_count":5,"correlations_count":4,"earliest_usable_date":"1999-01-04","correlations_window_days":30}}},"exampleRequest":{"format":"json","briefing":"fx.liquidity"},"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_in-uLij8X3hjBYUsHqvrP","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 EUR/USD, CNY/USD, and DXY proxy rates with trend signals and FX liquidity context for macro analysis.","exampleAgentPrompt":"Pull the fx.liquidity briefing from PreReason in markdown format — I need EUR/USD, CNY/USD, and the DXY proxy with their trend signals for today.","exampleUseCases":null,"resultDescription":"Returns a structured context object with EUR/USD, CNY/USD, and DXY proxy values alongside bullish/bearish trend signals, 7-day trend percentages, and confidence scores, plus a generated_at timestamp. Supports both JSON (structured) and markdown (token-optimized for LLMs) formats.","failureModes":["Missing required 'briefing' query param returns 400 error","Invalid briefing ID (not 'fx.liquidity') returns 400 or empty result","Date outside tier access range returns 402 or 403","Unpaid or insufficient USDC payment returns 402 Payment Required","Invalid date format (not YYYY-MM-DD) returns 400 validation error","Network timeout or upstream data unavailability returns 503"],"whenToPreferThis":"Use this endpoint when you need a concise FX liquidity snapshot — specifically EUR/USD, CNY/USD, and DXY proxy with trend signals — as macro context for Bitcoin or broader financial analysis. Prefer over generic FX feeds when you want pre-computed trend signals and confidence scores rather than raw tick data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:05.651Z","isFirstParty":false}