{"uid":"cap_sN9M34FhO13bpTAxyCppX","slug":"crypto-sentiment-history-api-b944abd1","name":"Crypto Sentiment History API","description":"Crypto news sentiment for 24 coins, scored from headlines at 9 crypto news outlets plus the Fear & Greed Index, with the headlines behind each score. Paid per call over x402 in USDC on Base: $0.01 for GET /sentiment/{symbol} and $0.05 for GET /history/{symbol}. Requests for an unsupported coin, a coin with too little recent news, or a history range with no readings are refused and not charged.","url":"https://crypto-sentiment-x402.onrender.com/history/%7Bsymbol%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"end":"2026-10-04T02:00:00Z","rows":[{"window":null,"drivers":null,"matcher":"whole_word","observed_at":"2026-10-04T00:00:02.513104+00:00","sample_size":52,"average_compound":0.1123,"fear_greed_value":41,"effective_sample_size":null,"unweighted_compound_72h":null,"newest_headline_age_hours":null},{"window":"72h-hl24","drivers":[{"link":"https://example.com/news/bitcoin-etf-inflows","score":0.6249,"title":"Bitcoin ETFs log fifth straight day of inflows","effect":0.0221,"source":"CoinDesk","weight":0.8963,"published":"2026-10-03T22:05:00Z"}],"matcher":"whole_word","observed_at":"2026-10-04T01:00:02.209871+00:00","sample_size":55,"average_compound":0.1388,"fear_greed_value":41,"effective_sample_size":31.7,"unweighted_compound_72h":0.1012,"newest_headline_age_hours":1.2}],"count":2,"start":"2026-10-04T00:00:00Z","symbol":"BTC","recording":"Readings are recorded live at the top of every UTC hour and never backfilled. An hour the logger missed stays missing.","methodology":"Rows before 2026-10-03 were scored with substring headline matching (matcher null); later rows with whole-word matching (matcher \"whole_word\"). Drivers (the top headlines behind a reading) are stored from 2026-10-03 on; older rows have drivers null. See /validation for the methodology notes.","average_compound_note":"average_compound depends on the row's window column. window \"72h-hl24\" (from 2026-10-04): the recency-weighted score over headlines from the last 72 hours (weight halves every 24 hours), the same number the live API returns; unweighted_compound_72h, effective_sample_size and newest_headline_age_hours are filled in. window null (earlier rows): the plain average over every item the feeds held, however old, and those four columns are null."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R5cJHrL-36w5dtHspxQrH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly historical crypto news sentiment readings for a given coin symbol, including recency-weighted sentiment scores, Fear & Greed Index values, and the top headlines driving each reading.","exampleAgentPrompt":"Pull up the hourly sentiment history for Bitcoin — I want to see the scored readings, the Fear and Greed values, and the headlines driving each score over the past couple of days.","exampleUseCases":[{"title":"Crypto trading signal research","prompt":"Show me the historical sentiment readings for ETH over the last 72 hours, including the top headlines and Fear and Greed index values at each hour — I'm trying to spot sentiment shifts before price moves."},{"title":"Altcoin news sentiment audit","prompt":"Get me the full hourly sentiment history for SOL, with the compound scores and the actual headlines behind each reading, so I can see what news has been moving sentiment this week."},{"title":"Market mood trend dashboard","prompt":"I need the historical sentiment data for BTC — give me all the hourly readings including the recency-weighted scores and effective sample sizes so I can chart how market mood has shifted."}],"resultDescription":"Returns a JSON object with a list of hourly sentiment rows for the requested coin symbol. Each row includes: the observation timestamp, the scoring window type, average compound sentiment score (recency-weighted or plain average depending on era), Fear & Greed Index value, sample size, effective sample size, unweighted 72-hour compound score, newest headline age in hours, and the top driving headlines with their individual scores, sources, weights, and publication timestamps. Also includes start/end range, total count, methodology notes, and recording caveats.","failureModes":["Unsupported coin symbol returns an error and is not charged","Coin with insufficient recent news returns an error and is not charged","History range with no recorded readings returns an error and is not charged","Payment failure or missing x402 USDC payment on Base results in a 402 response","Malformed symbol in path returns an error"],"whenToPreferThis":"Use this endpoint when you need time-series sentiment history for a specific cryptocurrency rather than a single real-time snapshot. It is ideal for trend analysis, backtesting sentiment signals, auditing past market mood, or populating dashboards. Prefer the cheaper /sentiment/{symbol} endpoint if you only need the current sentiment reading. This endpoint costs $0.05 USDC per call via x402 on Base, compared to $0.01 for the real-time endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:36:01.553Z","isFirstParty":false,"canonicalSlug":"crypto-sentiment-history-api-b944abd1"}