{"uid":"cap_Fmekeivfdi6jwmJk-X4CZ","slug":"hacker-news-top-stories-feed-26e963cd","name":"Hacker News Top Stories Feed","description":"Current top Hacker News stories with score, comment count, author, and link — a real-time pulse of what the tech community is discussing. Filter ?min_significance=7 for the biggest stories only.","url":"https://oracles-production.up.railway.app/v1/hacker-news/changes","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":{"limit":{"type":"integer","maximum":500,"minimum":1},"since":{"type":"string","format":"date-time","description":"Only changes detected after this ISO-8601 instant"},"min_significance":{"type":"integer","maximum":10,"minimum":1,"description":"Keep only changes scored at least this"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"source":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"detail":{"type":"object"},"summary":{"type":"string"},"entityId":{"type":"string"},"sourceUrl":{"type":["string","null"],"description":"Primary-source link for verification"},"detectedAt":{"type":"string","format":"date-time"},"significance":{"type":"integer","maximum":10,"minimum":1},"effectiveDate":{"type":["string","null"]}}}}}}}}}},"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_G-EuGIeEU5cg3cePHKLI4","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 current top Hacker News stories with score, comment count, author, and link, optionally filtered by significance level","exampleAgentPrompt":"What are the biggest stories on Hacker News right now? Only show me the high-impact ones — significance 7 or above — and limit it to the top 20.","exampleUseCases":null,"resultDescription":"A JSON array of Hacker News story change objects, each containing a title, source URL, summary, author, significance score (1–10), detection timestamp, and entity ID. Also includes a total count and source label. Stories are ranked by significance and can be filtered to only the most newsworthy items.","failureModes":["No stories returned if min_significance threshold is set too high (e.g. 10) and no stories meet that bar","Empty result set if 'since' timestamp is very recent and no new stories have appeared","Rate limiting or payment failure (402) if USDC payment is not correctly attached","Invalid date-time format for 'since' parameter returns a 400 error","limit parameter out of range (below 1 or above 500) causes validation error"],"whenToPreferThis":"Use this endpoint when you need a real-time pulse of what the tech and developer community is actively discussing on Hacker News, especially when you want to filter for only the most significant stories by importance score. Prefer this over generic RSS or scraping when you need structured metadata (score, author, significance, detection time) and a clean API interface. Ideal for monitoring tech trends, surfacing breaking developer news, or building digest-style summaries of what matters in tech right now.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:00:57.388Z","isFirstParty":false}