{"uid":"cap_Uls6PSnznWYjaRDCWcq4u","slug":"prereason-ethereum-context-50af3e1e","name":"PreReason Ethereum Context","description":"Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.","url":"https://api.prereason.com/api/eth/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"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metrics":{"ethereum-price":{"name":"ethereum-price"},"eth-staking-apr":{"name":"eth-staking-apr"},"eth-200d-distance":{"name":"eth-200d-distance"},"ethereum-volume-24h":{"name":"ethereum-volume-24h"},"okx-eth-funding-rate":{"name":"okx-eth-funding-rate"},"cot-eth-cme-open-interest":{"name":"cot-eth-cme-open-interest"},"ethereum-volume-zscore-30d":{"name":"ethereum-volume-zscore-30d"},"cot-eth-cme-asset-manager-net":{"name":"cot-eth-cme-asset-manager-net"},"cot-eth-cme-leveraged-funds-net":{"name":"cot-eth-cme-leveraged-funds-net"}},"briefing_used":"eth.context","briefing_metadata":{"name":"Ethereum Context","description":"Where Ether stands in the market: its price and its global 24 hour trading volume, with that volume's 30 day z score (CoinGecko); its distance from the 200 day average (PreReason's calculation on CoinGecko's daily closes); Lido's stETH APR, its 7 day average; the net positions of leveraged funds and asset managers in CME Ether futures, with open interest (the CFTC's weekly Commitments of Traders); and the funding rate on OKX's ETH perpetual (one venue, named as OKX's).","metrics_count":9,"correlations_count":2}}},"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_xMrOMeEQegUToiFW36S5N","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 a multi-metric Ethereum market briefing including price, 24h volume with 30-day z-score, 200-day MA distance, Lido stETH APR, CFTC CME futures positioning, and OKX perpetual funding rate","exampleAgentPrompt":"Give me the full Ethereum market context right now — price, 24h volume z-score, distance from the 200-day average, Lido stETH APR, CFTC CME positioning for leveraged funds and asset managers, and the OKX perpetual funding rate, in markdown format.","exampleUseCases":[{"title":"Daily ETH market briefing for a trading dashboard","prompt":"Pull today's full Ethereum market context for me — price, volume with z-score, 200-day MA distance, stETH APR, and the latest CME futures positioning from the CFTC, in markdown so it's easy to read."},{"title":"Historical ETH context for backtesting a strategy","prompt":"Fetch the Ethereum market briefing for 2024-11-15 — I want the price, volume z-score, 200-day MA distance, Lido APR, CME COT positions, and OKX funding rate for that specific date in JSON format."},{"title":"Monitor ETH institutional sentiment via CFTC data","prompt":"What were asset managers and leveraged funds holding in CME Ethereum futures as of the latest data, and how does that compare to the current ETH funding rate on OKX? Give me the full ETH context briefing."}],"resultDescription":"A structured briefing with 9 Ethereum metrics: current price, 24-hour global trading volume, 30-day volume z-score, distance from the 200-day moving average, Lido stETH APR (7-day average), CME leveraged fund net position, CME asset manager net position, CME open interest (CFTC COT), and OKX ETH perpetual funding rate. Available in token-optimized markdown or structured JSON.","failureModes":["Date not on record — requested historical date has no data stored","Invalid date format — query param doesn't match YYYY-MM-DD pattern","Payment not received — x402 payment required before data is served","Upstream data delay — CFTC COT data is weekly and may lag by several days","Invalid format enum — value other than 'json' or 'markdown' rejected"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, pre-aggregated Ethereum market briefing that combines price, volume anomaly detection (z-score), trend context (200d MA), yield (stETH APR), institutional positioning (CFTC CME COT), and derivatives sentiment (OKX funding rate) in a single call. Prefer it over assembling individual data sources when you want LLM-ready markdown output or need all these signals in one structured payload for analysis or monitoring workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:42:22.035Z","isFirstParty":false,"canonicalSlug":"prereason-ethereum-context-50af3e1e"}