{"uid":"cap_f5vX5DB1z3NLde_IaLTlf","slug":"crypto-sentiment-history-by-ticker-45676a46","name":"Crypto Sentiment History by Ticker","description":"Hourly crypto news-sentiment readings for a ticker (e.g. BTC, ETH), recorded live at the top of every UTC hour and never backfilled. Each row: observed_at, average_compound (-1 to 1), sample_size, Fear & Greed value, matcher and the top 3 headlines behind it (title, link). Query start/end as ISO 8601; default last 7 days, max 30 days per call. See /archive for symbols and coverage.","url":"https://crypto-sentiment-x402.onrender.com/history/:symbol?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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Uppercase ticker symbol in the URL path, e.g. BTC in /history/BTC. See /archive for which symbols are logged."}}},"queryParams":{"type":"object","properties":{"end":{"type":"string","description":"ISO 8601 end time, exclusive. Default: now. At most 30 days after start."},"start":{"type":"string","description":"ISO 8601 start time (UTC if no offset). Default: end minus 7 days."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["symbol","start","end","count","rows"],"properties":{"end":{"type":"string"},"rows":{"type":"array","items":{"type":"object","required":["observed_at","average_compound","matcher","drivers"],"properties":{"window":{"type":["string","null"]},"drivers":{"anyOf":[{"type":"null"},{"type":"array","items":{"type":"object","required":["title","source","link","published","score"],"properties":{"link":{"type":["string","null"]},"score":{"type":"number"},"title":{"type":"string"},"effect":{"type":"number"},"source":{"type":"string"},"weight":{"type":"number"},"published":{"type":["string","null"]}}},"maxItems":5}]},"matcher":{"type":["string","null"]},"observed_at":{"type":"string"},"sample_size":{"type":["integer","null"]},"average_compound":{"type":["number","null"]},"fear_greed_value":{"type":["integer","null"]},"effective_sample_size":{"type":["number","null"]},"unweighted_compound_72h":{"type":["number","null"]},"newest_headline_age_hours":{"type":["number","null"]}}}},"count":{"type":"integer"},"start":{"type":"string"},"symbol":{"type":"string"},"recording":{"type":"string"},"methodology":{"type":"string"},"average_compound_note":{"type":"string"}}}}}}},"responseSchema":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_3vM-YGr-6MjuTs2lj7PXm","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 crypto news-sentiment readings for a given ticker symbol, including compound sentiment scores, Fear & Greed values, and top driving headlines, for a specified time window up to 30 days.","exampleAgentPrompt":"Pull me the hourly sentiment history for BTC from 2025-01-01T00:00:00Z to 2025-01-15T00:00:00Z, including the Fear & Greed readings and the top headlines driving each hour's score.","exampleUseCases":[{"title":"Crypto crash post-mortem analysis","prompt":"Show me the hour-by-hour sentiment readings for BTC from 2024-11-01 to 2024-11-07 — I want to see how the compound score and Fear & Greed values moved during that week, and which headlines were driving the swings."},{"title":"ETH trading signal research","prompt":"Get me the last 7 days of hourly sentiment data for ETH, including the average compound scores and sample sizes, so I can see if sentiment is trending bullish or bearish heading into this weekend."},{"title":"Multi-day SOL sentiment dashboard","prompt":"Fetch hourly sentiment history for SOL between 2025-03-01T00:00:00Z and 2025-03-30T23:00:00Z — I need the compound sentiment scores, Fear & Greed values, and the top driving headlines for each reading."}],"resultDescription":"A JSON object containing the requested symbol, start/end timestamps, total row count, and an array of hourly rows. Each row includes: observed_at (ISO 8601 timestamp), average_compound sentiment score (-1 to 1), sample_size, fear_greed_value (integer), matcher identifier, effective_sample_size, unweighted_compound_72h, newest_headline_age_hours, and a drivers array of up to 5 top headlines with title, source, link, published timestamp, score, weight, and effect fields.","failureModes":["Unsupported ticker symbol — symbol not in /archive coverage returns empty rows or error","Date range exceeding 30 days returns an error or truncated results","Invalid ISO 8601 datetime format for start/end causes a 400 error","No data available for a symbol during the requested window (service only records live, never backfills)","Payment failure or missing x402 payment header causes 402 Payment Required","Render.com cold start may cause first-request latency spike or timeout"],"whenToPreferThis":"Use this endpoint when you need a time-series of hourly sentiment readings for a specific crypto ticker over a historical window (up to 30 days). It is ideal for trend analysis, backtesting sentiment-based signals, or correlating news sentiment with price action. Prefer this over real-time-only endpoints when you need multiple hours or days of context rather than a single current reading. Note that data is never backfilled, so coverage starts from when the service began logging.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:34:17.481Z","isFirstParty":false,"canonicalSlug":"crypto-sentiment-history-by-ticker-45676a46"}