{"uid":"cap_mYvZ6SV81nwC8jYPHUuCZ","slug":"padelmaps-org-0c73e3ab","name":"Hacker News Top Stories Feed","description":"Get top Hacker News stories","url":"https://padelmaps.org/api/x402-tools/hackernews/top","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"limit":{"type":"integer","description":"Number of top stories to return (default 10, max 30)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"cached":{"type":"boolean"},"stories":{"type":"array"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{"limit":5},"type":"http","method":"POST","bodyType":"json"}},"response":{"type":"top","count":5,"cached":false,"stories":[{"by":"lwhsiao","id":48546294,"url":"https://roman.pt/posts/linkedin-backdoor/","time":1781553657,"score":647,"title":"A backdoor in a LinkedIn job offer","hn_url":"https://news.ycombinator.com/item?id=48546294","comments_count":131},{"by":"sohkamyung","id":48547985,"url":"https://www.richardosgood.com/posts/banned-book-library/","time":1781563075,"score":130,"title":"Banned Book Library in a Wi-Fi Smart Light Bulb","hn_url":"https://news.ycombinator.com/item?id=48547985","comments_count":27},{"by":"chadfowler","id":48542480,"url":"https://www.iroh.computer/blog/v1","time":1781536386,"score":918,"title":"Iroh 1.0","hn_url":"https://news.ycombinator.com/item?id=48542480","comments_count":281},{"by":"speckx","id":48546441,"url":"https://michaelenger.com/blog/i-love-the-computer/","time":1781554455,"score":129,"title":"I Love the Computer","hn_url":"https://news.ycombinator.com/item?id=48546441","comments_count":83},{"by":"tinywind","id":48543475,"url":"https://tinywind.io","time":1781540153,"score":583,"title":"TinyWind: A pixel pirate sailing game with real wind physics (380k+ kms sailed)","hn_url":"https://news.ycombinator.com/item?id=48543475","comments_count":121}]}},"exampleRequest":{"limit":5},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yo2zvc4ckVLEi6ooI1uPM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current top stories from Hacker News including title, score, author, URL, and timestamp metadata","exampleAgentPrompt":"What are the top stories on Hacker News right now — give me the titles, scores, authors, and links.","exampleUseCases":null,"resultDescription":"Returns a list of Hacker News top stories, each with title, score, author username, source URL, and publication timestamp — ready for display or further processing.","failureModes":["Hacker News API unavailable — upstream service outage returns an error response","Rate limit or payment failure — insufficient USDC balance returns a payment-required error","Empty result set if Hacker News feed is temporarily inaccessible"],"whenToPreferThis":"Use this endpoint when you need structured, ready-to-consume Hacker News top story data including metadata like score, author, and timestamp, without having to scrape or call the Hacker News API directly. Ideal for agents building news digests, trend monitoring, or tech community pulse checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:37:51.199Z","isFirstParty":false}