{"uid":"cap_Q_1YoeVZfiiSacC5IzsIB","slug":"hacker-news-top-stories-feed-0247481c","name":"Hacker News Top Stories Feed","description":"Current Hacker News front page via the official Firebase API, fanned out and merged into one payload: id, title, url, score, comment count and age in minutes per story. Query: ?n=20 (1-30 stories) &min_score=100 (optional score floor). Real-time tech signal for launch/incident/buzz detection. 5min cache.","url":"https://x402-datashop-production.up.railway.app/v1/dev/hn-top","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"},"queryParams":{"type":"object","properties":{"n":{"type":"integer","default":20,"maximum":30,"minimum":1,"description":"Number of stories"},"min_score":{"type":"integer","default":0,"minimum":0,"description":"Minimum upvote score"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QzH1Qhknj_wmVSZ3oGUj9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current Hacker News front page stories via Firebase API, returning id, title, URL, score, comment count, and age per story with optional count and score filtering.","exampleAgentPrompt":"Pull the top 15 Hacker News front page stories right now, only show me ones with a score of at least 200 points.","exampleUseCases":null,"resultDescription":"A merged JSON payload of up to 30 Hacker News front page stories, each containing story id, title, external URL, upvote score, comment count, and age in minutes — sourced from the official Firebase API with a 5-minute cache.","failureModes":["n out of range (must be 1-30) returns a validation error","min_score too high returns an empty story list","Upstream Firebase/HN API outage causes a fetch failure","Cache miss on cold start may add slight latency","Invalid query parameter types return a 400 error"],"whenToPreferThis":"Use this endpoint when you need real-time Hacker News front page data in a single merged payload, especially for launch detection, incident monitoring, or tech buzz tracking. Prefer this over scraping HN directly or calling the Firebase API yourself, as it fans out all top story requests and merges them for you with score filtering built in.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:19.618Z","isFirstParty":false}