Crypto Fear-greed
Return the current Bitcoin-focused Crypto Fear & Greed reading and an optional bounded recent daily history from Alternative.me. Forest preserves the provider classification and prominent source attribution; it does not synthesize an asset-specific altcoin score, forecast price, create a trading signal, recommend a trade or access any account or wallet.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- get the current crypto fear and greed index
- check Bitcoin market sentiment today
- get the current fear greed score with recent history
- check whether Bitcoin sentiment is fear neutral or greed
- read a cheap crypto sentiment input before deeper research
What Forest guarantees
- fixed Alternative.me Fear & Greed API source only; callers cannot select another provider, URL, headers or format
- days defaults to 1 and is strictly bounded to 1..30; Forest never requests Alternative.me limit=0 unbounded history
- one bounded Alternative.me GET per cold requested-day window with a process-shared 600000 ms cache and same-key single-flight
- provider-wide process-local pacing of at least 10000 ms between cold refreshes with at most 8 queued refresh slots before fail-fast busy
- scores must be exact integers 0..100, timestamps valid Unix seconds and rows strictly newest-to-oldest with no duplicate or conflicting timestamps
- machine output always includes the Alternative.me source URL and explicit Data from Alternative.me attribution
Boundaries
- ETH, SOL or other asset-specific sentiment; the current index is represented as Bitcoin-focused
- trade direction, expected return, price forecast, portfolio action, investment advice or an executable trading signal
- intraday sentiment granularity, proprietary sentiment fusion or a Forest-invented composite score
- global cross-replica rate limiting; cache, single-flight and provider pacing are process-local
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
Canonical paid endpoint
Related capabilities
- Crypto Spot-price — Return one current Coinbase spot-product snapshot for an exact BASE-QUOTE product id, including venue price, 24-hour price change and provider-reported 24-hour product volume. Forest reads only Coinbase Advanced Trade public market data; it does not infer tickers, infer the provider volume denomination, aggregate venues, read an account or wallet, place orders, provide an executable quote, forecast returns or recommend a trade.
- Perp Funding — Return one current Hyperliquid native perpetual snapshot with hourly funding, 8-hour equivalent, simple nominal annualization of the current hourly rate, mark/oracle basis, Hyperliquid funding premium index, open interest, daily notional volume and max leverage. Forest reads only the fixed public Hyperliquid info endpoint; the annualized field is not compounded, forecast or realized return, and Forest does not trade, sign, read a wallet or recommend a position.
- Perp Funding-history — Return a bounded recent history of realized hourly funding-rate observations for one exact Hyperliquid native perpetual. Forest makes one fixed public fundingHistory request, returns at most 168 newest normalized observations, and reuses the existing shared Hyperliquid pacing boundary. This is historical market data only, not a prediction, arbitrage signal, trader funding ledger or trading recommendation.
- Sec Company-resolve — Resolve one exact U.S. public-company ticker to the SEC canonical CIK and EDGAR-conformed company name using the official SEC company_tickers.json mapping. Forest performs no fuzzy company-name search, filing download, market-data inference or mutation.
- Sec Recent-filings — Return newest-first metadata for recent official SEC EDGAR submissions for one exact ticker or CIK, optionally filtered to an exact form such as 10-K, 10-Q, 8-K or S-1. Forest returns bounded filing metadata and canonical SEC archive links only; it does not download filing bodies, crawl exhibits, parse XBRL or perform investment analysis.
- Treasury Yield-curve — Return the latest published U.S. Treasury Daily Treasury Par Yield Curve Rates snapshot across standard maturities from 1 month through 30 years. Forest normalizes one coherent official daily observation, reports missing Treasury tenors as null, and performs no forecast, interpolation, trading signal or secondary-market inference.